言語
言語は理解の障壁となることがあります。Tuist をできるだけ多くの人にご利用いただけるよう、私たちはアクセシビリティの向上に取り組んでいます。Tuist がまだ対応していない言語を話せる場合は、英語のソースと Glossia が翻訳に使用するローカライゼーションコンテキストを改善することで、その言語への対応を支援できます。
言語サポートは継続的な取り組みであるため、メンテナンスを引き受けてくれる貢献者が現れた時点で新たな言語を追加しています。現在サポートされている言語は以下のとおりです。
- 英語
- アラビア語
- スペイン語
- 日本語
- ジョージア語
- 韓国語
- ロシア語
- 広東語
- 簡体字中国語
- 繁体字中国語
新しい言語のリクエスト
Tuist に新しい言語のサポートが必要だとお考えの場合は、コミュニティで議論するため コミュニティフォーラムにトピックを作成 してください。
支援方法#
Tuist の言語サポートはリポジトリから推進されます。貢献者が英語のソースと翻訳コンテキストを更新すると、Glossia が自動的にローカライズされたファイルを生成します。
ワークフローは次のとおりです。
- 英語のソースコンテンツを更新する。
- 翻訳者に追加のガイダンスが必要な場合は、関連する
L10N.mdコンテキストを更新する。 - それらのソース変更を含むプルリクエストを作成する。
- 変更が
mainにマージされると、Glossia は変更部分を翻訳し、更新されたローカライズファイルを含む翻訳用プルリクエストをオープン状態に保ちます。
生成されたローカライズコンテンツを変更しない
生成されたローカライズコンテンツを直接編集しないでください。代わりに英語のソースと言語コンテキストを更新してください。
L10N.md の構造#
L10N.md ファイルは、Glossia が翻訳時に使用するコンテキストを定義します。これらは異なるディレクトリレベルに配置できる、スコープ付きの言語指示として捉えると分かりやすいでしょう。
例:
plaintext
.
|-- L10N.md
|-- server
| |-- L10N.md
| |-- L10N
| | `-- es.md
| `-- priv
| `-- gettext
| `-- marketing.pot
ディレクトリコンテキスト#
Glossia はリポジトリのルートから翻訳対象のディレクトリまで降りていき、そのパス上にあるすべての L10N.md ファイルを結合します。
上記の例では:
L10N.mdはグローバルに適用されます。server/L10N.mdはサーバー固有のコンテキストを追加します。server/L10N/es.mdは同じ領域に対してスペイン語専用のオーバーライドを追加します。
つまり、コンテキストを適切な場所に配置できます。
- リポジトリ全体のガイダンスはルートに配置
- 領域固有のガイダンスはサブディレクトリに配置
- 言語固有のガイダンスは
L10N/<locale>.mdに配置