Configuration i18n d’Overleaf
Ce document explique comment configurer l’internationalisation (i18n) d’une instance Overleaf auto-hébergée.
- 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’environnementOVERLEAF_SITE_LANGUAGE.
Les codes de langue pris en charge incluent :
en- Anglais (par défaut)es- Espagnolpt- Portugaisde- Allemandfr- Françaiscs- Tchèquenl- Néerlandaissv- Suédoisit- Italientr- Turczh-CN- Chinois (simplifié)no- Norvégienda- Danoisru- Russeko- Coréenja- Japonaispl- Polonaisfi- Finnois
config/variables.env :
config/variables.env
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)
dev-overleaf.com.
1
Configuration du proxy TLS (Nginx)
Votre reverse proxy TLS doit transmettre l’en-tête Voici un exemple de configuration Nginx :
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 :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 à Cela garantit que les cookies d’authentification sont valides pour tous les sous-domaines de
config/variables.env :config/variables.env
overleaftest.com.3
Correspondance langue–domaine
Définissez ensuite la correspondance entre codes de langue et sous-domaines à l’aide de
Avec cette configuration :
OVERLEAF_LANG_DOMAIN_MAPPING.Exemple de configuration
config/variables.env
https://www.overleaftest.com→ interface en anglaishttps://cn.overleaftest.com→ interface en chinois simplifié
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
Où se trouve le bouton de changement de langue ?
Où se trouve le bouton de changement de langue ?
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.Pourquoi une langue du sélecteur ouvre-t-elle http://127.0.0.1:3000 ?
Pourquoi une langue du sélecteur ouvre-t-elle http://127.0.0.1:3000 ?
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 :
