|
12 | 12 | ## 참여하기 |
13 | 13 | 본 저장소에 기여하고 싶다면 [CONTRIBUTING.md](https://github.com/javascript-tutorial/ko.javascript.info/blob/master/CONTRIBUTING.md)를 참고해 주세요. |
14 | 14 |
|
| 15 | +### 번역 스킬 사용(권장) |
| 16 | + |
| 17 | +앞으로 번역은 **[tech-translation-ko 스킬](https://github.com/Violet-Bora-Lee/tech-translation-ko)** 을 사용해 진행합니다. 이 저장소의 번역 관행(번역 커밋 전수 분석에서 추출한 문장 패턴, 용어집, 서식 규칙, 검수 체크리스트)을 스킬 하나로 옮겨 두었습니다. Claude Code 같은 AI 코딩 에이전트에 스킬을 설치하면 번역 → 구조·용어 린트(`check_translation.py`) → 셀프 리뷰 → 맞춤법 검사 순서의 워크플로우가 적용됩니다. 사람이 직접 번역할 때도 스킬 저장소의 `references/` 문서를 가이드로 활용할 수 있습니다. |
| 18 | + |
| 19 | +### 프로젝트 정책 |
| 20 | + |
| 21 | +스킬 사용 여부와 관계없이 지켜야 하는 PR 수용 기준입니다. |
| 22 | + |
15 | 23 | * 경어체를 사용합니다. |
16 | | -* PR 전 [맞춤법 검사기](http://speller.cs.pusan.ac.kr/)를 사용해 틀린 부분을 교정합니다. **검사기를 돌리지 않았다고 판단되는 커밋은 PR 받지 않겠습니다.** 리뷰자 역시 맞춤법 검사기를 사용해, 번역자가 맞춤법을 지켜 번역했는지 확인합니다. |
17 | | -* 줄 바꿈과 단락은 "원문 그대로"를 유지합니다. 영어 원문 수정사항을 병합할 때 중요합니다. **번역 후 줄 수가 원문의 줄 수와 다른 경우는 PR 받지 않겠습니다.** |
| 24 | +* PR 전 [바른한글 맞춤법 검사기](https://nara-speller.co.kr/speller/)(구 부산대 검사기)를 사용해 틀린 부분을 교정합니다. **검사기를 돌리지 않았다고 판단되는 커밋은 PR 받지 않겠습니다.** 리뷰자 역시 맞춤법 검사기를 사용해, 번역자가 맞춤법을 지켜 번역했는지 확인합니다. 검사기는 대학 연구실에서 무료로 운영하므로 자동화 파이프라인엔 넣지 않고 문서당 1회 수동으로 실행합니다. |
| 25 | +* 줄 바꿈과 단락은 '원문 그대로'를 유지합니다. 영어 원문 수정사항을 병합할 때 중요합니다. **번역 후 줄 수가 원문의 줄 수와 다른 경우는 PR 받지 않겠습니다.** |
18 | 26 | * 공백(스페이스), 큰따옴표("), 작은따옴표('), 대시(-), 백틱(\`)을 비롯한 모든 특수문자는 수정하시면 안 됩니다. **자연어만 수정(알파벳을 한글로 수정)해주세요!** [로컬 서버 세팅 방법](https://github.com/javascript-tutorial/ko.javascript.info/wiki/%EB%A1%9C%EC%BB%AC-%EC%84%9C%EB%B2%84-%EC%84%B8%ED%8C%85%ED%95%98%EA%B8%B0)을 참고하셔서 내가 작성한 코드(번역물)가 어떻게 반영될지 확인 후 PR 보내주세요. |
19 | 27 | * 소스 코드 내 공백 등은 원문 병합 시 충돌을 예방하기 위해 되도록 수정하지 않습니다. 자연어(주석)만 번역하도록 합니다. |
20 | | -* [번역 모범 사례](https://github.com/javascript-tutorial/ko.javascript.info/wiki/%EB%B2%88%EC%97%AD-%EB%AA%A8%EB%B2%94-%EC%82%AC%EB%A1%80)와 [KIGO 번역 스타일가이드](https://drive.google.com/file/d/1p6g48TK6GwHDq-88lqTTYgptjpYNRT5d/view?usp=drive_link), [자주 하는 실수](https://docs.google.com/spreadsheets/d/1fYaEI8vz26N3R2VaxrlNnk9fMQ8zIy4RpvjRp4jZd0Q/edit#gid=579221672)를 읽어보시고 작업에 참여해주세요. |
21 | | -* 주제에서 새롭게 등장하는 키워드는 한-영 병기`(예: 프로퍼티(property), 브라우저 객체 모델(Browser Object Model, BOM))`합니다. |
22 | | -* [합의된 번역어](https://docs.google.com/spreadsheets/d/1fYaEI8vz26N3R2VaxrlNnk9fMQ8zIy4RpvjRp4jZd0Q/edit#gid=1401860741)로 번역합니다. 공동작업에선 번역어 통일이 매우 중요합니다. |
23 | | -* 에러 내용은 번역하지 않습니다. |
24 | | - * 예시: let rabbit = new Rabbit("White Rabbit"); // Error: this is not defined에서 주석은 번역하지 않습니다. |
25 | | -* 등록되지 않은 새로운 용어는 [용어집](https://docs.google.com/spreadsheets/u/1/d/1fYaEI8vz26N3R2VaxrlNnk9fMQ8zIy4RpvjRp4jZd0Q/edit#gid=1401860741)에 용어를 등록한 후 번역합니다. |
26 | | -* 번역어는 출판된 도서, 국립국어원의 외래어 표기법 용례, 한글라이즈 사이트 등을 기준으로 선정합니다. 주 참고자료는 다음과 같습니다. |
27 | | - * 마이크로소프트 Language Portal의 Terminology Search 페이지([링크](https://www.microsoft.com/en-us/language/Search)) |
28 | | - * 프론트엔드 개발자를 위한 자바스크립트 프로그래밍([링크](https://www.kyobobook.co.kr/product/detailViewKor.laf?ejkGb=KOR&mallGb=KOR&barcode=9788966260768&orderClick=LIK&Kc=)) |
29 | | - * 인사이드 자바스크립트([링크](https://www.kyobobook.co.kr/product/detailViewKor.laf?mallGb=KOR&ejkGb=KOR&barcode=9788968480652)) |
30 | | - * 러닝 자바스크립트([링크](https://www.kyobobook.co.kr/product/detailViewKor.laf?mallGb=KOR&ejkGb=KOR&barcode=9788968483387)) |
31 | | - * 초보자를 위한 JavaScript 200제([링크](http://www.yes24.com/Product/Goods/70746749?Acode=101)) |
32 | | - * 국립국어원 외래어 표기법 용례 찾기([링크](https://korean.go.kr/kornorms/main/main.do)) |
33 | | - * 한글라이즈([링크](https://hangulize.org/)) |
34 | | -* 원문에는 없으나 독자의 이해를 돕기 위해 번역자가 추가하는 내용은 문장 중간이나 끝에 `(.....부가설명..... - 옮긴이)` 형태로 부가설명을 추가하도록 합니다. |
35 | | -* '적∙의를 보이는 것∙들'에 대한 내용은 될 수 있으면 사용하지 않습니다.([링크](https://m.blog.naver.com/ojhnews/220840570533)) |
| 28 | +* 등록되지 않은 새로운 용어는 [용어집](https://docs.google.com/spreadsheets/u/1/d/1fYaEI8vz26N3R2VaxrlNnk9fMQ8zIy4RpvjRp4jZd0Q/edit#gid=1401860741)에 용어를 등록한 후 번역합니다. 공동작업에선 번역어 통일이 매우 중요합니다. |
| 29 | + |
| 30 | +위 기준 중 줄 수·특수문자·용어집 위반은 스킬의 린터가 자동으로 검사합니다. |
36 | 31 |
|
37 | 32 | 잘못된 번역, 오타 및 기타 개선사항은 [이슈](https://github.com/javascript-tutorial/ko.javascript.info/issues)로 등록 부탁드립니다. |
38 | 33 |
|
| 34 | +### (deprecated) 수기 번역 권고사항 |
| 35 | + |
| 36 | +아래 권고사항은 tech-translation-ko 스킬에 통합되어 더는 개별 항목으로 관리하지 않습니다. 스킬을 사용하면 번역 과정에 자동으로 적용되고, 각 항목의 최신 내용은 스킬 저장소의 `references/` 문서에서 확인할 수 있습니다. |
| 37 | + |
| 38 | +<details> |
| 39 | +<summary>스킬로 대체된 항목 펼쳐보기</summary> |
| 40 | + |
| 41 | +* ~~[번역 모범 사례](https://github.com/javascript-tutorial/ko.javascript.info/wiki/%EB%B2%88%EC%97%AD-%EB%AA%A8%EB%B2%94-%EC%82%AC%EB%A1%80)와 [KIGO 번역 스타일가이드](https://drive.google.com/file/d/1p6g48TK6GwHDq-88lqTTYgptjpYNRT5d/view?usp=drive_link), [자주 하는 실수](https://docs.google.com/spreadsheets/d/1fYaEI8vz26N3R2VaxrlNnk9fMQ8zIy4RpvjRp4jZd0Q/edit#gid=579221672)를 읽어보시고 작업에 참여해주세요.~~ → 스킬 `references/principles.md`, `formatting.md`, `kigo-conventions.md`에 통합 |
| 42 | +* ~~주제에서 새롭게 등장하는 키워드는 한-영 병기`(예: 프로퍼티(property), 브라우저 객체 모델(Browser Object Model, BOM))`합니다.~~ → 스킬 `references/terminology.md`(병기는 본문 첫 등장에서 한 번, 과잉 병기 금지 규칙 포함) |
| 43 | +* ~~[합의된 번역어](https://docs.google.com/spreadsheets/d/1fYaEI8vz26N3R2VaxrlNnk9fMQ8zIy4RpvjRp4jZd0Q/edit#gid=1401860741)로 번역합니다.~~ → 스킬 용어집(`glossary.tsv`, 768개 표제어)과 `glossary_lookup.py` 조회 도구로 통합 |
| 44 | +* ~~에러 내용은 번역하지 않습니다.~~ → 스킬 `references/formatting.md`(플랫폼이 생성하는 에러 출력은 유지, 예제가 정의하는 에러 문자열은 번역하는 경계 규칙 포함) |
| 45 | +* ~~번역어는 출판된 도서, 국립국어원의 외래어 표기법 용례, 한글라이즈 사이트 등을 기준으로 선정합니다.~~ → 스킬 `references/terminology.md`(마이크로소프트 Language Portal, 국립국어원 용례, 참고 도서 목록 포함) |
| 46 | +* ~~원문에는 없으나 독자의 이해를 돕기 위해 번역자가 추가하는 내용은 `(.....부가설명..... - 옮긴이)` 형태로 부가설명을 추가하도록 합니다.~~ → 스킬 `references/sentence-patterns.md`(옮긴이 주 형식과 사용 기준) |
| 47 | +* ~~'적∙의를 보이는 것∙들'에 대한 내용은 될 수 있으면 사용하지 않습니다.([링크](https://m.blog.naver.com/ojhnews/220840570533))~~ → 스킬 `references/principles.md`(번역투 회피 규칙)와 린터 경고로 통합 |
| 48 | + |
| 49 | +</details> |
| 50 | + |
39 | 51 | ## 기여자 |
40 | 52 | 튜토리얼 원문에 기여하신 분들은 <https://javascript.info/about#contributors>에서 확인할 수 있습니다. 한국어 번역에 기여해주신 분들은 <https://ko.javascript.info/about#contributors>에서 확인할 수 있습니다. |
41 | 53 |
|
|
0 commit comments