このドキュメントでは、Discourse のカスタムテキストの翻訳キーを見つけるための詳細ローカライゼーションの使用方法について説明します。
必要なユーザーレベル: 管理者
詳細ローカライゼーションを使用した翻訳キーの検索
詳細ローカライゼーションは、管理者がカスタムテキストの翻訳キーをより効果的に見つけるのに役立つ Discourse の強力なツールです。これは、Discourse UI の複数の場所に表示されるテキストを翻訳する必要がある場合に特に役立ちます。
概要
このガイドでは、次の内容を説明します。
- 詳細ローカライゼーションの有効化。
- 詳細ローカライゼーションを使用した翻訳キーの識別。
- 実用的なアプリケーションと一般的な使用例。
詳細ローカライゼーションの有効化
セットアップに応じて、詳細ローカライゼーションを有効にするにはいくつかの方法があります。
開発者ツールバーの使用（推奨）
Discourse 開発者ツールバーには、詳細ローカライゼーションの切り替え機能が組み込まれています。これは最も簡単な方法であり、セルフホスト型とホスト型サイトの両方で機能します。
- Discourse サイトでブラウザの開発者コンソールを開きます。
- 次を実行します。
enableDevTools() - ページが再読み込みされ、画面の左側に開発者ツールバーが表示されます。
- ツールバーの
(スクロール) アイコンをクリックして、詳細ローカライゼーションをオンに切り替えます。 - ページが再読み込みされ、詳細ローカライゼーションが有効になります。
開発者ツールバーの状態はブラウザのローカルストレージに保存され、詳細ローカライゼーションの状態はセッションストレージに保存されます。他のユーザーには影響しません。
ブラウザコンソールを直接使用する
- Discourse サイトでブラウザのウェブインスペクターを開きます。
- コンソールタブに移動します。
- プロンプトで次の JavaScript コマンドを入力します。
I18n.enableVerboseLocalizationSession() - 次のような応答が表示されるはずです。
rails コンソールの使用（セルフホスト型のみ）
verbose_localization サイト設定は存在しますが、非表示のサイト設定です。管理 UI の「すべてのサイト設定」では見つけることができません。セルフホストインスタンス上のすべてのユーザーに対してグローバルに有効にするには、次の手順を実行します。
- rails コンソールにアクセスします。
- 次を実行します。
SiteSetting.verbose_localization = true
これにより、サイト上のすべてのユーザーに対して詳細ローカライゼーションが有効になります。他のユーザーの UI が煩雑になるのを避けるため、上記のセッションベースの方法を推奨します。
詳細ローカライゼーションを使用して翻訳キーを検索する
詳細ローカライゼーションが有効になっている場合、サイト上のすべてカスタマイズ可能なテキストの後に番号が表示されます。
翻訳キーを識別する手順
- 更新したいテキストを含む領域を参照します。たとえば、「名前」という単語を探している場合。
- ブラウザのコンソールで対応する翻訳番号を探します。
- 特定された翻訳キー（例:
user.name.title）をメモします。 - 管理サイドバーに移動し、検索バーに
site textsと入力します - 検索ボックスに翻訳キーを入力します。
- テキストの編集ボタンをクリックして、必要に応じてテキストを更新します。
ベストプラクティス
- 翻訳作業中に他のユーザーの UI が煩雑になるのを避けるために、セッション固有の詳細ローカライゼーションを使用します。
- 将来の参照のために、頻繁に使用する翻訳キーを文書化します。
- Discourse のドキュメントの更新を定期的に確認し、ローカライゼーションの新機能に関する情報を常に入手できるようにします。
一般的な問題と解決策
問題: すべてのユーザーに翻訳マーカーが表示される
解決策: 他のユーザーに表示させるべきでない場合は、ご自身のセッションでのみ詳細ローカライゼーションを有効にしてください。グローバルサイト設定の代わりに、開発者ツールバーまたはブラウザコンソールの I18n.enableVerboseLocalizationSession() メソッドを使用します。
問題: 正しい翻訳キーが見つからない
解決策: コンソールと詳細ローカライゼーションマーカーを正確に使用し、サイトテキストのカスタマイズ ページと照合してください。
よくある質問 (FAQ)
Q: 詳細ローカライゼーションを管理者またはスタッフに制限できますか？
A: 詳細ローカライゼーションの番号は、開発者ツールバーまたはブラウザコンソールを使用して個々のセッションで有効にすることにより、技術者以外のユーザーからは非表示にすることができます。
Q: 文字列の翻訳を検証するにはどうすればよいですか？
A: 翻訳キーを特定して更新した後、新しいブラウザセッションまたはタブで UI の変更を確認します。