The PHPUnit project is no longer involved with the translation of its documentation to other languages. This repository is now archived.

Documentation de PHPUnit en français

Ce dépôt contient la documentation française de PHPUnit.
La documentation est accessible à l'adresse https://phpunit.readthedocs.io/fr/latest/.

La documentation originale en anglais : https://github.com/sebastianbergmann/phpunit-documentation-english

Traductions

Chaque traduction de la documentation est maintenue dans un dépôt dédié:

• Documentation en anglais
• Documentation en espagnol
• Documentation en français
• Documentation en brésilien et portuguais
• Documentation en japonais
• Documentation en chinois simplifié
• Documentation en russe

Ajouter une nouvelle traduction

Si vous souhaitez créer une nouvelle traduction, merci d'ouvrir une issue sur le tracker de la documentation anglaise, indiquant la langue que vous souhaitez traduire. Un dépôt sera créé et ajouté aux traductions disponibles.

Idéalement, vous aurez déjà préparé une première version basée sur un fork ou une copie de la documentation anglaise qui sera ensuite importée dans le dépôt officiel.

Construire la documentation

Pré-requis

• Python
• Sphinx
• Read the Docs Sphinx Theme

Générer la documentation HTML

Pour générer la documentation, exécuter la ligne de commande suivante:

$ make html

Ensuite, vous trouverez les fichiers HTML dans build/html.

Relecture automatisée

Installation

$ pip install docutils-ast-writer
$ npm install

Utilisation

$ ./node_modules/.bin/textlint src

Contribuer

Merci de prendre du temps pour aider.

Contributions attendues

• Mettre à jour la documentation suite aux améliorations de la documentation anglaise
• S'il s'agit d'une mise à jour, préciser le commit de la documentation originale avec lequel la synchronisation est faite
• Corriger les typos, les fautes d'orthographes, de grammaire et de syntaxes
• Détecter le franglais et les anglicismes
• Revue de pair sur les PR

Mode d'emploi

• Vérifier le guide de traduction
• Faire une Pull requests documentée vers master (idéalement depuis une "feature branch").
• Vérifier que la compilation passe avant de faire une pull request
• Laisser les exemples de code en anglais
• Respecter les sauts de ligne de la documentation originale afin de faciliter les recherches et les comparaisons (les numéros de lignes entre la documentation anglaise et française doivent être les mêmes)

Guide de traduction

Dans le tableau suivant sont recensées les règles de traductions utilisées de manière à garantir la cohérence d'ensemble. Sont notamment visés les termes techniques.

Lectures recommandées :

• https://framacalc.org/jargon-francais
• https://www.24joursdeweb.fr/2017/on-dit-numerique-et-pas-digital-bordel/