Saltar al contenido principal

Configuración de i18n de Overleaf

Este documento describe cómo configurar la internacionalización (i18n) de una instancia autoalojada de Overleaf.
Overleaf se ha traducido a varios idiomas. Con la configuración adecuada, puedes:
  • Ejecutar tu instancia de Overleaf en un único idioma fijo, o
  • Habilitar varios idiomas, lo que permite a los usuarios cambiar de idioma dinámicamente, de forma similar a www.overleaf.com.

Configuración de un solo idioma

El idioma del sitio se configura mediante la variable de entorno OVERLEAF_SITE_LANGUAGE. Los códigos de idioma admitidos incluyen:
  • en - Inglés (predeterminado)
  • es - Español
  • pt - Portugués
  • de - Alemán
  • fr - Francés
  • cs - Checo
  • nl - Neerlandés
  • sv - Sueco
  • it - Italiano
  • tr - Turco
  • zh-CN - Chino (simplificado)
  • no - Noruego
  • da - Danés
  • ru - Ruso
  • ko - Coreano
  • ja - Japonés
  • pl - Polaco
  • fi - Finés
El inglés es el idioma predeterminado. Para cambiar el idioma de la interfaz (por ejemplo, a chino simplificado), añade la siguiente línea a config/variables.env:
config/variables.env
A continuación, aplica la configuración:
Una vez reiniciados los servicios, el idioma de los menús de la interfaz web debería reflejar el nuevo ajuste.

Configuración de varios idiomas

Para permitir que los usuarios cambien de idioma sin cerrar sesión, tu instancia de Overleaf debe configurarse para servir distintos idiomas según el nombre de dominio. Esta sección supone que:
  • Tu dominio principal es overleaftest.com
  • Tienes un certificado TLS comodín (p. ej., *.overleaftest.com)
  • No usas localhost (ya que no admite el enrutamiento de idiomas basado en subdominios)
Para pruebas locales, puedes usar un dominio como dev-overleaf.com.
1

Configuración del proxy TLS (Nginx)

Tu proxy inverso TLS debe reenviar la cabecera Host original para que Overleaf pueda determinar a qué dominio de idioma ha accedido el usuario.Asegúrate de que esté presente la siguiente directiva:
Este es un ejemplo de configuración de Nginx:
2

Configurar el dominio de las cookies

Para evitar que los usuarios cierren sesión al cambiar de idioma, las cookies deben compartirse entre los subdominios de idioma.Añade la siguiente línea a config/variables.env:
config/variables.env
Esto garantiza que las cookies de autenticación sean válidas para todos los subdominios de overleaftest.com.
3

Asignación de idiomas a dominios

A continuación, define cómo se asignan los códigos de idioma a los subdominios mediante
OVERLEAF_LANG_DOMAIN_MAPPING.

Ejemplo de configuración

config/variables.env
Con esta configuración:
  • https://www.overleaftest.com → interfaz en inglés
  • https://cn.overleaftest.com → interfaz en chino simplificado
Puedes ampliar esta asignación con idiomas y subdominios adicionales según sea necesario.
Recomendamos servir el sitio principal en www e incluir siempre una clave www: establece OVERLEAF_SITE_URL en la dirección www (por ejemplo https://www.overleaftest.com), haz que la clave www apunte a ella y redirige el dominio raíz a ella como se muestra a continuación. La clave www es el sitio principal y puede usar cualquier idioma. Sin ella, se mantiene la entrada www predeterminada y el selector de idioma muestra un elemento adicional en inglés que enlaza a http://127.0.0.1:3000.
4

Redirigir el dominio raíz

Por último, redirige el dominio raíz (overleaftest.com) al dominio del idioma predeterminado (www.overleaftest.com).

Preguntas y respuestas

Respuesta: El botón de idioma (icono de traducción) está en el pie de página, por ejemplo en la parte inferior de la lista de proyectos. No se muestra en el editor.El botón solo aparece cuando OVERLEAF_LANG_DOMAIN_MAPPING asigna dos o más idiomas, como se describe en Configuración de varios idiomas. Si solo se establece OVERLEAF_SITE_LANGUAGE, todo el sitio usa ese único idioma y no hay botón.Al elegir un idioma se abre la misma página en el dominio de ese idioma, por ejemplo cn.overleaftest.com. No se guarda como ajuste del usuario.
Respuesta: OVERLEAF_LANG_DOMAIN_MAPPING no tiene una clave www. La asignación se combina con la predeterminada, que tiene una entrada www para inglés con la dirección interna http://127.0.0.1:3000. Si tu asignación solo usa otras claves, como cn y en, esa entrada predeterminada se mantiene y aparece en el selector.Añade una clave www con la dirección de OVERLEAF_SITE_URL, elimina una segunda entrada para el mismo idioma y después ejecuta bin/up -d:
Última modificación el 2 de noviembre de 2026