Différences

Ci-dessous, les différences entre deux révisions de la page.

--- fr:weblate [2020/05/20 10:35] – Ajout de la spécificité de Jukni3 Tycho Brahe
+++ fr:weblate [2021/12/03 18:19] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 41: / Ligne 41: @@
 <code>pipenv --three install Weblate psycopg2-binary</code>
-<WRAP center round tip>L'option ''--three'' n'est à préciser que si l'environnement virtuel n'a pas encore été créé.</WRAP>
+<WRAP center round tip>L'option ''<nowiki>--three</nowiki>'' n'est à préciser que si l'environnement virtuel n'a pas encore été créé.</WRAP>
 Cette commande créé deux fichiers, ''Pipfile'' et ''Pipfile.lock''. Notez que la version de python est inscrite dans Pipfile et qu'il est possible de l'enlever afin de simplifier les mises à jour futures de Python.
@@ Ligne 59: / Ligne 59: @@
 <code>cp weblate-src/settings_example.py settings.py
-export WEBLATE_ROOT="$(pwd)"
+ln -s "$(pwd)/settings.py" weblate-src/settings.py</code>
-cd weblate-src && ln -s "$WEBLATE_ROOT/settings.py" && cd "$WEBLATE_ROOT"</code>
 Nous avons donc maintenant le fichier ''settings.py'' servant à configurer Weblate. Dans l'environnement virtuel, un lien symbolique pointe dessus. Nous pouvons désormais configurer Weblate en modifiant les options à notre guise, en particulier les suivantes :
@@ Ligne 70: / Ligne 69: @@
   * La liste [[https://docs.djangoproject.com/fr/3.0/ref/settings/#admins|ADMINS]] doit contenir ''("Khaganat", "contact@khaganat.net"),'' (ce n'est pas un compte utilisateur !)
   * ''DATA_DIR'' doit etre mis à ''"/home/khaganat/weblate/data"''
-  * [[https://docs.djangoproject.com/fr/3.0/ref/settings/#default-from-email|DEFAULT_FROM_EMAIL]] doit etre mis à ''weblate@khaganat.net'' ou similaire
+  * [[https://docs.djangoproject.com/fr/3.0/ref/settings/#default-from-email|DEFAULT_FROM_EMAIL]] et [[https://docs.djangoproject.com/fr/3.0/ref/settings/#server-email|SERVER_EMAIL]] doit etre mis à ''weblate@khaganat.net'' ou similaire
+  * Toujours pour les emails, il peut être utile de spécifier [[https://docs.djangoproject.com/fr/3.0/ref/settings/#email-host|EMAIL_HOST]] et les variables qui suivent.
+Pour connaître l'ensemble des directives de configuration qu'il est possible de définir, rendez-vous dans [[https://docs.djangoproject.com/fr/3.0/ref/settings/|la documentation de Django]] ainsi que dans [[https://docs.weblate.org/en/latest/admin/config.html|celle de Weblate]].
@@ Ligne 97: / Ligne 99: @@
 <code>pipenv run weblate createadmin</code>
+<WRAP center round tip>Il se peut que le compte administratrice existe déjà. Dans ce cas, l'identifiant est ''admin'' et vous pouvez changer le mot de passe avec la commande suivante :
+<code>pipenv run weblate createadmin --update</code></WRAP>
 ==== uWsgi ====
@@ Ligne 184: / Ligne 189: @@
 <code>systemctl restart nginx.service</code>
+===== Mise à jour =====
+<WRAP center round alert>Ceci est une procédure théorique qui n'a jamais été utilisée en conditions réelles. Il sera donc nécessaire de la confirmer ou de la corriger après sa première utilisation.</WRAP>
+En cas de mise à jour de Weblate et/ou de Python, il faut l'appliquer sur l'environnement virtuel. Une mise à jour de Python rendant généralement ce dernier inutilisable en l'état, la méthode Léodagan est alors recommandée : tout cramer pour repartir sur des bases saines. C'est pour cela que, lors de l'installation, nous avons bien fait attention à différencier :
+  * l'environnement virtuel considéré comme jetable
+  * la configuration qui est dans un dossier spécifique
+  * les fichiers statiques qui sont également dans un dossier spécifique
+Et je n'ose pas préciser la base de données qui est, comme tout le monde le sait, un élément totalement à part avec son propre logiciel.
+Bref, commençons par arreter uWsgi :
+<code>systemctl stop uwsgi-socket@weblate.service</code>
+Ensuite, la mise à jour « virile » du virtualenv :
+<code>pipenv --rm
+pipenv --three install</code>
+<WRAP center round important>Si l'environnement virtuel est partagé avec d'autres services, comme par exemple par erreur sur Jukni3, et que Python n'a pas été mis à jour, on se contentera de faire un ''pipenv update'' au lieux de supprimer et recréer le virtualenv.</WRAP>
+Comme vu lors de l'installation, il nous faut recréer quelques liens symboliques. Là encore, on détruit pour reconstruire :
+<code>rm -f weblate-venv weblate-src
+ln -s "$(pipenv --venv)" weblate-venv
+ln -s "$(pipenv --venv)/lib/$(pipenv run python -c 'import sys; print(f"python{sys.version_info.major}.{sys.version_info.minor}")')/site-packages/weblate" weblate-src
+ln -s "$(pwd)/settings.py" weblate-src/settings.py</code>
+Maintenant que la mise à jour est effectuée, nous pouvons relancer uWsgi :
+<code>systemctl start uwsgi-socket@weblate.service</code>
+===== Lien avec GitLab =====
+<WRAP center round alert>Cette section est une ébauche en cours de réalisation. Le lien avec le [[https://git.khaganat.net/|GitLab]] n'est pas encore actif.</WRAP>
+Afin de permettre à Weblate de communiquer avec notre gitlab, il faut tout d'abord installer un programme externe : [[https://github.com/zaquestion/lab/|lab]]. Ce paquet devrait arriver prochainement sur Debian sous le nom de [[https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=898246|git-lab]].
+Une fois lab installé, il faut créer la configuration dédiée dans le dossier des fichiers statiques. La [[https://docs.weblate.org/en/latest/vcs.html#setting-up-lab|documentation de Weblate]] détaille la base de cette procédure. Il devrait y avoir une option pour spécifier une instance de GitLab autre que l'instance officielle.
+Il ne reste plus qu'à actualiser la valeur de ''GITLAB_USERNAME'' dans la configuration de Weblate (''settings.py'').
 {{tag>Serveur Web}}