From 8cff52670045ddea0fdda0cc3d0dbd2027264c06 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Thu, 4 Nov 2021 14:42:04 +0100 Subject: [PATCH 1/3] Make wrap to actually wrap, not just check. --- Makefile | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/Makefile b/Makefile index 7a5ad9e1e..af2ae6712 100644 --- a/Makefile +++ b/Makefile @@ -5,7 +5,7 @@ # - make # Automatically build an HTML local version # - make todo # To list remaining tasks and show current progression # - make verifs # To check for correctness: wrapping, spelling -# - make wrap # To check for wrapping +# - make wrap # To rewrap modified files # - make spell # To check for spelling # - make clean # To remove build artifacts # - make fuzzy # To find fuzzy strings @@ -106,8 +106,8 @@ todo: ensure_prerequisites .PHONY: wrap wrap: ensure_prerequisites - @echo "Verify wrapping" - powrap --check --quiet *.po **/*.po + @echo "Re wrapping modified files" + powrap -m SRCS = $(shell git diff --name-only $(BRANCH) | grep '.po$$') # foo/bar.po => $(POSPELL_TMP_DIR)/foo/bar.po.out @@ -126,7 +126,8 @@ fuzzy: ensure_prerequisites potodo -f --exclude venv .venv $(EXCLUDED) .PHONY: verifs -verifs: wrap spell +verifs: spell + powrap --check --quiet *.po */*.po .PHONY: clean clean: From dc274774fc82a28832ef2303254c8653f6e66956 Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Thu, 4 Nov 2021 15:09:11 +0100 Subject: [PATCH 2/3] make wrap now actually wraps. --- CONTRIBUTING.rst | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 9115ec0b7..ec2b818b0 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -152,18 +152,21 @@ en anglais. make spell -Vous pouvez aussi réindenter les fichiers avec : +Mais plus pratique, la commande ``verifs`` vérifie, en plus de +l'orthograhpe, la longueur des lignes du fichier (qui ne doit jamais +dépasser la 79ème colonne) : .. code-block:: bash - make wrap + make verifs -Et pour faire les deux à la fois, lancez : +Si la commande ``verifs`` trouve des problèmes de longueurs de ligne, +corrigez-les avec : .. code-block:: bash - make verifs + make wrap Une fois la traduction finie, il faut compiler la documentation, c'est-à-dire générer les fichiers HTML From 7caa2ad2b0207f5169252044bf7200b8aee07e7f Mon Sep 17 00:00:00 2001 From: Julien Palard Date: Thu, 4 Nov 2021 17:31:55 +0100 Subject: [PATCH 3/3] =?UTF-8?q?Tentative=20de=20raccourcir=20le=20CONTRIBU?= =?UTF-8?q?TING,=20il=20faut=20que=20=C3=A7a=20reste=20digeste.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- CONTRIBUTING.rst | 30 +++++++++--------------------- 1 file changed, 9 insertions(+), 21 deletions(-) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index ec2b818b0..2e53aad4c 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -141,33 +141,21 @@ Ou lancez simplement Poedit puis « Fichier » → « Ouvrir ». Traduction ~~~~~~~~~~ -Vous pouvez dès à présent commencer à traduire le fichier en respectant les `conventions`_ du projet. -Pour vous aider à ne pas faire de fautes d'orthographe, vous pouvez vérifier que tous les mots utilisés sont -bien dans le dictionnaire (ça ne vérifie pas la grammaire, pour cela utilisez `padpo (beta)`_). En cas -de doute, un `glossaire`_ répertorie déjà les traductions retenues pour certains termes techniques ou faux amis -en anglais. - -.. code-block:: bash - - make spell - - -Mais plus pratique, la commande ``verifs`` vérifie, en plus de -l'orthograhpe, la longueur des lignes du fichier (qui ne doit jamais -dépasser la 79ème colonne) : +Vous pouvez dès à présent commencer à traduire le fichier en +respectant les `conventions`_ du projet. Pour vous y aider, la commande : .. code-block:: bash make verifs +vérifie la longueur des lignes et l'orthographe (mais pas la +grammaire, pour cela utilisez `padpo (beta)`_). En cas de doute, un +`glossaire`_ répertorie déjà les traductions retenues pour certains +termes techniques ou faux amis en anglais. -Si la commande ``verifs`` trouve des problèmes de longueurs de ligne, -corrigez-les avec : - -.. code-block:: bash - - make wrap - +Si ``make verifs`` trouve des problèmes de longueurs de ligne, +vérifiez votre configuration ``poedit`` (Édition → Préférences → +Avancé → Passer à la ligne à 79) ou utilisez ``make wrap``. Une fois la traduction finie, il faut compiler la documentation, c'est-à-dire générer les fichiers HTML affichés par le site, pour les relire. Si la commande précédente s'est exécutée sans erreur, la