ローカリゼーション

Overleaf の i18 設定

この文書は、セルフホスト型の国際化（i18n）をどのように設定するかを説明します。 Overleaf インスタンス。

Overleaf は複数の言語に翻訳されています。適切な構成により、次のことができます：

• Overleaf インスタンスを 単一の固定言語で実行する、または

• 有効にする 複数の言語、ユーザーが動的に言語を切り替えられるようにします（例： www.overleaf.com.

---

単一言語の設定

サイトの言語は環境変数で設定します： OVERLEAF_SITE_LANGUAGE（または SHARELATEX_SITE_LANGUAGE 古い Overleaf バージョンでは 4.x 以前）).

サポートされている言語コードには次のものがあります：

• 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

OVERLEAF_SITE_LANGUAGE=zh-CN

その後、構成を適用します：

bin/up

サービスを再起動した後、Web UI のメニューに表示されるインターフェース言語は新しい設定を反映するはずです。

複数言語の設定

ユーザーが ログアウトせずに言語を切り替えられるようにするには、Overleaf インスタンスはドメイン名に基づいて異なる言語を配信するように構成する必要があります。

このセクションは次を前提としています：

• あなたの主要なドメインは overleaftest.com

• あなたは ワイルドカード TLS 証明書を持っている （例： *.overleaftest.com)

• あなたは 使用していない localhost （サブドメインベースの言語ルーティングをサポートできないため）

ローカルでテストする場合、次のようなドメインを使用できます： dev-overleaf.com.

1

TLS プロキシの設定（Nginx）

TLS リバースプロキシは、元の Host ヘッダーを転送する必要があります。これにより Overleaf はユーザーがどの言語ドメインにアクセスしたかを判別できます。

次のディレクティブが存在することを確認してください：

proxy_set_header Host $host;

以下は Nginx 設定の例です：

server {
    listen 443 ssl;
    server_name    _; # すべてをキャッチします。詳細は http://nginx.org/en/docs/http/server_names.html を参照
    server_name *.overleaftest.com;
    ssl_certificate /etc/nginx/ssl/nginx.crt;
    ssl_certificate_key /etc/nginx/ssl/nginx.key;
    ssl_protocols               TLSv1 TLSv1.1 TLSv1.2;
    ssl_prefer_server_ciphers   on;
    # cloudflare の暗号スイートを使用しています https://github.com/cloudflare/sslconfig/blob/master/conf
    ssl_ciphers EECDH+CHACHA20:EECDH+AES128:RSA+AES128:EECDH+AES256:RSA+AES256:EECDH+3DES:RSA+3DES:!MD5;

    # HSTS (HTTP Strict Transport Security) を有効にする設定 https://developer.mozilla.org/en-US/docs/Security/HTTP_Strict_Transport_Security
    # SSL ストリッピングを回避するため https://en.wikipedia.org/wiki/SSL_stripping#SSL_stripping	
    add_header Strict-Transport-Security "max-age=31536000; includeSubdomains;";
    server_tokens off;
    add_header X-Frame-Options SAMEORIGIN;
    add_header X-Content-Type-Options nosniff;
    client_max_body_size 50M;

    location / {
        proxy_pass http://localhost:5000; # Docker コンテナがリッスンしているホスト/ポートに合わせて変更してください。
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_read_timeout 3m;
        proxy_send_timeout 3m;
        
        # これを nginx の設定に追加してください
        proxy_set_header Host $host;
    }
}

2

Cookie ドメインの設定

言語を切り替えたときにユーザーがログアウトされないようにするには、クッキーを言語ごとのサブドメイン間で共有する必要があります。

次の行を追加してください： config/variables.env:

config/variables.env

# 先頭のドットに注意してください
COOKIE_DOMAIN=.overleaftest.com

これにより認証クッキーがすべてのサブドメインで有効になります（ overleaftest.com.

3

言語–ドメインマッピング

次に、言語コードがサブドメインにどのようにマッピングされるかを定義します： OVERLEAF_LANG_DOMAIN_MAPPING.

設定例

config/variables.env

OVERLEAF_LANG_DOMAIN_MAPPING='{"www": {"lngCode": "en","url": "https:\/\/www.overleaftest.com"},"cn": {"lngCode": "zh-CN","url": "https:\/\/cn.overleaftest.com"}}'

この設定では：

• https://www.overleaftest.com → 英語のインターフェース

• https://cn.overleaftest.com → 簡体字中国語のインターフェース

必要に応じて、追加の言語やサブドメインでこのマッピングを拡張できます。

4

ルートドメインのリダイレクト

最後に、ルートドメイン（overleaftest.com）をデフォルト言語ドメイン（www.overleaftest.com).

server{
    listen 80;
    server_name overleaftest.com;
    return 301 https://www.overleaftest.com$request_uri;
}

server {
    listen 443 ssl http2;
    server_name overleaftest.com;
    ssl_certificate     /path/to/fullchain.cer;
    ssl_certificate_key /path/to/overleaftest.com.key;
    return 301 https://www.overleaftest.com$request_uri;
}