アプリを翻訳する
翻訳への貢献は、Meshtastic をより多くの人が使えるようにするのに役立ちます。 アプリは、ユーザーインターフェースとアプリ内ドキュメントの両方のコミュニティ翻訳を管理するために Crowdin を使用しています。
翻訳される対象
| リソース | ソースの場所 | 備考 |
|---|---|---|
| UI 文字列 | core/resources/src/commonMain/composeResources/values/strings.xml | ボタン、ラベル、メッセージ、およびユーザーに表示されるすべてのテキスト |
| ユーザーガイドのページ | docs/en/user/*.md | 「ヘルプとドキュメント」に表示されるアプリ内ドキュメント |
| Fastlane メタデータ | fastlane/metadata/android/en-US/ | アプリストアの掲載タイトル、説明、変更履歴 |
⚠️ 注意: 開発者ガイドのページは英語のみです。 コントリビューター向けの、コード中心のドキュメントは翻訳されません。
貢献する方法
- Crowdin プロジェクトにアクセスします。 Meshtastic Android の Crowdin プロジェクト を開き、サインインするか、無料アカウントを作成します。
- 言語を選びます。 既存の言語を選択するか、GitHub の issue を作成して新しい言語をリクエストします。
- 文字列を翻訳します。 Crowdin では、左側に英語の原文、右側に自分の翻訳が表示されます。 各文字列を翻訳して保存します。
- コンテキストを確認します。 多くの文字列には、スクリーンショットやコンテキストのコメントが含まれています。これらを確認して、テキストがアプリのどこに表示されるかを把握してください。
- 送信します。 承認された翻訳は、次のリリースに自動的にマージされます。
💡 ヒント: 翻訳は短くしてください。 UI 文字列は、ボタン、チップ、狭い列に表示されることがよくあります。 翻訳が英語の原文よりも大幅に長くなる場合は、意味が明確なままになる範囲で短縮することを検討してください。
新しい言語を追加する
自分の言語がまだ Crowdin に掲載されていない場合:
- GitHub で issue を作成し、新しいロケールをリクエストします。
- メンテナーが Crowdin にその言語を追加し、
crowdin.ymlを設定します。 - 追加されたら、すぐに翻訳を始められます。
翻訳の構成
Android アプリは、ユーザーに表示されるすべての文字列に Compose Multiplatform リソースを使用しています:
core/resources/src/commonMain/composeResources/
├── values/ ← 英語(デフォルト)
│ └── strings.xml
├── values-de/ ← ドイツ語
│ └── strings.xml
├── values-fr/ ← フランス語
│ └── strings.xml
└── ...
アプリ内ドキュメントも、docs/ の下で同様のパターンに従います:
docs/
├── en/user/ ← 英語ソース(デフォルト)
│ ├── onboarding.md
│ └── ...
├── fr-rFR/user/ ← フランス語(フランス)
│ ├── onboarding.md
│ └── ...
├── de-rDE/user/ ← ドイツ語(ドイツ)
│ └── ...
└── ...
ロケールフォルダーは、Android のリソース規則 {lang}-r{REGION}(例:fr-rFR、de-rDE、ja-rJP)を使用し、アプリ文字列に使われる values-* ディレクトリと対応しています。
アプリは、デバイスの言語と地域の設定に基づいて、正しいロケールを自動的に選択します。
翻訳ガイドライン
- 「LoRa」「MQTT」「BLE」「TAK」「SNR」「RSSI」などの技術用語は翻訳しないでください。これらは共通です。
- プレースホルダーはそのまま保ちます。
%1$sや%dのような文字列は、実行時に値が埋め込まれます。 自分の言語の文法上必要な場合を除き、削除したり並び替えたりしないでください。 - トーンを合わせます。 アプリは、親しみやすく率直な語り口を使っています。 過度に堅い言葉は避けてください。
- 可能ならテストします。 デバイスの言語を切り替えてアプリを開き、翻訳が実際の文脈でどう見えるか確認してください。
質問がありますか?
If you have questions about a specific string’s context or need help getting started, open a discussion on the Meshtastic GitHub Discussions page.
Meshtastic の普及にご協力いただき、ありがとうございます!