FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

TranslationRules · python-doc-ja/python-doc-ja Wiki · GitHub

Repository navigation

TranslationRules

TAKASE Arihiro edited this page Dec 8, 2015 · 2 revisions

これは rst ファイルを直接翻訳するときのルールです。 Transifex を利用した翻訳は 翻訳手順 を参照してください。

翻訳時のルール

体裁

翻訳文の一行の長さは、75文字前後を目安にしてください。 厳密になる必要はありません。長い段落の最初の方を修正したときに、 折り返しの長さの調製のために段落の残りの部分を全部修正していくのは 手間ですし、レビュー時に差分を確認するのも難しくなります。 文中での改行位置は、できるだけ文節にしてください。

コードサンプル

少なくとも Python 2系では、docstring の内容は翻訳しないでください。 非ASCII文字列をバイト文字列リテラルで書くのは良くない習慣です。

コメントは、基本的に翻訳してもしなくてもかまいません。 ただし、チュートリアルについては、意味のあるコメントは翻訳するべきです。

Wiki pages Pages 20

Clone this wiki locally


Back | FazBrowse Home | New Git URL