Weblate - Outil de traduction collaboratif

Ceci est une ancienne révision du document !

~~CLOSETOC~~

Weblate (pour "Web" et "Translate") est une plateforme de gestion d'outils de traduction en mode collaboratif permettant la traduction de documents de multiples formats et sur différents outils orientés Web.

Référence : Weblate

<note warning>Cette procédure nécessite des droits root. Faîtes donc attention à ce que vous faîtes.</note>

<note>Cette procédure a été réalisé sur une débian 9.8</note>

Weblate préconise une installation en mode Docker sur une machine disposant à cet effet de :

2 Go de RAM
2 coeurs niveau CPU
1 GO d'espace libre

On commencera par installer les paquets nécessaires pour démarrer l'installation :

apt-get update
apt-get -y install apt-transport-https ca-certificates curl software-properties-common gnupg2 git
curl -fsSL https://download.docker.com/linux/debian/gpg | apt-key add -
add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/debian $(lsb_release -cs) stable"
apt-get update
apt-get -y install docker-ce docker-compose

<note important>Attention à la ligne 4. L'architecture, symbolisée par [arch=amd64], peut varier selon votre environnement.</note>

On commence par cloner le dépôt GIT en local :

mkdir -p /usr/local/git/
cd /usr/local/git/
git clone https://github.com/WeblateOrg/docker-compose.git weblate-docker
cd weblate-docker

Un fois dans le dépôt local, on va créer un fichier de configuration personnalisé :

 nano ./docker-compose.override.yml

Dans ce fichier, de type YAML, on va y ajouter les informations personnalisées suivantes :
- ports : indique en premier le port d'écoute sur l'hôte et en second, le port d'écoute traduit dans le conteneur. Généralement, on indiquera une première ligne pour le protocole HTTP et une seconde pour le protocole HTTPS.
- WEBLATE_EMAIL_HOST : indique le serveur SMTP pour les notifications de weblate.
- WEBLATE_EMAIL_HOST_USER : en cas d'authentification nécessaire pour l'utilisation du serveur SMTP, indique le nom à utiliser.
- WEBLATE_EMAIL_HOST_PASSWORD : en cas d'authentification nécessaire pour l'utilisation du serveur SMTP, indique le mot de passe à utiliser.
- WEBLATE_SERVER_EMAIL : indique l'adresse mail à utiliser en tant que destinataire des notifications.
- WEBLATE_DEFAULT_FROM_EMAIL : indique l'adresse mail à utiliser en tant qu'expéditeur des notifications.
- WEBLATE_ALLOWED_HOSTS : indique les hôtes autorisés à se connecter à weblate. On y indiquera généralement l'url correspondant au service web et pour des besoins de debug, le localhost.
- WEBLATE_ADMIN_PASSWORD : indique le mot de passe de l'administrateur de weblate. Si cette directive est absente, un mot de passe créée automatiquement par le système sera utilisé et affiché durant l'installation.
- WEBLATE_ADMIN_EMAIL : indique l'adresse mail de l'administrateur.
- WEBLATE_REQUIRE_LOGIN : définie à 1, cette directive permet de forcer les utilisateurs à se connecter et interdit la navigation anonyme.
Cela donne un fichier de ce style :

version: '2'
services:
  weblate:
    ports:
      - 80:8080
      - 443:4443
    environment:
      WEBLATE_EMAIL_HOST: smtp.shyrkasystem.com
      WEBLATE_EMAIL_HOST_USER: user
      WEBLATE_EMAIL_HOST_PASSWORD: password
      WEBLATE_SERVER_EMAIL: weblate@shyrkasystem.com
      WEBLATE_DEFAULT_FROM_EMAIL: weblate@shyrkasystem.com
      WEBLATE_ALLOWED_HOSTS: weblate.shyrkasystem.com,localhost
      WEBLATE_ADMIN_PASSWORD: Azerty123
      WEBLATE_ADMIN_EMAIL: weblate.admin@shyrkasystem.com
      WEBLATE_REQUIRE_LOGIN: 1

Pour pouvoir utiliser le protocole HTTPS, il faut disposer d'un certificat. Pour l'exemple, j'ai utilisé un certificat auto-signé.
- Référence : Créer un certificat auto-signé
- Référence : Convertir un certificat CRT et PEM
On crée dans le volume du docker (pour moi, il se trouve dans /var/lib/docker/volumes/weblatedocker_weblate-data/_data/ mais cela peut varier selon les systèmes), un dossier ssl
On copie dans ce dossier, le certificat sous le nom fullchain.pem et la clé privée correspondante sous le nom privkey.key.

<note important>Vérifier bien, après votre copie, que les fichiers ont bien les mêmes propriétaires et groupes que les autres fichiers du volumes, sinon nginx ne démarrera pas. </note>

Il nous reste plus qu'à lancer le déploiement de weblate via la commande :

docker-compose up

Le système va désormais télécharger les composant de weblate et monter le conteneur.
Une fois terminée, le site est accessible via l'url indiqué dans WEBLATE_ALLOWED_HOSTS. Cette url devra bien sûr avoir été préalablement renseignée dans le DNS ou le fichier hosts.