Fessから利用するクラスター管理画面のfess-kopfで、ナビゲーション、表の見出し、入力項目名も表示言語に合わせる変更が入りました。説明文やボタンだけでなく、画面を移動したり設定欄を探したりするときの言葉も日本語で読めるようになります。
翻訳される範囲が広がる
今回、ナビゲーション、フォームのラベル、表の列名、統計項目、チェックボックスの説明、ツールチップなどに101個のメッセージキーを追加しました。英語を含む16ロケールに対応します。
英語の原文は従来の表示を維持しています。既存の画面説明やボタンなどの翻訳に加えて、操作対象を探すための表示も言語をそろえる変更です。クラスターへの接続権限やOpenSearchの動作そのものを変えるものではありません。
表示言語の決まり方
言語選択の仕組みは既存のものを使います。Fess管理画面がリクエストから解決した言語を、ダッシュボードのiframe URLのlangパラメーターでfess-kopfへ渡します。通常はAccept-Languageが元になり、管理画面にbrowser_langを指定した場合はその指定が反映されます。
fess-kopf自体のURLで日本語を明示する指定は?lang=jaです。既存のURLにクエリーがある場合は&lang=jaの形で追加します。Fessの管理経路に含まれるトークンやコンテキストパスは環境ごとに異なるので、実際に開いている画面のURLを基に確認してください。
langがない場合はブラウザーの言語を使い、対応言語に解決できなければ英語へ戻ります。タグが完全一致しなければ言語部分を試し、それでも対応しなければ英語です。例えばja-JPは日本語になり、zhだけでは英語になります。翻訳ファイルの読み込みに失敗した場合も英語で表示を続けます。日本語固定が初期値になったわけではなく、新しい有効化スイッチもありません。
APIの名前は原表記を残す
char_filter、content_length、task_id、search_typeなどのJSONキーや識別子、_cat API名、HTTPメソッド、ノードの役割、ステータス値、OpenSearchやFessなどの製品名は翻訳しません。管理画面とAPI応答を照らし合わせるときに、同じ名前で追えるようにするためです。
画面の日本語化でAPIパラメーターまで日本語になるわけではありません。入力するJSONや手順書の識別子は、引き続きOpenSearchの正式なキーを使います。
利用条件と確認ポイント
変更を含むfess-kopfの配信ファイルが必要です。PRでは_siteも再ビルドされていますが、マージ済みであることと正式配布版への反映は別なので、利用中のFessが同梱する版を確認してください。
更新後は日本語の管理画面からダッシュボードを開き、ナビゲーションや作成画面の項目名が日本語になるかを確認します。英語以外の15言語の追加文言は機械翻訳で、ネイティブ話者による確認はされていません。運用手順に転記する際は実際の表示と意味を確認するとよいと思います。