TrueNAS Webインターフェースの翻訳 (きりしま屋)

https://www.truenas.com/docs/contributing/uitranslations/
の翻訳です。

Webインターフェースの翻訳

読了時間 3分

最終更新 2024-11-15 16:32 EST

TrueNASテキスト文字列の翻訳への貢献方法

デフォルトでは、TrueNASは英語で利用可能です。しかし、ユーザーはTrueNASウェブインターフェースのテキスト文字列翻訳に貢献し、TrueNASを他の多くの言語で利用可能にするお手伝いができます！貢献にはGitHubアカウントと、英語テキストを他の言語に翻訳する能力が必要です。

TrueNAS ウェブインターフェースを翻訳するには、GitHub にサインインし、TrueNAS webui リポジトリに移動します。適切な翻訳ファイルを見つけ、編集し、翻訳内容を含むプルリクエストをプロジェクトに送信します。詳細な手順については、この記事の残りの部分をご覧ください。

ローカライゼーションディレクトリに移動

次の場所へ移動します: TrueNAS 翻訳ディレクトリ。言語変換用.jsonファイルは、webui/src/assets/i18nディレクトリ内に配置されています。

翻訳ファイルを選択

対象言語に対応する.jsonファイルを選択してください。2文字のISO 639-1コードに関する詳細は以下を参照：ISO 639-1 Codes。（訳注：日本語は ja.json になります）

.jsonファイル名をクリック。ファイルがGitHubのウェブベースエディタで開きます。鉛筆アイコンをクリックして編集を開始してください。

記事の編集

ファイルの最終行から順に編集を進めてください。ファイル末尾から開始し、翻訳が記載されているか確認します。翻訳が一切記載されていないファイルもあります。その場合はファイル末尾から編集を開始してください。（訳注：右側の""内が空欄、未翻訳の文字列が前にアルファベット順、右側の""内が入力されている文字列が後にアルファベット順に並んでいます。プルリクエストがマージされた後に言語ファイルが更新されると未翻訳→翻訳済と並べ換えられ、先頭の方に未翻訳が集まっています。末尾から翻訳するとこの翻訳順の並べ換えに翻弄されずに済みますが、それだけなので、未翻訳の任意の行を部分的に翻訳してプルリクエストを送ることも可能です。また日本語の言語ファイルは現時点で一通り翻訳済みなので、先頭付近に新しく追加された文字列が現れる形になっています。そこだけ翻訳していけば追従できる感じですし、表示される状態で不適切な訳に気づいたら、そこだけ直してプルリクエストを送ってもいいでしょう）

ファイルの最終行に翻訳が含まれている場合、上にスクロールしてください（降順）。言語翻訳がリストされていない、次に利用可能なコード行を探します。この地点から翻訳を開始してください。

一部の文字列は複数形処理にICUメッセージ形式を使用できます。トークンを移動し、言語に合わせて調整できます。

テキスト文字列の翻訳

翻訳が必要な英語の文字列が二重引用符で囲まれて最初に表示されます。その後ろにコロン、さらに二重引用符が続きます。翻訳文は二重引用符のペアの間に記入してください。「Preview changes（変更をプレビュー）」タブをクリックすると、変更内容をリアルタイムで確認できます。変更を保存しない場合は「Cancel changes（変更をキャンセル）」をクリックしてください。

新しいプルリクエストを開始する

「Propose changes（変更を提案）」をクリックしてファイルを保存します。これによりリポジトリの新しいフォークが作成され、プルリクエストが開きます。プルリクエストは翻訳されたテキスト文字列をTrueNASに送信し、レビューを受けます。承認されると、これらの翻訳はマスターブランチにマージされます。

プルリクエストを送信する前に、以下の点をご確認ください：

同じ言語ファイルでの作業を継続する予定ですか？その場合、同じフォークされたリポジトリとブランチで作業を続行してください。プルリクエストをドラフトとしてマークします。ドラフト状態のプルリクエストは、レビュー準備完了としてマークするまでマージできません。

ドラフトプルリクエストの詳細は以下を参照：GitHubプルリクエスト。

別の言語ファイルの文字列翻訳を提出しますか？その場合は、作成した元のフォークリポジトリから新しいブランチを作成してください。この新しいブランチで2つ目の言語ファイルの作業を開始します。2つ目の言語ファイルの変更を完了させます。2つ目の言語ファイルを、ドラフトプルリクエストが開かれているブランチにマージします。これによりプルリクエストが言語ごとに分割され、承認プロセスが迅速化されます。

きりしま屋