プレーンテキスト

テキストファイルを行ごとに翻訳し、原文の各行の位置を訳文でもそのまま保ちます。

アプリストアの説明文やリリースノートなどのプレーンテキストファイルには、マークアップもキーもありません。txtファイルハンドラーは各行を個別に翻訳し、元の位置に訳文を書き戻します。そのため、翻訳後も原文と同じ行数が保たれます。

行と翻訳単位 #

例:

text
Plan your trips offline.

  • Download maps for any region
  • Share routes with friends

テキストを含む各行が、行番号をキーとする一つの翻訳単位になります。この例では、1行目、3行目、4行目が翻訳されます。空行や、スペースまたはタブだけの行は翻訳単位に含まれず、そのままコピーされます。

行頭と行末のスペースやタブは翻訳単位に含まれないため、翻訳後もインデントや行末のスペースが保たれます。翻訳されるのは、その間にあるテキストだけです。

出力の再構築 #

出力時には、現在の原文の各行のテキストを訳文に置き換え、それ以外はすべてバイト単位でそのまま保持します。空行、インデント、各行の改行コード(LFまたはCRLF。混在する場合も含む)、ファイル末尾の改行の有無も変わりません。そのため、翻訳後の行数は原文と同じになります。

訳文の前後にあるスペースや改行は削除され、訳文中の改行は一つのスペースに置き換えられます。そのため、翻訳によって行が増えることはありません。訳文が空の場合、そのロケールの出力の組み立てに失敗します。

訳文の再利用は、SubRipのキューと同様に、行のテキストとファイル内の位置が変わっていないかどうかに基づいて判断されます。行のインデントを変更しても、再翻訳は不要です。行を追加または削除した場合、ファイル内に一度だけ現れるテキストの行は訳文が維持されますが、同じテキストが複数回現れる行は再翻訳されます。翻訳先ファイルの行数が前回の原文と異なる場合、そのファイルのテキストは再利用できません。前回の原文は、対応する承認済みの翻訳先ファイルと対にして保持してください。

テキストの設定と確認 #

CLIとGitHub Appは、.txtからtxtを推定します。.txtファイルを対象にできるのは、metadata/en/*.txtのようにパターンが.txtで終わるか、"format": "txt"が設定されているファイルエントリだけです。また、"format": "txt"を指定したエントリでは、.txtファイルだけが選択されます。docs/en/**/*のような広範囲に一致するパターンでは.txtファイルがスキップされるため、LICENSE.txtやrequirements.txtのようなファイルは翻訳されません。ただし、後続のエントリで.txtを指定すれば、それらのファイルも選択できます。同様に、"format": "txt"を指定した広範囲に一致するエントリでも、画像などのテキスト以外のファイルはスキップされます。ファイルの選択には、CLIの設定またはGitHubを使用してください。行番号は固定のキーではなく位置を表すため、CLIのキースコープは利用できません。

各行が個別の翻訳単位になるため、複数行に分かれた段落も行ごとに翻訳されます。翻訳先の言語で文の語順を入れ替える必要がある場合は、各段落を一行にまとめてください。訳文は、実際に使用する場所で確認してください。ストアの掲載ページや文字数制限のある入力欄では、原文より長い訳文が受け付けられない場合があります。