jhonghee/golang-spec

Go 언어 스펙 한글 번역

golang-spec

Go 언어 스펙 한글 번역

Go 언어 스펙 번역에 참여하실 분들은 아래 링크를 통해 본인이 번역하고자 하는 부분에 이름을 등록하시길 바랍니다.

https://docs.google.com/spreadsheets/d/1R-E_4SM1vGsUiGBLLVilUlahHxC7U1R592E3GLryYKA/edit?usp=sharing

작년에 Effective Go 번역과 마찬가지로 GitHub 저장소를 fork하시고 번역하신 다음 PR을 생성해주시면 됩니다.

번역물은 GitBook에 호스트됩니다.

기본적인 번역 가이드라인에 대한 의견은 issue를 이용해주세요.

번역에 대한 질의 및 토의는 GitHub issue 게시판을 이용해주시기 바랍니다.

Gitter 방도 마련되어 있으니 많은 참여바랍니다.

번역 진행 과정

번역(Crowdin) - PR - Review - Merge - GitBook 포스팅 - Proof of Reading - Issue 생성 - Contents Update(Crowdin)

• 번역물 관리를 위해 crowdin 연동 시범 운영 중입니다. issue 게시판 참고하시고 사용 후기 남겨주세요.
• 번역은 crowdin에서 번역 참가신청 후 참여하시면 됩니다.
• crowdin에서 Korean을 선택하신 다음, 번역하고 싶은 파일을 찾아 번역을 시작하세요.
• crowdin에서 작업이 완료되면 관리자의 승인 절차를 거쳐 자동으로 GitHub 저장소에 PR이 생성됩니다.
• PR(pull request)이 생성되면 PR에 대한 review가 진행되며, 이 과정에서 오탈자 확인, 번역문 개선, 의견 교환 등이 이루어집니다.
• review 과정에서 논의된 수정사항들을 반영하여 PR을 업데이트하면 최종적으로 master branch에 merge됩니다.
• GitHub에서 master branch에 merge되면 자동으로 GitBook에 포스팅됩니다.
• GitBook에 포스팅된 이후에 발생하는 번역문 관련 모든 이슈는 GitHub issue로 보고해주시기 바랍니다.
• 번역 참가자(proof of reading 참가자 포함)는 GitBook에서 제공하는 disqus 댓글, discussion 기능 대신 GitHub issue를 이용해주세요.

crowdin 번역 팁

• crowdin은 markdonw을 지원하지 않기 때문에 italic, code tag 등은 HTML 태그로 편집해야 합니다. 번역 대상 파일 선택후 setting 에서 HTML tag displaying을 Show로 설정(default는 auto임)하면 html tag를 편집할 수 있음.
• 상단에 제시된 원문을 그대로 붙여놓고 싶으면 Ctrl+C(mac에서도 단축키가 동일하다) 활용
• save 버튼 단축키 : meta(mac은 cmd) + enter

번역 가이드라인

1. 타입 자체가 코드에서 사용되는 경우 string 타입과 같은 형태로 번역하고, 그 외에는 한글 번역을 적용하는 것을 원칙으로 합니다. 이 기준에 따라 타입은 아래와 같이 번역합니다.

불리언 타입, 숫자 타입, string 타입, 배열 타입, 슬라이스 타입, struct 타입, 포인터 타입, 함수 타입, interface 타입, map 타입, 채널 타입

// 번역 예시 
A string type represents the set of string values

string 타입은 문자열 값들의 집합을 표현한다.

2. EBNF에 따라 작성된 Go 문법은 번역하지 않는 것을 원칙으로 합니다.(주석은 번역 가능) 예를 들면, Characters 섹션에 나오는 문법 표현은 아래와 같습니다.

newline        = /* the Unicode code point U+000A */ .
unicode_char   = /* an arbitrary Unicode code point except newline */ .
unicode_letter = /* a Unicode code point classified as "Letter" */ .
unicode_digit  = /* a Unicode code point classified as "Number, decimal digit" */ .

Go 문법 표현은 원문 그대로 유지해 주시길 바라며, /* the Unicode code point U+000A */과 같은 주석은 한글로 번역하셔도 괜찮습니다.

3. 맺음말은 "~하다"로 통일하겠습니다.
4. 용어집에서는 자주 사용되는 용어, 번역하기 힘들거나 애매한 용어들에 대한 추천 번역 및 설명을 제공하고 있습니다. GitBook에서는 용어집에 등록된 용어가 본문에 있을 경우, 아래처럼 밑줄, 하이라이트, 팝업창 등의 기능을 제공합니다.(예제에서는 code point가 해당됩니다.)

용어집 용어 추가 건의, 번역 용어에 대한 의견은 용어집 이슈 게시판을 이용해주세요.

5. 번역작업도 중요하지만 함께 작업하시는 분들의 내용을 Proof reading하는데 동참해 주십시요.