Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 94fd076

Browse files
CatadannaCatadanna
authored
Merge branch '3.9' into extending-extending
2 parents e9043fb + b4ab6e1 commit 94fd076

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

106 files changed

+50848
-6331
lines changed

‎.github/workflows/tests.yml

Lines changed: 17 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -18,15 +18,14 @@ jobs:
1818
- name: Orthographe
1919
package: pospell
2020
apt_dependencies: hunspell hunspell-fr-comprehensive
21-
command: pospell -p dict -l fr_FR
21+
command: 'pospell -p dict -l fr_FR $CHANGED_PO_FILES'
2222
- name: Longueur des lignes
2323
package: powrap
2424
apt_dependencies: gettext
25-
command: powrap --check --quiet --diff
25+
command: 'powrap --check --quiet --diff $CHANGED_PO_FILES'
2626
- name: Grammaire
2727
package: padpo
28-
command: 'padpo -i 2>&1'
29-
command_suffix: '| grep -v -Ff padpo.ignore'
28+
command: 'padpo -i $CHANGED_PO_FILES 2>&1 | grep -v -Ff padpo.ignore'
3029

3130
name: ${{ matrix.tool.name }} (${{ matrix.tool.package }})
3231
runs-on: ubuntu-latest
@@ -51,9 +50,14 @@ jobs:
5150
ADDED_FILES: ${{ join(fromJSON(steps.changed_files.outputs.added), ' ') }}
5251
MODIFIED_FILES: ${{ join(fromJSON(steps.changed_files.outputs.modified), ' ') }}
5352
run: |
54-
CHANGED_PO_FILES=$(printf "%s %s\n" "$ADDED_FILES" "$MODIFIED_FILES" | tr ' ' '\n' | grep '.po$')
55-
echo "Running on:" $CHANGED_PO_FILES
56-
[ -n "$CHANGED_PO_FILES" ] && ${{ matrix.tool.command }} $CHANGED_PO_FILES ${{ matrix.tool.command_suffix }}
53+
CHANGED_PO_FILES=$(printf "%s %s\n" "$ADDED_FILES" "$MODIFIED_FILES" | tr ' ' '\n' | grep '.po$'; true)
54+
if [ -n "$CHANGED_PO_FILES" ]
55+
then
56+
echo "Running on:" $CHANGED_PO_FILES
57+
${{ matrix.tool.command }}
58+
else
59+
echo "No changed po files, nothing to check."
60+
fi
5761
5862
sphinx:
5963
name: 'Génération de la doc (sphinx)'
@@ -79,8 +83,12 @@ jobs:
7983
run: |
8084
mkdir -p ~/locales/fr/LC_MESSAGES/
8185
cp -uv --parents *.po */*.po ~/locales/fr/LC_MESSAGES/
82-
git -C ~/cpython checkout b30934e9afb0af3f8e2e5f0992445be775b3c630
86+
git -C ~/cpython checkout 895591c1f0bdec5ad357fe6a5fd0875990061357
8387
- name: Prepare venv
84-
run: make -C $HOME/cpython/Doc venv
88+
run: |
89+
# If the venv exists but is broken, drop it (happens on Python upgrades):
90+
# see https://github.com/actions/setup-python/issues/170
91+
[ -d $HOME/cpython/Doc/venv/bin/ -a ! -e $HOME/cpython/Doc/venv/bin/python ] && rm -fr $HOME/cpython/Doc/venv
92+
make -C $HOME/cpython/Doc venv
8593
- name: sphinx-build
8694
run: make -C $HOME/cpython/Doc SPHINXOPTS="-qW -j4 -D locale_dirs=$HOME/locales -D language=fr -D gettext_compact=0" autobuild-dev-html

‎.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,3 +5,4 @@ venv/
55
.DS_Store
66
.pospell/
77
.potodo/
8+
locales/

‎CONTRIBUTING.rst

Lines changed: 87 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,15 @@ Instructions
77
Prérequis
88
~~~~~~~~~
99

10-
- un compte `Github <https://github.com/join>`_ ;
11-
- un client ``git`` `Linux <https://git-scm.com/>`_ ou `Windows <https://gitforwindows.org/>`_ ;
10+
- un client ``git`` `Linux <https://git-scm.com/>`_, `MacOS <https://git-scm.com/>`_ ou `Windows <https://gitforwindows.org/>`_ ;
1211
- un éditeur de fichier ``.po`` (comme `Poedit <https://poedit.net/>`_).
1312

1413
Équipez-vous aussi de quelques outils pour vous aider dans
1514
votre traduction (voir `Outils utiles pour la traduction`_).
1615

1716

18-
*fork* personnel
19-
~~~~~~~~~~~~~~~~
17+
*fork* personnel sur Github
18+
~~~~~~~~~~~~~~~~~~~~~~~~~~~
2019

2120
Pour commencer vous aurez besoin de *forker* le dépôt des sources `python-docs-fr
2221
<https://github.com/python/python-docs-fr>`_ en cliquant sur son bouton
@@ -41,47 +40,84 @@ où vous avez le droit de faire des modifications.
4140
git remote add upstream https://github.com/python/python-docs-fr.git
4241
4342
43+
*fork* personnel sur une autre forge
44+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
45+
46+
Si vous n'avez pas de compte Github, il est possible *fork* ce dépôt sur une autre forge.
47+
Vous devez dans un premier temps initier un dépôt vide sur la forge où vous voulez héberger le
48+
dépôt.
49+
50+
.. code-block:: bash
51+
52+
# Clonez en HTTPS le dépôt
53+
git clone https://github.com/python/python-docs-fr
54+
55+
# Allez dans le répertoire cloné
56+
cd python-docs-fr/
57+
58+
# Renommez *origin* en *upstream* pour avoir une référence vers le dépôt officiel
59+
# Il permettra de récupérer les nouveaux commits
60+
git remote rename origin upstream
61+
62+
# Rajoutez le *remote* de votre forge (en HTTPS ou SSH)
63+
git remote add origin <url>
64+
65+
# Envoyez le dépôt sur votre forge et définir par défaut
66+
git push -u origin
67+
68+
4469
Réservation d'un fichier
4570
~~~~~~~~~~~~~~~~~~~~~~~~
4671

72+
*Chaque fois que vous commencez un nouveau fichier, suivez cette procédure.*
73+
4774
Ensuite, vous devez trouver un fichier sur lequel travailler
4875
(pour vous aiguiller, lisez la section `Que traduire ?`_). Nous vous conseillons
4976
de choisir, si possible, un fichier traitant d'un sujet que vous maitrisez, cela
5077
vous aidera grandement à produire une traduction de bonne qualité.
5178

5279
Si c'est votre première contribution, commencez par une toute petite
53-
PR, de quelques paragraphes maximum, pour vous familiariser. Il n'est
80+
traduction, de quelques paragraphes maximum, pour vous familiariser. Il n'est
5481
pas nécessaire de terminer un fichier lorsqu'on le commence, vous
5582
pouvez donc prendre n'importe quel fichier, mais ne traduire que
5683
quelques paragraphes.
5784

58-
Une fois que vous avez choisi un fichier sur lequel travailler, veuillez
59-
ouvrir un `ticket sur Github <https://github.com/python/python-docs-fr/issues>`_
60-
en indiquant dans le titre ``Je travaille sur DOSSIER/FICHIER.po``
61-
(par exemple « Je travaille sur library/sys.po »).
85+
Une fois que vous avez choisi un fichier sur lequel travailler vous pouvez nous
86+
le signaler par différents moyens :
87+
88+
* Soit en ouvrant un `ticket sur Github <https://github.com/python/python-docs-fr/issues>`_
89+
en indiquant dans le titre ``Je travaille sur DOSSIER/FICHIER.po``
90+
(par exemple « Je travaille sur library/sys.po »).
91+
6292
Ceci permet à `potodo`_ de détecter via l'API Github les fichiers ``.po`` réservés
6393
dans les tickets et les *pull requests*.
6494

95+
* Soit en créant un sujet sur le
96+
`discuss de l'AFPy <https://discuss.afpy.org/>`_ dans la section Traduction
97+
en indiquant sur quoi vous travaillez et l'URL de votre dépôt.
98+
99+
* Soit sur IRC en venant sur le canal `#python-docs-fr <https://webchat.freenode.net/#python-docs-fr>`_ pour nous le signaler.
100+
65101
Vous êtes maintenant prêt. Chaque fois que vous commencerez un nouveau fichier,
66102
suivez cette procédure :
67103

68-
Pour travailler, nous aurons besoin d'une branche, basée sur une version à jour
69-
(fraîchement récupérée) de la branche upstream/3.9. On met donc à jour notre
104+
Pour travailler, nous avons besoin d'une branche, basée sur une version à jour
105+
(fraîchement récupérée) de la branche « upstream/3.9 ». On met donc à jour notre
70106
version locale.
71107

72108
.. code-block:: bash
73109
74110
git fetch upstream
75111
76112
77-
On crée ensuite une branche. Il est pratique de nommer la branche en fonction du
113+
On crée ensuite la branche, en la basant sur « upstream/3.9 », fraîchement récupérée.
114+
Il est pratique de nommer cette branche en fonction du
78115
fichier sur lequel on travaille. Par exemple, si vous travaillez sur
79116
« library/sys.po », vous pouvez nommer votre branche « library-sys ».
80-
Cette nouvelle branche nommée « library-sys » est basée sur « upstream/3.9 ».
81117

82118
.. code-block:: bash
83119
84-
git checkout --branch library-sys upstream/3.9
120+
git checkout -b library-sys upstream/3.9
85121
86122
87123
Vous pouvez maintenant travailler sur le fichier.
@@ -176,16 +212,17 @@ attendant d'être propagées dans le dépôt local.
176212
177213
178214
179-
Poussez ensuite vos modifications sur votre *fork* Github avec ``git push``.
215+
Poussez ensuite vos modifications sur votre *fork* avec ``git push``.
180216
Le ``-u`` n'est utile qu'une fois pour que votre client git se souvienne que cette
181-
branche est liée à votre *fork* Github (et donc que vos futurs ``git pull`` et
217+
branche est liée à votre *fork* (et donc que vos futurs ``git pull`` et
182218
``git push`` sachent quoi tirer).
183219

184220
.. code-block:: bash
185221
186222
git push --set-upstream origin
187223
188-
224+
Sur Github
225+
++++++++++
189226

190227
La commande précédente vous affiche un lien pour ouvrir une *pull request* sur
191228
Github. Si vous l'avez manqué, allez simplement sur https://github.com/python/python-docs-fr/pulls
@@ -196,6 +233,26 @@ Mettez dans le commentaire de la *pull request* le texte suivant :
196233
« Closes #XXXX » où XXXX est le numéro du ticket GitHub créé pour réserver le fichier traduit.
197234
Cela permet à Github de lier la *pull request* au ticket de réservation.
198235

236+
237+
Sur une autre forge
238+
+++++++++++++++++++
239+
240+
Quand vous avez poussé vos modifications, il y a plusieurs possibilités.
241+
242+
Soit vous signalez via le `discuss de l'AFPy <https://discuss.afpy.org/>`_ ou sur IRC que
243+
vous avez traduit une section. Nous viendrons récupérer les modifications pour les intégrer
244+
sur Github.
245+
246+
Soit en créant un *`bundle <https://git-scm.com/book/fr/v2/Utilitaires-Git-Empaquetage-bundling>`_* Git,
247+
pour cela, il faut créer un fichier contenant les différentes modifications effectuées.
248+
249+
.. code-block:: bash
250+
251+
git bundle create <name>.bundle <commit_id1>..<commit_id2>
252+
253+
Puis nous partager ce *bundle* sur le `discuss de l'AFPy <https://discuss.afpy.org/>`_ pour pouvoir l'intégrer.
254+
255+
199256
À partir de là, quelqu'un passera en revue vos modifications, et vous fera des
200257
suggestions et corrections. Pour les prendre en compte, retournez sur votre branche
201258
contenant le fichier concerné (au cas où vous auriez commencé quelque chose d'autre
@@ -234,6 +291,7 @@ Si nécessaire, les traductions seraient rétroportées sur les versions
234291
les plus anciennes par l'`équipe de documentation
235292
<https://www.python.org/dev/peps/pep-8015/#documentation-team>`_.
236293

294+
237295
Que traduire ?
238296
--------------
239297

@@ -445,28 +503,28 @@ parameter paramètre
445503
pickle (v.) sérialiser
446504
prompt invite
447505
raise lever
448-
roughly approximativement, à peu près (on ne traduit pas
449-
« roughly equivalent » par « sensiblement équivalent »)
450506
regular expression expression rationnelle, expression régulière
451507
return renvoie, donne (on évite « retourne » qui
452508
pourrait porter à confusion)
509+
roughly approximativement, à peu près (on ne traduit pas
510+
« roughly equivalent » par « sensiblement équivalent »)
453511
setter mutateur
454512
simple quote guillemet simple
455513
socket connecteur ou interface de connexion
514+
specify définir, préciser (plutôt que « spécifier »)
456515
statement instruction
457516
subprocess sous-processus
458517
support prendre en charge, implémenter (« supporter »
459518
n'a pas le même sens en français)
460-
specify définir, préciser (plutôt que « spécifier »)
461-
typically normalement, habituellement, comme d'habitude
462-
(plutôt que « typiquement »)
463519
thread fil d'exécution
464520
traceback trace d'appels, trace de pile
465521
tuple *n*-uplet (avec *n* en italique), on peut
466522
traduire *2-tuple* par « paire » ou « couple »,
467523
*3-tuple* par « triplet », *4-tuple* par
468524
« quadruplet » etc.
469-
underscore tiret bas, *underscore*
525+
typically normalement, habituellement, comme d'habitude
526+
(plutôt que « typiquement »)
527+
underscore tiret bas, *underscore*, sous-tiret
470528
whitespace caractère d'espacement
471529
========================== ===============================================
472530

@@ -684,19 +742,19 @@ Powrap
684742
| `Lien vers le dépôt <https://github.com/JulienPalard/powrap>`__
685743
686744

687-
Simplification des diffs git
688-
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
745+
Affichage des modifications par Git
746+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
689747

690-
Les diffs git sont souvent encombrés de changements inutiles de numéros
748+
Le résultat de ``git diff`` est souvent encombré de changements inutiles de numéros
691749
de ligne, comme :
692750

693751
.. code-block:: diff
694752
695-
-#: ../Doc/library/signal.rst:406
696-
+#: ../Doc/library/signal.rst:408
753+
-#: ../Doc/library/sys.rst:406
754+
+#: ../Doc/library/sys.rst:408
697755
698756
699-
Pour dire à git que ce ne sont pas des informations utiles, vous pouvez faire
757+
Pour dire à Git que ce ne sont pas des informations utiles, vous pouvez faire
700758
ce qui suit après vous être assuré que ``~/.local/bin/`` se trouve dans votre
701759
``PATH``.
702760

0 commit comments

Comments
 (0)