Passer au contenu principal

Configuration i18n d’Overleaf

Ce document explique comment configurer l’internationalisation (i18n) d’une instance Overleaf auto-hébergée.
Overleaf a été traduit dans plusieurs langues. Avec la configuration appropriée, vous pouvez :
  • Faire fonctionner votre instance Overleaf dans une seule langue fixe, ou
  • Activer plusieurs langues, permettant aux utilisateurs de changer de langue dynamiquement, comme sur www.overleaf.com.

Configuration à langue unique

La langue du site se configure via la variable d’environnement OVERLEAF_SITE_LANGUAGE. Les codes de langue pris en charge incluent :
  • en - Anglais (par défaut)
  • es - Espagnol
  • pt - Portugais
  • de - Allemand
  • fr - Français
  • cs - Tchèque
  • nl - Néerlandais
  • sv - Suédois
  • it - Italien
  • tr - Turc
  • zh-CN - Chinois (simplifié)
  • no - Norvégien
  • da - Danois
  • ru - Russe
  • ko - Coréen
  • ja - Japonais
  • pl - Polonais
  • fi - Finnois
L’anglais est la langue par défaut. Pour changer la langue de l’interface (par exemple en chinois simplifié), ajoutez la ligne suivante à config/variables.env :
config/variables.env
Appliquez ensuite la configuration :
Après le redémarrage des services, la langue des menus de l’interface web devrait refléter le nouveau paramètre.

Configuration multilingue

Pour permettre aux utilisateurs de changer de langue sans se déconnecter, votre instance Overleaf doit être configurée pour servir différentes langues selon le nom de domaine. Cette section suppose que :
  • Votre domaine principal est overleaftest.com
  • Vous disposez d’un certificat TLS wildcard (par ex. *.overleaftest.com)
  • Vous n’utilisez pas localhost (qui ne permet pas le routage des langues par sous-domaine)
Pour des tests en local, vous pouvez utiliser un domaine tel que dev-overleaf.com.
1

Configuration du proxy TLS (Nginx)

Votre reverse proxy TLS doit transmettre l’en-tête Host d’origine afin qu’Overleaf puisse déterminer à quel domaine de langue l’utilisateur a accédé.Assurez-vous que la directive suivante est présente :
Voici un exemple de configuration Nginx :
2

Configurer le domaine des cookies

Pour éviter que les utilisateurs soient déconnectés lorsqu’ils changent de langue, les cookies doivent être partagés entre les sous-domaines de langue.Ajoutez la ligne suivante à config/variables.env :
config/variables.env
Cela garantit que les cookies d’authentification sont valides pour tous les sous-domaines de overleaftest.com.
3

Correspondance langue–domaine

Définissez ensuite la correspondance entre codes de langue et sous-domaines à l’aide de
OVERLEAF_LANG_DOMAIN_MAPPING.

Exemple de configuration

config/variables.env
Avec cette configuration :
  • https://www.overleaftest.com → interface en anglais
  • https://cn.overleaftest.com → interface en chinois simplifié
Vous pouvez étendre cette correspondance avec d’autres langues et sous-domaines selon vos besoins.
Nous recommandons de servir le site principal sur www et de toujours inclure une clé www : définissez OVERLEAF_SITE_URL sur l’adresse www (par exemple https://www.overleaftest.com), faites pointer la clé www vers celle-ci et redirigez le domaine apex vers elle comme indiqué ci-dessous. La clé www correspond au site principal et peut utiliser n’importe quelle langue. Sans elle, l’entrée www par défaut est conservée, et le sélecteur de langue affiche un élément anglais supplémentaire qui pointe vers http://127.0.0.1:3000.
4

Rediriger le domaine apex

Enfin, redirigez le domaine apex (overleaftest.com) vers le domaine de la langue par défaut (www.overleaftest.com).

Questions/réponses

Réponse : Le bouton de langue (icône de traduction) se trouve dans le pied de page, par exemple en bas de la liste des projets. Il n’est pas affiché dans l’éditeur.Le bouton n’apparaît que lorsque OVERLEAF_LANG_DOMAIN_MAPPING associe au moins deux langues, comme décrit dans Configuration multilingue. Si seule OVERLEAF_SITE_LANGUAGE est définie, l’ensemble du site utilise cette unique langue et aucun bouton n’est affiché.Choisir une langue ouvre la même page sur le domaine de cette langue, par exemple cn.overleaftest.com. Ce choix n’est pas enregistré comme paramètre utilisateur.
Réponse : OVERLEAF_LANG_DOMAIN_MAPPING ne contient pas de clé www. La correspondance est fusionnée avec celle par défaut, qui contient une entrée www pour l’anglais avec l’adresse interne http://127.0.0.1:3000. Si votre correspondance utilise uniquement d’autres clés, comme cn et en, cette entrée par défaut est conservée et apparaît dans le sélecteur.Ajoutez une clé www avec l’adresse de OVERLEAF_SITE_URL, supprimez toute seconde entrée pour la même langue, puis exécutez bin/up -d :
Dernière modification le 2 novembre 2026