-
Notifications
You must be signed in to change notification settings - Fork 7
TranslationRules
TAKASE Arihiro edited this page Dec 8, 2015
·
2 revisions
これは rst ファイルを直接翻訳するときのルールです。 Transifex を利用した翻訳は 翻訳手順 を参照してください。
翻訳文の一行の長さは、75文字前後を目安にしてください。 厳密になる必要はありません。長い段落の最初の方を修正したときに、 折り返しの長さの調製のために段落の残りの部分を全部修正していくのは 手間ですし、レビュー時に差分を確認するのも難しくなります。 文中での改行位置は、できるだけ文節にしてください。
少なくとも Python 2系では、docstring の内容は翻訳しないでください。 非ASCII文字列をバイト文字列リテラルで書くのは良くない習慣です。
コメントは、基本的に翻訳してもしなくてもかまいません。 ただし、チュートリアルについては、意味のあるコメントは翻訳するべきです。