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

Skip to content

Commit dad339d

Browse files
PhilippeGalvanPhilippeGalvan
committed
Merge branch '3.9' of https://github.com/python/python-docs-fr into library.logging.handlers.po
2 parents caef9e5 + c4a5b54 commit dad339d

File tree

264 files changed

+16057
-16934
lines changed

Some content is hidden

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

264 files changed

+16057
-16934
lines changed

‎.github/problem-matchers/pospell.json

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
{
2+
"problemMatcher": [
3+
{
4+
"owner": "pospell",
5+
"pattern": [
6+
{
7+
"regexp": "^(.*):(\\d+):(.*)$",
8+
"file": 1,
9+
"line": 2,
10+
"message": 3
11+
}
12+
]
13+
}
14+
]
15+
}

‎.github/stale.yml

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# Number of days of inactivity before an issue becomes stale
2+
daysUntilStale: 60
3+
# Number of days of inactivity before a stale issue is closed
4+
daysUntilClose: 14
5+
# Issues with these labels will never be considered stale
6+
exemptLabels:
7+
- meta
8+
- on hold
9+
- EASY
10+
# Label to use when marking an issue as stale
11+
staleLabel: stale
12+
# Comment to post when marking an issue as stale. Set to `false` to disable
13+
markComment: >
14+
Cette issue/pull request a été automatiquement marquée comme innactive car elle n'a pas eu d'activité récente.
15+
Elle sera fermée si il ne se passe rien dans les 14 jours qui viennent. Merci pour votre contribution
16+
17+
This issue/pull request has been automatically marked as stale because it has not had
18+
recent activity. It will be closed if no further activity occurs. Thank you
19+
for your contributions.
20+
# Comment to post when closing a stale issue. Set to `false` to disable
21+
closeComment: true
22+
23+
# Comment to post when removing the stale label.
24+
unmarkComment: >
25+
Cette issue n'est plus innactive !
26+
This issue isn't stale anymore!

‎.github/workflows/tests.yml

Lines changed: 85 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,85 @@
1+
---
2+
3+
name: Tests
4+
5+
on:
6+
push:
7+
branches:
8+
- '*.*'
9+
pull_request:
10+
branches:
11+
- '*.*'
12+
13+
jobs:
14+
pospell:
15+
name: 'Orthographe (pospell)'
16+
runs-on: ubuntu-latest
17+
steps:
18+
- uses: actions/checkout@v2
19+
- name: Register pospell problem matcher
20+
run: echo "::add-matcher::.github/problem-matchers/pospell.json"
21+
- name: Install pospell
22+
run: |
23+
sudo apt-get update
24+
sudo apt-get install -y hunspell hunspell-fr-comprehensive
25+
sudo python3 -m pip install pospell
26+
- name: Run pospell
27+
run: pospell -p dict -l fr_FR *.po */*.po
28+
29+
powrap:
30+
name: 'Longueur des lignes (powrap)'
31+
runs-on: ubuntu-latest
32+
steps:
33+
- uses: actions/checkout@v2
34+
- name: Install powrap
35+
run: |
36+
sudo apt-get update
37+
sudo apt-get install gettext
38+
sudo python3 -m pip install powrap
39+
- name: Run powrap
40+
run: powrap --check --quiet *.po */*.po
41+
42+
padpo:
43+
name: 'Grammaire (padpo)'
44+
runs-on: ubuntu-latest
45+
steps:
46+
- uses: actions/checkout@v2
47+
- uses: actions/setup-python@v2
48+
with:
49+
python-version: '3.9'
50+
- name: Install padpo
51+
run: |
52+
python3.9 -m venv .venv
53+
.venv/bin/python -m pip install --upgrade pip setuptools wheel
54+
.venv/bin/python -m pip install padpo
55+
- name: Run padpo
56+
run: PATH=$PATH:$PWD/.venv/bin/ padpo -i *.po */*.po 2>&1 | grep -v -Ff padpo.ignore
57+
58+
sphinx:
59+
name: 'Génération de la doc (sphinx)'
60+
runs-on: ubuntu-latest
61+
steps:
62+
- uses: actions/checkout@v2
63+
- uses: actions/cache@v2
64+
with:
65+
path: '~/cpython/'
66+
key: '1'
67+
- uses: actions/setup-python@v2
68+
with:
69+
python-version: '3.9'
70+
- name: Clone cpython
71+
run: |
72+
if [ ! -d ~/cpython ]; then
73+
git clone https://github.com/python/cpython ~/cpython/
74+
else
75+
git -C ~/cpython fetch
76+
fi
77+
- name: Prepare build hierarchy
78+
run: |
79+
mkdir -p ~/locales/fr/LC_MESSAGES/
80+
cp -uv --parents *.po */*.po ~/locales/fr/LC_MESSAGES/
81+
git -C ~/cpython checkout b30934e9afb0af3f8e2e5f0992445be775b3c630
82+
- name: Prepare venv
83+
run: make -C $HOME/cpython/Doc venv
84+
- name: sphinx-build
85+
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
@@ -4,3 +4,4 @@ venv/
44
.idea/
55
.DS_Store
66
.pospell/
7+
.potodo/

