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.
- 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.
Cela donne un fichier de ce style :

version: '2'
services:
  weblate:
    ports:
      - 80:8080
    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