メインコンテンツへスキップ

Overleaf の i18n 設定

このドキュメントでは、セルフホストの Overleaf インスタンスで国際化(i18n)を設定する方法について説明します。
Overleaf は複数の言語に翻訳されています。適切に設定することで、次のことが可能です。
  • Overleaf インスタンスを単一の固定言語で運用する
  • 複数の言語を有効にし、www.overleaf.com と同様にユーザーが言語を動的に切り替えられるようにする

単一言語の設定

サイトの言語は環境変数 OVERLEAF_SITE_LANGUAGE で設定します。 サポートされている言語コードは次のとおりです。
  • en - 英語(デフォルト)
  • es - スペイン語
  • pt - ポルトガル語
  • de - ドイツ語
  • fr - フランス語
  • cs - チェコ語
  • nl - オランダ語
  • sv - スウェーデン語
  • it - イタリア語
  • tr - トルコ語
  • zh-CN - 中国語(簡体字)
  • no - ノルウェー語
  • da - デンマーク語
  • ru - ロシア語
  • ko - 韓国語
  • ja - 日本語
  • pl - ポーランド語
  • fi - フィンランド語
デフォルトの言語は英語です。インターフェースの言語を変更するには(たとえば簡体字中国語に)、config/variables.env に次の行を追加します。
config/variables.env
次に、設定を適用します。
サービスが再起動すると、Web UI のメニューのインターフェース言語に新しい設定が反映されます。

複数言語の設定

ユーザーがログアウトせずに言語を切り替えられるようにするには、ドメイン名に応じて異なる言語を提供するよう Overleaf インスタンスを設定する必要があります。 このセクションでは、次のことを前提としています。
  • プライマリドメインが overleaftest.com である
  • ワイルドカード TLS 証明書(例:*.overleaftest.com)を持っている
  • localhost を使用していない(サブドメインベースの言語ルーティングに対応できないため)
ローカルでテストする場合は、dev-overleaf.com などのドメインを使用できます。
1

TLS プロキシの設定(Nginx)

Overleaf がユーザーのアクセスした言語ドメインを判別できるように、TLS リバースプロキシは元の Host ヘッダーを転送する必要があります。次のディレクティブが含まれていることを確認してください。
Nginx の設定例を次に示します。
2

Cookie ドメインを設定する

言語を切り替えたときにユーザーがログアウトされないようにするには、言語ごとのサブドメイン間で Cookie を共有する必要があります。config/variables.env に次の行を追加します。
config/variables.env
これにより、認証用 Cookie が overleaftest.com 配下のすべてのサブドメインで有効になります。
3

言語とドメインのマッピング

次に、OVERLEAF_LANG_DOMAIN_MAPPING を使用して、言語コードとサブドメインの対応を定義します。

設定例

config/variables.env
この設定では次のようになります。
  • https://www.overleaftest.com → 英語のインターフェース
  • https://cn.overleaftest.com → 簡体字中国語のインターフェース
必要に応じて、このマッピングに言語とサブドメインを追加できます。
メインサイトは www で配信し、常に www キーを含めることをお勧めします。OVERLEAF_SITE_URL を www のアドレス(例:https://www.overleaftest.com)に設定し、www キーをそのアドレスに向け、以下のように Apex ドメインをそこへリダイレクトしてください。www キーはメインサイトであり、任意の言語を使用できます。これがない場合、デフォルトの www エントリが残り、言語選択に http://127.0.0.1:3000 へリンクする余分な英語の項目が表示されます。
4

Apex ドメインをリダイレクトする

最後に、Apex ドメイン(overleaftest.com)をデフォルト言語のドメイン(www.overleaftest.com)にリダイレクトします。

Q&A

回答: 言語ボタン(翻訳アイコン)は、プロジェクト一覧の下部など、ページのフッターにあります。エディターには表示されません。このボタンは、複数言語の設定で説明しているように、OVERLEAF_LANG_DOMAIN_MAPPING で 2 つ以上の言語をマッピングしている場合にのみ表示されます。OVERLEAF_SITE_LANGUAGE のみを設定している場合、サイト全体がその 1 つの言語を使用し、ボタンは表示されません。言語を選択すると、その言語のドメイン(例:cn.overleaftest.com)で同じページが開きます。ユーザー設定としては保存されません。
回答: OVERLEAF_LANG_DOMAIN_MAPPING に www キーがないためです。マッピングはデフォルトのマッピングにマージされ、デフォルトには内部アドレス http://127.0.0.1:3000 を持つ英語の www エントリがあります。マッピングで cn や en など他のキーのみを使用している場合、そのデフォルトのエントリが残り、言語選択に表示されます。OVERLEAF_SITE_URL のアドレスを持つ www キーを追加し、同じ言語の 2 つ目のエントリを削除してから、bin/up -d を実行してください。
最終更新日 2026年11月2日