‎.potodoignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
venv/

‎.travis.yml

Lines changed: 0 additions & 20 deletions
This file was deleted.

‎CONTRIBUTING-CORE.rst

Lines changed: 87 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,87 @@
1+
Maintenance
2+
-----------
3+
4+
Les commandes suivantes doivent être exécutées à partir de la racine d'un clone
5+
de ``python-docs-fr`` et certaines s'attendent à trouver un clone de CPython
6+
à jour à proximité :
7+
8+
.. code-block:: bash
9+
10+
~/
11+
├── python-docs-fr/
12+
└── cpython/
13+
14+
15+
Pour cloner CPython, vous pouvez utiliser :
16+
17+
.. code-block:: bash
18+
19+
git clone --depth 1 --no-single-branch https://github.com/python/cpython.git
20+
21+
22+
Ceci évite de télécharger tout l'historique (inutile pour générer la
23+
documentation) mais récupère néanmoins toutes les branches.
24+
25+
.. code-block:: bash
26+
27+
make merge
28+
29+
Dans certains cas on a besoin de propager des traductions d'une branche
30+
à l'autre :
31+
32+
- d'une ancienne branche vers une nouvelle branche : lors du passage
33+
d'une version à l'autre de CPython, lorsque quelqu'un a une PR sur une
34+
ancienne version (*forward porting*) ;
35+
- d'une nouvelle branche vers des anciennes branches : pour propager
36+
de temps en temps le travail sur d'anciennes versions (rétroportage
37+
ou *backporting*).
38+
39+
Pour forward-porter un ou plusieurs commits, il vaut mieux utiliser ``git
40+
cherry-pick -x LE_SHA``, ça garde l'auteur, le sha1 d'origine, et
41+
toutes les modifications.
42+
43+
Pour rétroporter « en gros » on utilise ``pomerge``\ : on le fait lire
44+
sur une branche, puis écrire sur une autre, par exemple pour copier de
45+
la 3.8 à la 3.7 :
46+
47+
.. code-block:: bash
48+
49+
git fetch
50+
git checkout 3.8
51+
git reset --hard upstream/3.8
52+
pomerge --from-files *.po */*.po
53+
git checkout --branch back-porting upstream/3.7
54+
pomerge --no-overwrite --to-files *.po */*.po
55+
powrap --modified
56+
git add --patch
57+
git commit --message="Backporting from 3.8"
58+
git push --set-upstream origin HEAD
59+
60+
61+
Notes :
62+
63+
- j'utilise ``git fetch`` au début pour avoir *upstream/3.7* et
64+
*upstream/3.8* à jour localement, ainsi je peux travailler sans
65+
toucher au réseau jusqu'au ``git push``, mais chacun fait comme il
66+
veut ;
67+
- j'utilise ``*.po */*.po`` et pas ``**/*.po``, car si vous avez un
68+
*venv* dans l'arborescence il va vous trouver des traductions de Sphinx
69+
et peut-être d'autres paquets dans ``.venv/lib/python*/`` (et mettre
70+
beaucoup plus de temps) ;
71+
- j'utilise ``pomerge --no-overwrite``, ça indique à ``pomerge`` de
72+
n'écrire que si le ``msgstr`` est vide, donc de ne pas modifier
73+
l'existant, ainsi il est impossible de casser quelque chose.
74+
On peut le tenter sans ``--no-overwrite``, attention, ça fait
75+
des bêtises, ça nécessite une relecture attentive :
76+
certaines traductions, comme *example:* sont en parfois traduites en
77+
français avec une majuscule, et parfois non, en
78+
fonction du contexte, ``pomerge`` uniformiserait ça, ce n'est pas bien ;
79+
- attention, si vous testez sans ``--no-overwrite``, il est peut-être
80+
bon de vider la mémoire de ``pomerge`` avant la lecture, pour éviter
81+
de lui faire écrire des choses lues lors des sessions précédentes,
82+
via un ``rm -f ~/.pomerge.json``\ ;
83+
- j'utilise ``git add --patch`` (ou ``-p``) car j'aime bien relire quand même,
84+
en général, je n'ajoute pas les différences d'ordre dans les entêtes,
85+
mais un ``git add --update`` irait très bien ;
86+
- attention au fichier *dict* auquel il peut manquer des lignes.
87+

0 commit comments

Comments
 (0)