Skip to content

Add missing code-block #1364

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Aug 8, 2020
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 18 additions & 0 deletions CONTRIBUTING.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -133,13 +136,15 @@ compilation ne devrait pas échouer.

make


Vérifiez alors le rendu de la traduction « en vrai ». Lancez un serveur de
documentation local :

.. code-block:: bash

make serve


La documentation est publiée l'adresse `<http://localhost:8000/library/sys.html>`_
(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.
Expand Down Expand Up @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -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
Expand All @@ -329,6 +337,7 @@ en
resultat = thread.join(timeout=...)
...


mais pas en

.. code-block:: python
Expand All @@ -337,6 +346,7 @@ mais pas en
resultat = fildexécution.attendre(délai=...)
...


Liens hypertextes
+++++++++++++++++

Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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``.
Expand Down Expand Up @@ -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.

Expand Down Expand Up @@ -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
Expand All @@ -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
Expand Down Expand Up @@ -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