Saltar para o conteúdo principal

Configuração de i18n do Overleaf

Este documento descreve como configurar a internacionalização (i18n) para uma instância auto-hospedada do Overleaf.
O Overleaf foi traduzido para vários idiomas. Com a configuração adequada, você pode:
  • Executar sua instância do Overleaf em um único idioma fixo, ou
  • Habilitar vários idiomas, permitindo que os usuários alternem entre idiomas dinamicamente, de forma semelhante ao www.overleaf.com.

Configuração de idioma único

O idioma do site é configurado usando a variável de ambiente OVERLEAF_SITE_LANGUAGE. Os códigos de idioma suportados incluem:
  • en - Inglês (padrão)
  • es - Espanhol
  • pt - Português
  • de - Alemão
  • fr - Francês
  • cs - Tcheco
  • nl - Holandês
  • sv - Sueco
  • it - Italiano
  • tr - Turco
  • zh-CN - Chinês (simplificado)
  • no - Norueguês
  • da - Dinamarquês
  • ru - Russo
  • ko - Coreano
  • ja - Japonês
  • pl - Polonês
  • fi - Finlandês
O inglês é o idioma padrão. Para alterar o idioma da interface (por exemplo, para chinês simplificado), adicione a seguinte linha a config/variables.env:
config/variables.env
Em seguida, aplique a configuração:
Depois que os serviços forem reiniciados, o idioma da interface nos menus da UI web deverá refletir a nova configuração.

Configuração de vários idiomas

Para permitir que os usuários alternem entre idiomas sem precisar sair da conta, sua instância do Overleaf deve ser configurada para servir idiomas diferentes com base em nomes de domínio. Esta seção pressupõe que:
  • Seu domínio principal é overleaftest.com
  • Você tem um certificado TLS curinga (por exemplo, *.overleaftest.com)
  • Você não está usando localhost (pois ele não suporta roteamento de idiomas baseado em subdomínios)
Para testes locais, você pode usar um domínio como dev-overleaf.com.
1

Configuração do proxy TLS (Nginx)

Seu proxy reverso TLS deve encaminhar o cabeçalho Host original para que o Overleaf possa determinar qual domínio de idioma o usuário acessou.Certifique-se de que a seguinte diretiva esteja presente:
Aqui está um exemplo de configuração do Nginx:
2

Configurar o domínio dos cookies

Para evitar que os usuários sejam desconectados ao trocar de idioma, os cookies devem ser compartilhados entre os subdomínios de idioma.Adicione a seguinte linha a config/variables.env:
config/variables.env
Isso garante que os cookies de autenticação sejam válidos para todos os subdomínios de overleaftest.com.
3

Mapeamento entre idioma e domínio

Em seguida, defina como os códigos de idioma são mapeados para subdomínios usando
OVERLEAF_LANG_DOMAIN_MAPPING.

Exemplo de configuração

config/variables.env
Com esta configuração:
  • https://www.overleaftest.com → interface em inglês
  • https://cn.overleaftest.com → interface em chinês simplificado
Você pode estender esse mapeamento com idiomas e subdomínios adicionais conforme necessário.
Recomendamos servir o site principal em www e sempre incluir uma chave www: defina OVERLEAF_SITE_URL como o endereço www (por exemplo https://www.overleaftest.com), aponte a chave www para ele e redirecione o domínio apex para ele, como mostrado abaixo. A chave www é o site principal e pode usar qualquer idioma. Sem ela, a entrada www padrão permanece, e o seletor de idioma mostra um item extra em inglês que leva a http://127.0.0.1:3000.
4

Redirecionar o domínio raiz

Por fim, redirecione o domínio raiz (overleaftest.com) para o domínio do idioma padrão (www.overleaftest.com).

Q&A

Resposta: O botão de idioma (ícone de tradução) fica no rodapé da página, por exemplo na parte inferior da lista de projetos. Ele não é exibido no editor.O botão aparece apenas quando OVERLEAF_LANG_DOMAIN_MAPPING mapeia dois ou mais idiomas, conforme descrito em Configuração de vários idiomas. Com apenas OVERLEAF_SITE_LANGUAGE definido, todo o site usa esse único idioma e não há botão.Escolher um idioma abre a mesma página no domínio desse idioma, por exemplo cn.overleaftest.com. A escolha não é salva como configuração do usuário.
Resposta: OVERLEAF_LANG_DOMAIN_MAPPING não tem uma chave www. O mapeamento é mesclado ao padrão, que tem uma entrada www para inglês com o endereço interno http://127.0.0.1:3000. Se o seu mapeamento usar apenas outras chaves, como cn e en, essa entrada padrão é mantida e aparece no seletor.Adicione uma chave www com o endereço de OVERLEAF_SITE_URL e remova uma segunda entrada para o mesmo idioma; em seguida, execute bin/up -d:
Última modificação em 2 de novembro de 2026