On crée ensuite une branche. Il est pratique de nommer la branche en fonction du

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.

Vous pouvez aussi réindenter les fichiers avec :

.. code-block:: bash

Et pour faire les deux à la fois, lancez :

Poedit donne beaucoup d'avertissements, par exemple pour vous informer que

« la traduction devrait commencer par une majuscule » car c'est le cas pour

la source. Ces avertissements ne sont pas tous fondés. En cas de doute,

*affichez et relisez la page HTML produite* avec ``make serve``.

Une fois que le *make verifs* ne lève pas d'erreur et que vous êtes certains de bien respecter les

`Conventions`_ de traduction, vient le moment d'envoyer votre travail sur le dépôt local.

``git add`` place nos modifications dans l'index de Git en

``git commit`` permet de les propager :

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

``git push`` sachent quoi tirer).

Mettez dans le commentaire de la *pull request* le texte suivant :

Cela permet à Github de lier la *pull request* au ticket de réservation.

contenant le fichier concerné (au cas où vous auriez commencé quelque chose d'autre

sur une autre branche) :

branche de version (3.8, 3.9, etc.), seulement récupéré les

Vous pouvez utiliser `potodo`_, un outil fait pour trouver des fichiers *po*

- *c-api/* car c'est une partie très technique ;

- *whatsnew/* car les anciennes versions de Python sont pour la plupart obsolètes et leurs journaux de modifications ne sont pas les pages les plus consultées ;

- *distutils/* et *install/* car ces pages seront bientôt obsolètes.

de ``make fuzzy``). Une entrée *fuzzy* correspond à une entrée déjà traduite

Certaines conventions ont été édictées pour homogénéiser la traduction.

Il faut suivre les règles de `style`_ imposées, les `règles rst`_ et

les traductions déjà définies dans le `glossaire`_.

Style

Une bonne traduction est une traduction qui transcrit fidèlement l'idée originelle

en français, sans rien ajouter ni enlever au fond, tout en restant claire, concise et

agréable à lire. Les traductions mot-à-mot sont à proscrire et il est permis — même

conseillé — d'intervertir des propositions ou de réarranger des phrases de la

documentation anglaise, si le rythme l'exige. Il faut aussi chercher des

équivalents français aux termes techniques et aux idiotismes rencontrés, et prendre

garde aux anglicismes.

Utilisation du futur

Dans la description du comportement de Python (au sens large, c'est-à-dire

l'interpréteur lui-même mais aussi toutes les bibliothèques), la version

originale utilise souvent le futur : « if you do this, it will produce

that… ». En français, l'utilisation du présent convient tout à fait et le

présent est souvent plus facile à lire : « si vous faites ceci, il se

produit cela… ». On ne conserve le futur que si la seconde proposition

se situe réellement dans le futur (par exemple, on peut penser qu'un

processus de compilation n'est pas immédiat) ou pour des raisons de

concordance des temps.

Utilisation du conditionnel

La version originale est très polie envers le lecteur ; elle lui intime

rarement des obligations, préférant employer « you should ». Cependant, en

français, il est d'usage d'être plus direct pour être correctement compris :

« vous devez ». *Vous devriez* est en effet généralement compris comme quelque

chose dont l'on peut de temps en temps se passer, alors que c'est très

rarement le cas pour les « you should » de cette documentation.

De la même manière, « can » est souvent mieux traduit sans introduire de notion

de possibilité, en particulier quand la phrase est à la voix passive ; la

phrase « these objects can be accessed by… » se traduit mieux par « on accède à

ces objets en… ».

Utilisation du masculin

Dans un souci de lisibilité et en accord avec la préconisation de

l'Académie française, nous utilisons le masculin pour indiquer un

genre neutre. Par exemple : l'utilisateur ou le lecteur.

Règles rst

un concept ou une primitive défini dans le `glossaire Python <https://docs.python.org/fr/3/glossary.html>`_.

Ressources de traduction

- les canaux IRC sur freenode :

- `#python-docs-fr <http://irc.lc/freenode/python-docs-fr>`_ — communauté python autour de la documentation française,

- `#python-fr <http://irc.lc/freenode/python-fr>`_ — communauté python francophone,

- `#python-doc <http://irc.lc/freenode/python-fr>`_ — communauté python autour de la documentation anglophone ;

- les listes de diffusion relatives à la documentation (courriel) :

- `de l'AFPy <http://lists.afpy.org/mailman/listinfo/traductions>`_,

- `de cpython <https://mail.python.org/mailman/listinfo/doc-sig>`_ ;

- des glossaires et dictionnaires :

- le `glossaire de la documentation Python <https://docs.python.org/fr/3/glossary.html>`_, car il est déjà traduit,

- les `glossaires et dictionnaires de traduc.org <https://traduc.org/Glossaires_et_dictionnaires>`_, en particulier le `grand dictionnaire terminologique <http://gdt.oqlf.gouv.qc.ca/>`_ de l'Office québécois de la langue française,

- Wikipédia. En consultant un article sur la version anglaise, puis en basculant sur la version francaise pour voir comment le sujet de l'article est traduit ;

- le `guide stylistique pour le français de localisation des produits Sun

<https://web.archive.org/web/20160821182818/http://frenchmozilla.org/FTP/TEMP/guide_stylistique_December05.pdf>`_ donne

beaucoup de conseils pour éviter une traduction trop mot à mot ;

- `Petites leçons de typographie <https://jacques-andre.fr/faqtypo/lessons.pdf>`_,

résumé succint de typographie, utile pour apprendre le bon usage des

majuscules, des espaces, etc.

L'utilisation de traducteurs automatiques comme `DeepL https://www.deepl.com/` ou semi-automatiques comme

`reverso https://context.reverso.net/traduction/anglais-francais/` est proscrite.

Les traductions générées sont très souvent à retravailler, ils ignorent les règles énoncées sur cette

page et génèrent une documentation au style très « lourd ».

Les doubles-espaces