Home

mdbook 설치

https://rust-lang.github.io/mdBook/cli/index.html 을 참고해서 mdbook 을 설치합니다.

cargo 가 이미 설치되어있다면 cargo install mdbook 만 실행하면 됩니다.

mdbook 실행

프로젝트 최상위 폴더에서 mdbook serve 를 실행합니다.

브라우저에서 https://localhost:3000 에 접속하면 현재 소스가 보입니다.

소스 폴더

src-en/* 에는 참조용 영어원문이 들어있습니다. 나중에 새버전의 원문이 나올 경우, 이곳에 복사한 후 diff 해서 확인하려합니다.

src/* 에 번역 작업용 파일들이 있습니다.

작업 방식

Issues 에 "OOO파일을 작업하겠습니다" 라고 올려주시고, 댓글로 진행상황을 공유해주세요.

작업후에는 PR로 작업한 내용을 올려주세요.

번역 방식

참여자가 늘어나면 더 논의 필요하겠습니다만, 일단 다음과 같은 원칙으로 번역하고 있습니다.

• 존댓말을 사용합니다.
• 읽기 쉬운 문장을 만듭니다.
• 업계에서 사용하는 용어는 원어를 그대로 씁니다. (코멘트, 가비지 컬렉션, 트레잇 등)
• 영어의 문법상 삽입된 대명사는 가급적 번역하지 않습니다. (우리는, 그는, 당신은 등)

그리고, 가급적 KIGO 의 스타일 가이드를 따르려 했습니다.

• https://www.facebook.com/groups/kigostyleguide/permalink/930262127127479/

스타일 가이드에는

• It cancels the selected items on the online store. 를 번역할 때,
• 온라인 상점에서 선택한 항목의 취소를 수행합니다. 보다는
• 온라인 상점에서 선택 항목을 취소합니다. 로 한다

는 식으로 상세한 설명이 있습니다.