ko.react.dev

한국어 번역 정보

가이드

번역 혹은 기여를 진행할 때, 아래 가이드를 따라주세요.

1. 기여 가이드라인^Contributing 및 기여자 행동 강령 규약^{Code of Conduct}을 따르고 있습니다.
2. 공통 스타일 가이드^{Universal Style Guide}를 확인해주세요.
3. 번역을 위한 모범 사례^{Best Practices for Translation}를 따라주세요.
4. 공통된 단어 번역을 위해 번역 용어 정리^{Translate Glossary}를 참고해주세요.
5. 끌어오기 요청^{Pull Request}시 테스트를 통과하지 못할 경우, textlint 가이드^{Textlint Guide}를 참고해주세요.
6. 마지막으로 맞춤법 검사^{Spelling Check}를 진행해주세요.

이 저장소^Repository는 ko.react.dev의 소스 코드와 개발 문서를 포함하고 있습니다.

시작하기

사전 준비

1. Git
2. Node: v16.8.0 이상의 모든 버전
3. Yarn v1([email protected]): Yarn 설치 안내 참고
4. 포크^Fork한 개인 저장소
5. 로컬에 클론^Clone한 ko.react.dev 저장소

설치

1. cd ko.react.dev를 실행하여 프로젝트 경로로 이동합니다.
2. yarn 명령어를 실행하여 npm 의존성 모듈들을 설치합니다.

개발 서버 실행하기

1. yarn dev 명령어를 사용하여 개발 서버를 시작합니다. (powered by Next.js.)
2. open http://localhost:3000 명령어를 사용하여 선호하는 브라우저로 접속하세요.

기여 방법

가이드라인

이 문서는 목적이 다른 여러 섹션으로 나뉩니다. 문장을 추가할 계획이라면, 적절한 섹션에 대한 기여 가이드라인^Contributing을 숙지하는 것이 도움이 될 것입니다.

분기^Branch 만들기

1. ko.react.dev 로컬 저장소에서 git checkout main을 실행합니다.
2. git pull origin main을 실행하여 최신 코드를 가져올 수 있습니다.
3. git checkout -b the-name-of-my-branch를 실행하여 분기^Branch를 만듭니다. (이때, the-name-of-my-branch를 적절한 이름으로 교체.)

수정하기

1. "개발 서버 실행하기" 부분을 따릅니다.
2. 파일을 저장하고 브라우저에서 확인합니다.
3. src 안에 있는 React 컴포넌트가 수정될 경우 hot-reload가 적용됩니다.
4. content 안에 있는 마크다운 파일이 수정될 경우 hot-reload가 적용됩니다.
5. 플러그인을 사용하는 경우, .cache 디렉토리를 제거한 후 서버를 재시작해야 합니다.

수정사항 검사하기

1. 가능하다면, 변경한 부분에 대해서 많이 사용하는 브라우저의 최신 버전에서 시각적으로 제대로 적용되었는지 확인해주세요. (데스크탑과 모바일 모두.)
2. 프로젝트 루트에서 yarn check-all을 실행합니다. (이 명령어는 Prettier, ESLint, 그리고 타입 유효성 검사를 진행합니다.)

푸시^Push 하기

1. git add -A && git commit -m "My message"를 실행하여 변경한 파일들을 커밋^commit 해주세요. (이때, My message 부분을 Fix header logo on Android 같은 커밋 메시지로 교체.)
2. git push my-fork-name the-name-of-my-branch
3. ko.react.dev 저장소에서 최근에 푸시된 분기^Branch를 볼 수 있습니다.
4. 깃허브^GitHub 지침을 따라주세요.
5. 가능하다면 시각적으로 변화된 부분의 스크린샷을 첨부해주세요. 변경 사항이 깃허브^GitHub에 푸시^Push되면 미리보기 빌드가 트리거됩니다.

문제 해결하기

yarn cache-reset 명령어를 사용하여 로컬 캐시를 초기화합니다.

번역

react.dev 번역에 흥미가 있다면, translations.react.dev에서 현재 번역이 얼마나 진행되었는지 확인해주세요.

번역하려는 언어가 아직 진행되지 않았다면, 해당 언어에 대해 새롭게 만들 수 있습니다. translations.react.dev 저장소를 참고해주세요.

저작권

위 내용에 대한 저작권은 react.dev가 가지고 있으며, LICENSE-DOCS.md에서 볼 수 있는 CC-BY-4.0 라이센스를 따릅니다.