From 98454f3b6f0aa2d295eedf115993c72fe4f3c60c Mon Sep 17 00:00:00 2001 From: Vincent Poulailleau Date: Sat, 8 Aug 2020 13:26:03 +0200 Subject: [PATCH] Add missing `code-block` (#1364) Add missing `code-block` Homogenize the number of new lines after code blocks to 2 lines. --- CONTRIBUTING.rst | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index ede20459..37a787f1 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -113,18 +113,21 @@ en anglais. make spell + Vous pouvez aussi réindenter les fichiers avec : .. code-block:: bash make wrap + Et pour faire les deux à la fois, lancez : .. code-block:: bash make verifs + 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 compilation ne devrait pas échouer. @@ -133,6 +136,7 @@ compilation ne devrait pas échouer. make + Vérifiez alors le rendu de la traduction « en vrai ». Lancez un serveur de documentation local : @@ -140,6 +144,7 @@ documentation local : make serve + La documentation est publiée l'adresse ``_ (ou tout autre port indiqué par la sortie de la commande précédente). Vous pouvez recommencer les étapes de cette section autant de fois que nécessaire. @@ -169,6 +174,7 @@ attendant d'être propagées dans le dépôt local. git commit -m "Traduction de library/sys.po" # Ou un autre message plus inspiré :) + Poussez ensuite vos modifications sur votre *fork* Github avec ``git push``. Le ``-u`` n'est utile qu'une fois pour que votre client git se souvienne que cette branche est liée à votre *fork* Github (et donc que vos futurs ``git pull`` et @@ -178,6 +184,7 @@ branche est liée à votre *fork* Github (et donc que vos futurs ``git pull`` et git push -u origin + La commande précédente vous affiche un lien pour ouvrir une pull request sur Github. Si vous l'avez manqué, allez simplement sur https://github.com/python/python-docs-fr/pulls et un joli bouton « Compare & pull request » devrait apparaître au bout de @@ -321,6 +328,7 @@ utilisés, en prenant garde d'être cohérent. Vous pouvez ainsi traduire : result = thread.join(timeout=...) ... + en .. code-block:: python @@ -329,6 +337,7 @@ en resultat = thread.join(timeout=...) ... + mais pas en .. code-block:: python @@ -337,6 +346,7 @@ mais pas en resultat = fildexécution.attendre(délai=...) ... + Liens hypertextes +++++++++++++++++ @@ -538,6 +548,7 @@ Ensuite, dans votre fichier '~/.xsession', ajoutez : # Gestion des touches clavier xmodmap $HOME/.Xmodmap + Sous X, avec un bureau graphique, tel que Gnome, ou Xfce, il faut aller modifier dans les « Paramètres » → « Clavier » → « Disposition » → « Touche composée ». Pour finir, redémarrez votre session. @@ -674,6 +685,7 @@ de ligne, comme : -#: ../Doc/library/signal.rst:406 +#: ../Doc/library/signal.rst:408 + Pour dire à git que ce ne sont pas des informations utiles, vous pouvez faire ce qui suit après vous être assuré que ``~/.local/bin/`` se trouve dans votre ``PATH``. @@ -707,12 +719,14 @@ de ``python-docs-fr`` et certaines s'attendent à trouver un clone de CPython ├── python-docs-fr/ └── cpython/ + Pour cloner CPython, vous pouvez utiliser : .. code-block:: bash git clone --depth 1 --no-single-branch https://github.com/python/cpython.git + Ceci évite de télécharger tout l'historique (inutile pour générer la documentation) mais récupère néanmoins toutes les branches. @@ -745,6 +759,8 @@ Pour backporter "en gros" on utilise ``pomerge``\  : on le fait lire sur une branche, puis écrire sur une autre, par exemple pour copier de la 3.8 à la 3.7 :: +.. code-block:: bash + git fetch git checkout 3.8 git reset --hard upstream/3.8 @@ -756,6 +772,7 @@ la 3.8 à la 3.7 :: git commit --message="Backporting from 3.8" git push --set-upstream origin HEAD + Notes : - j'utilise ``git fetch`` au début pour avoir upstream/3.7 et @@ -813,3 +830,4 @@ Ensuite récupérez les changements depuis Transifex : git add -p git commit -m "tx pull" tx push -t -f --no-interactive --parallel +