Skip to content

TranslationRules

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

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

翻訳時のルール

体裁

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

コードサンプル

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

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

Clone this wiki locally
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy