このドキュメントでは、Discourse における「サポートする混合テキスト方向」設定の機能、動作、および投稿作成への影響について説明します。
必要なユーザーレベル：管理者
「サポートする混合テキスト方向」設定は、左から右（LTR）と右から左（RTL）の両方の言語を使用するサイトにとって不可欠です。この設定を有効にすると、Discourse が検出された言語に基づき、投稿内容、トピックのタイトル、カテゴリ名、および作曲器のプレビューエリアなどのさまざまな要素のテキスト方向を自動的に調整します。さらに、ユーザーの入力言語に応じてテキスト入力フィールドの方向も設定されます。コンテンツが改行で区切られていれば、個々の投稿内で混合されたテキストを使用することも可能です。
概要
このドキュメントでは、以下について解説します：
- 「サポートする混合テキスト方向」設定の仕組み
- コンテンツ表示への影響
- 投稿作成への影響
- ベストプラクティスと一般的な問題
仕組み
サポートする混合テキスト方向設定は、ブラウザでのコンテンツ表示にのみ影響し、データベースに保存されているコンテンツ自体を変更するものではありません。テキスト方向は、使用されている言語を評価する正規表現によって決定されます。その後、適切な dir 属性がテキストの外部 HTML タグに追加されます。
dir="auto"を設定することで同様の結果が得られる可能性がありますが、この方法は Internet Explorer（IE）ブラウザと互換性がないため、正規表現によるアプローチが必要となります。
投稿の作成
投稿を作成する際、作曲器のテキストエリアに入力されたテキストは、デフォルトでユーザーの優先ロケールの方向に従います。つまり、テキストエリアの入力は一度に一つのテキスト方向しかサポートしません。混合テキスト方向のニーズに対応するため、この設定により作曲器のツールバーに方向切り替えボタンが追加されます。このボタンをクリックすると、テキストエリア全体の方向が切り替わります。
作曲器のプレビューエリアでは、テキストエリアの現在の方向に関係なく、テキストは正しい方向で表示されます。
ベストプラクティス
- コミュニティで LTR と RTL の両方の言語を頻繁に使用する場合は、この設定を有効にしてください。
- 投稿を作成する際は、読みやすさを確保するために「方向切り替え」ボタンを使用してテキスト方向を調整してください。
- 混合言語の投稿における使いやすさを向上させるため、ユーザーに「方向切り替え」ボタンの存在を周知してください。
一般的な問題と解決策
- テキストの配置が正しく表示されない: 設定が有効になっていることを確認してください。問題が解決しない場合は、言語スクリプトが正規表現によって一貫して認識されているか確認してください。
- Internet Explorer との互換性:
dir="auto"は IE ブラウザではサポートされていないことを忘れないでください。一貫した結果を得るためには、提供された機能を使用してください。
よくある質問
Q: 設定が無効になっている場合、どうなりますか？
A: テキスト方向が言語に基づいて自動的に調整されないため、混合言語の投稿で読みやすさに問題が生じる可能性があります。
Q: データベース内の実際のコンテンツを変更しますか？
A: いいえ、ブラウザでのコンテンツの表示方法にのみ影響します。
Q: この設定なしで手動でテキスト方向を設定できますか？
A: はい、可能ですが、この設定を有効にすることでプロセスが簡素化され、サイト全体で一貫性が保たれます。