Participer au projet django-fr, traduction de la documentation depuis Ubuntu

Si la majorité des informations sont disponibles sur la page bitbucket dédiée, il reste cependant quelques zones d'ombre pour les débutants souhaitant s'investir sur django-fr. J'oubliais, pour participer au projet de traduction, nul besoin d'être un cador du python ou autre langage. Ce qui suit se veut être un mode d'emploi pour tous les utilisateurs d'Ubuntu.

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