번역 혹은 기여를 진행할 때, 아래 가이드를 따라주세요.
- 기여 가이드라인Contributing 및 기여자 행동 강령 규약Code of Conduct을 따르고 있습니다.
- 공통 스타일 가이드Universal Style Guide를 확인해주세요.
- 번역을 위한 모범 사례Best Practices for Translation를 따라주세요.
- 공통된 단어 번역을 위해 번역 용어 정리Translate Glossary를 참고해주세요.
- 끌어오기 요청Pull Request시 테스트를 통과하지 못할 경우,
textlint가이드Textlint Guide를 참고해주세요. - 마지막으로 맞춤법 검사Spelling Check를 진행해주세요.
이 저장소Repository는 ko.react.dev의 소스 코드와 개발 문서를 포함하고 있습니다.
- Git
- Node: v16.8.0 이상의 모든 버전
- Yarn v1(
[email protected]): Yarn 설치 안내 참고 - 포크Fork한 개인 저장소
- 로컬에 클론Clone한 ko.react.dev 저장소
cd ko.react.dev를 실행하여 프로젝트 경로로 이동합니다.yarn명령어를 실행하여 npm 의존성 모듈들을 설치합니다.
yarn dev명령어를 사용하여 개발 서버를 시작합니다. (powered by Next.js.)open http://localhost:3000명령어를 사용하여 선호하는 브라우저로 접속하세요.
이 문서는 목적이 다른 여러 섹션으로 나뉩니다. 문장을 추가할 계획이라면, 적절한 섹션에 대한 기여 가이드라인Contributing을 숙지하는 것이 도움이 될 것입니다.
ko.react.dev로컬 저장소에서git checkout main을 실행합니다.git pull origin main을 실행하여 최신 코드를 가져올 수 있습니다.git checkout -b the-name-of-my-branch를 실행하여 분기Branch를 만듭니다. (이때,the-name-of-my-branch를 적절한 이름으로 교체.)
- "개발 서버 실행하기" 부분을 따릅니다.
- 파일을 저장하고 브라우저에서 확인합니다.
src안에 있는 React 컴포넌트가 수정될 경우 hot-reload가 적용됩니다.content안에 있는 마크다운 파일이 수정될 경우 hot-reload가 적용됩니다.- 플러그인을 사용하는 경우,
.cache디렉토리를 제거한 후 서버를 재시작해야 합니다.
- 가능하다면, 변경한 부분에 대해서 많이 사용하는 브라우저의 최신 버전에서 시각적으로 제대로 적용되었는지 확인해주세요. (데스크탑과 모바일 모두.)
- 프로젝트 루트에서
yarn check-all을 실행합니다. (이 명령어는 Prettier, ESLint, 그리고 타입 유효성 검사를 진행합니다.)
git add -A && git commit -m "My message"를 실행하여 변경한 파일들을 커밋commit 해주세요. (이때,My message부분을Fix header logo on Android같은 커밋 메시지로 교체.)git push my-fork-name the-name-of-my-branch- ko.react.dev 저장소에서 최근에 푸시된 분기Branch를 볼 수 있습니다.
- 깃허브GitHub 지침을 따라주세요.
- 가능하다면 시각적으로 변화된 부분의 스크린샷을 첨부해주세요. 변경 사항이 깃허브GitHub에 푸시Push되면 미리보기 빌드가 트리거됩니다.
yarn cache-reset 명령어를 사용하여 로컬 캐시를 초기화합니다.
react.dev 번역에 흥미가 있다면, translations.react.dev에서 현재 번역이 얼마나 진행되었는지 확인해주세요.
번역하려는 언어가 아직 진행되지 않았다면, 해당 언어에 대해 새롭게 만들 수 있습니다. translations.react.dev 저장소를 참고해주세요.
위 내용에 대한 저작권은 react.dev가 가지고 있으며, LICENSE-DOCS.md에서 볼 수 있는 CC-BY-4.0 라이센스를 따릅니다.