Wiki

Clone wiki

djangofrdoc / Home

Comment contribuer ?

Pour contribuer veuillez suivre les étapes suivantes dans l'ordre. Après avoir "forké" ou demandé des droits d'écriture à l'adresse mail suivante martin.sam[at]gmail[dot]com

1. Récupérer le dépôt en local

2. Générer la documentation

Installez Sphinx

  • "pip install sphinx" ou bien "easy_install sphinx"

Allez dans votre dossier "djangofrdoc" et générez la documentation en tapant la commande

  • make html

3. Choisir un fichier non traduit

  • A l'aide de votre navigateur préféré, dans djangofrdoc/_build/html ouvrez le fichier index.html
  • Tous les liens suffixés de "(en) sont des fichiers en attentes de traduction

4. Signaler son choix aux autres contributeurs

  • Utilisez le menu "issues" du dépôt bitbucket pour signaler quel fichier vous avez choisi de traduire.
  • Important : Ce même menu vous permet de voir si un autre contributeur n'a pas commencé à traduire le fichier que vous venez de choisir.

5. Tester sa traduction

  • Après traduction, utilisez simplement la commande "make html" pour vérifier qu'il n'y ait pas d'erreurs de syntaxe. Pour les erreurs d'orthographe et de grammaire, testez avec bonpatron par exemple.

6. Envoyer sa traduction

  • hg ci -m "Mon message" puis hg push

7. Marquer la traduction pour relecture

  • retournez sur le ticket concernant le fichier que vous avez traduit et changer son "component" en "relecture"
  • l'assigner à "nobody": un contributeur voulant en faire la relecture se l'assignera, réalisera ses éventuelles corrections et marquera le ticket comme étant résolu (state=resolved)

Besoin d'aide complémentaire ?

Vous êtes perdu ? vous avez besoin d'être accompagné, vous souhaitez cependant contribuer à la traduction ? Connectez vous sur IRC (serveur freenode channel #django-fr) ou envoyez un email à martin.sam[at]gmail[dot]com

Updated