Les outils indispensables

  • Un client SVN - sudo aptitude install subversion
  • Un client Mercurial - sudo aptitude install mercurial
  • Les outils python - sudo aptitude install python-docutils
  • Sphinx - sudo easy_install sphinx==0.5 Important : Spécifier bien version 0.5, en effet la version 6 est sujette à quelques erreurs.

Télécharger la documentation officielle

Taper la commande suivante afin de récupérer la documentation officielle, prête à être traduite

svn co http://code.djangoproject.com/svn/django/trunk/docs/ django-docs

Un nouveau dossier "django_docs" apparait sur votre espace /home/votrepseudo/

Télécharger la documentation française

hg clone https://votrepseudo@code.welldev.org/djangofr/ (nécessite une inscription sur le site bitbucket)

Un nouveau dossier "djangofr" apparait sur votre espace /home/votrepseudo/

Choisir la partie à traduire

Comme annoncé en introduction, la page bitbucket et notamment le tableau joint vous permet de choisir une partie de la documentation non traduite. La channel IRC #django-fr sur le réseau freenode vous permet d'entrer en contact directement avec la communauté si besoin.

Vérifier votre traduction

A l'aide de l'outil sphinx, il est assez aisé de vérifier votre travail.

  1. Placer vous dans /home/votrepeudo/djangofr/docs
  2. Taper make html
  3. Si aucune erreur n'apparait, admirer la documentation (via votre navigateur web) créée dans /home/votrepseudo/djangofr/docs/_build. C'est tout simplement génial, votre simple fichier texte vient d'être transformé en une belle page html au couleur de django-fr
  4. Enfin Bonpatron peut vous être utile pour vérifier rapidement si aucune faute de grammaire et d'orthographe ne s'est glissée dans votre texte
  5. hg ci -m "Message de commit" - Envoyer votre traduction