Appleの文字列テーブル
検索キーを保持したままAppleの文字列テーブルの値を翻訳し、再構成したテキストをエスケープします。
Appleの文字列テーブルは、固定の検索キーと画面に表示するテキストを対応付けます。xcode-stringsファイルハンドラーは右辺の値を翻訳し、キーを保持したまま、エスケープした文字列リテラルをロケールごとの.stringsファイルに書き戻します。
キーと値 #
例:
/* Checkout heading */
"checkout.title" = "Complete your order";
"delivery.estimate" = "Delivery within %d days";右辺の2つの値が翻訳単位です。checkout.titleとdelivery.estimateは検索キーとしてそのまま保持されます。コメントも各エントリとともに保持されますが、このハンドラーはコメントの内容を翻訳者向けのヒントには変換しません。短いラベルの意味が曖昧な場合は、翻訳ワークフローが対応している方法でコンテキストを指定してください。
引用符で囲まれたキーと値、代入記号、セミコロンは、対応する文字列テーブル構文の一部です。パーサーは対応するエスケープシーケンスをデコードし、出力時には引用符、バックスラッシュ、改行、タブ、復帰文字をエスケープします。値を置き換えても、周囲のコメントやエントリの空白は保持されます。
マージとリソースの配置 #
以前のソースを基に、変更された値をキーごとに判定し、既存の翻訳先から引き継ぐ翻訳を取得します。エントリの構成とコメントは、現在のソースによって決まります。メッセージを変更した場合は通常のソース更新を行い、翻訳指針を変更した場合はファイル全体を明示的に更新してください。詳しくはCLIのスコープを参照してください。
ロケール別のリソースは、en.lproj/Localizable.stringsやde.lproj/Localizable.stringsなど、アプリケーションが読み込む場所に配置してください。Base.lproj内のソースとロケール名のディレクトリ内のソースでは、パスの導出における意味が異なります。使用するツールで出力先を確認してください。テーブルを翻訳しても、アプリケーションの開発言語やリソースの所属は設定されません。
文字列テーブルの設定と読み込み #
CLIは.stringsからxcode-stringsを推定します。選択とパスのルールについてはCLIの設定を、管理対象リポジトリへの出力についてはGitHubを参照してください。
アプリで翻訳先のテーブルを読み込み、実際の値を使って書式指定子の動作を確認してください。複数形の選択用リソースにはstringsdictを使用します。プロジェクトで文字列カタログを使用している場合は、共有ファイルのマージルールに従ってください。ロケールごとにカタログの名前を変更すると、リソース構成が変わってしまいます。