辞書
ウェブサイトのインターフェースの固定テキストを翻訳する方法。
はじめに
辞書は、ウェブサイトのインターフェースにおける固定テキストの翻訳システムです — ラベル、メッセージ、ボタンのテキストなど、ページのコンテンツではなくコードに「埋め込まれた」テキストでありながら、各言語で存在する必要があるものです。
バックオフィスの2つのフォームが関係します:
- エントリ (
dictionary_entry) - 辞書 (
dictionary)
エントリ
翻訳の「キー」を定義します — コード(code、値を取得するためにコード内で使用)と説明。例: エントリ otoiawase-form-seikou は、お問い合わせフォームの成功メッセージに使用されます(Funcionalidade の ContactForm に表示されるのはまさにこのエントリです)。
辞書
特定の言語(language_id)に対するエントリの翻訳値です — フィールド値(value、HTMLを受け付けます)。
汎用値/言語に依存しない値はありません
設定 とは異なり、辞書には言語を指定しないフォールバックの仕組みがありません — 各エントリは、使用する各言語に対して明示的に値を定義する必要があります。ある言語で翻訳が欠けている場合、表示されるテキストは汎用値ではなく、エントリのコード自体(例: otoiawase-form-seikou)になります。
プログラムから
クラス website/src/common/Cluar.js は、辞書のエントリを読み取る関数を提供しており、翻訳が存在しない場合はすべてエントリのコードを結果として返します(翻訳漏れに気づくのに便利です):
Cluar.dictionary(エントリ)— 現在の言語で翻訳された値を、保存されたとおりに取得します(HTMLを含む場合があります)。Cluar.plainDictionary(エントリ)— 同じですが、<p>と<br>タグを削除します。インターフェースのラベル(ボタン、フォームフィールド、通知)で最もよく使われます。Cluar.plainTitle(エントリ)— 同じですが、<p>タグのみを削除します。Cluar.plainHTML(エントリ)— すべてのHTMLタグを削除します。Cluar.dictionaryNoParagraph(エントリ)—<p>タグのみを削除します(plainTitleと同等)。
次のステップ
テンプレート を参照してください。