MDN 일본어 번역 기여하기(1) - 가이드 읽기
- 가이드 원본(링크)
MDN 문서 일본어 번역 가이드
이 문서는 일본어(ja) 문서에 대한 번역 가이드입니다.
이 번역 가이드를 포함한 일본어용 MDN 문서는 다음과 같은 방법으로 유지 관리되고 있습니다. 일본어 문서에 대한 의견이 있으시면 아래 방법으로 질문이나 Pull Request를 해주시기 바랍니다.
MDN 문서에 대한 질문 및 의견 보내기
MDN 일본어 커뮤니티에서는 일본어 전용 GitHub 페이지를 제공하고 있습니다.
MDN의 일본어 문서에 대한 질문이나 의견을 보내고 싶다면, 위 리포지토리에 Issue 또는 Discussion을 작성해 주시기 바랍니다.
문의사항이 있을 때 연락처는 아래 ' 도움이 필요할 때 '를 함께 참고하시기 바랍니다.
MDN 문서 개요
MDN에서는 영어 버전을 주 언어로 문서 https://developer.mozilla.org/en-US/ 가 작성되어 있습니다.
일본을 포함한 각국에서는 영어 버전을 번역하여 현지화 버전 문서 https://developer.mozilla.org/ja/ 을 작성하고 있습니다.
따라서 일본어 버전 문서를 작성할 때는 영어 버전에 충실해야 합니다(내용이 일치해야 합니다). 만약 원본 문서의 내용이 잘못되었다면, 영어 버전을 먼저 수정해야 합니다.
문서는 다음 저장소에서 관리되고 있습니다.
- 영어 버전 저장소 - https://github.com/mdn/content
- 현지화 버전 저장소 - https://github.com/mdn/translated-content
현지화 버전은 국가별로 관리하지 않고, 모든 국가의 현지화를 하나의 Git 리포지토리에서 관리하고 있습니다. 따라서 리포지토리 내 Issue나 Pull Request에는 각 국가별 상호 작용이 존재한다는 점에 유의해야 합니다. 단, 일본어 번역 작업 시 작성하는 Issue나 Pull Request는 기본적으로 일본어 유지보수자를 위한 것이므로 영어가 아닌 일본어로 작성해도 무방합니다.
MDN 문서 편집하기
- 일본어판 문서에서 오류를 발견했다.
- 일본어판 문서와 영어판 문서의 내용에 차이가 있어서 영어판을 따르고 싶다.
- 일본어화되지 않은 페이지를 발견하여 새로 번역하고 싶다.
- 영문판 내용이 이상해서 영문판을 수정하고 싶다.
이럴 때는 다음 중 한 가지 방법으로 문서 편집에 참여할 수 있습니다.
간편하게 문서 편집하기
필요한 것들:
- GitHub 계정
GitHub 계정만 있으면 GitHub가 제공하는 브라우저의 파일 편집 기능을 이용하여 문서를 편집할 수 있습니다.
이 방법은 MDN의 페이지 미리보기가 불가능하기 때문에 사소한 수정을 하는 경우에만 적합합니다.
MDN 페이지 미리보기와 함께 문서를 편집하는 방법은 다음 장 ' 본격적으로 문서 편집하기 '를 참고하세요.
본격적으로 문서 편집하기
필요한 것들:
- GitHub 계정
- Node.js, Yarn 실행 환경
영어 버전 저장소와 현지화 버전 저장소를 git clone하여 MDN의 페이지 미리보기와 함께 편집 작업을 할 수 있습니다.
자세한 절차는 'MDN 월간 밋업 - 번역 가이드'를 참고하시기 바랍니다.
본격적으로 문서를 편집하는 방법은 처음 번역 작업을 하는 분들에게는 다소 생소할 수 있습니다. 모르는 점이나 궁금한 점이 있다면 ' 어려울 때' 에 있는 Slack에서 질문하거나 ' 일본어 번역 작업 정기 모임'에 참여하는 것을 고려해보시기 바랍니다. 정기 모임에서는 튜터(어드바이저)가 작업 절차를 안내하고 문제 해결에 도움을 드리고 있습니다.
일본어 번역 작업 정기 모임에 참여하기
일본어 커뮤니티에서는 '함께 MDN을 번역하자! 번역 커뮤니티 정기 모임! 라는 제목으로 한 달에 한 번씩 정기적인 미트업을 진행하고 있습니다.
정기 밋업에서는 5시간 정도의 시간 동안 모인 사람들과 함께 번역 작업을 진행합니다.
번역 활동을 본격적으로 하고 싶다면, 번역 절차 안내와 리뷰어와 직접 소통할 수 있으니 꼭 한 번 참여해 보세요.
정기적인 밋업에 참여하려면 먼저 Japanese Mozilla community group의 Slack에 가입하여 #translation 채널에 가입해 주세요. 행사 당일의 대화는 #translation 채널에서 진행됩니다. 또한, 이벤트 개최 예정일 중 참가하고 싶은 날짜의 이벤트에 참가 등록을 해주시기 바랍니다. 사전 등록을 하지 않으셔도 당일 현장 참여가 가능합니다.
그리고 정기 미트업 당일에 기다려주세요! 궁금한 점이나 질문이 있으시면 Slack의 #translation 채널로 문의해 주시기 바랍니다.
도움이 필요한 경우
일본어 문서나 번역 작업과 관련하여 궁금한 점이 있으시면 다음 방법으로 문의해 주세요.
영어 문서나 영어 버전 관리자에게 질문이 있는 경우 GitHub의 MDN Web Docs Community 페이지의 Discussion을 이용해 주시기 바랍니다.