• Overview
• Downloads (0)
• Source
• Changesets
• Wiki
• Issues (2) »
  • New issues
  • Open issues
  • Closed issues
  • All issues
  • Advanced query
  • Create new issue
• Forks/Queues (0)
• Followers (12)

Bienvenue sur le dépôt de Django-fr

Il y a deux choses disponibles : le code du site et les traductions.

Traduction de la documentation

Comment participer ?

Si vous voulez participer à la traduction française de la documentation de Django ou à sa relecture, veuillez suivre les étapes suivantes :

1. Installez les programmes nécessaires :
   • un client subversion pour récupérer la doc du trunk django (la VO)
   • un client mercurial pour récupérer la doc VF et commiter vos traductions
   • les docutils Python et sphinx pour vérifier que vos traductions sont valides (compilables).
2. Choisissez un fichier à traduire : prenez de préférence un fichier non traduit, ou actuellement sans mainteneur. Certaines documentations sont plus urgentes que d'autres à réaliser/mettre à jour : toute l'introduction (répertoire intro/ dans la VO), et les docs de référence de base (/ref dans la VO) sont plus importants que /ref/contrib/ ou /obsolete par exemple.
3. Si le fichier choisi a un mainteneur, mais qu'il est très vieux (le fichier, ahem), tentez de le contacter par mail ou sur #django-fr sur freenode pour demander de reprendre la responsabilité de cette documentation.
4. Créez-vous un compte Bitbucket et demandez de vous ajouter en tant que contributeur (David <larlet@gmail.com> ou david`bgk sur #django-fr sur freenode). Utilisez de préférence votre nick freenode comme login bitbucket, c'est plus facile à suivre :)
5. Récupérez la documentation originale (voir ci-dessous)
6. Récupérez le dépôt français (voir ci-dessous). Attention le répertoire docs/ contient la nouvelle arborescence de la documentation, l'ancienne est dans olddocs/
7. Mettez à jour cette page pour indiquer votre intention de traduire
8. Traduisez en vous aidant des traductions existantes pour le vocabulaire/style
9. Vérifiez que votre traduction est valide docutils/sphinx en "compilant" celle-ci vers du html
10. Commitez vos traductions sur le dépôt français, en indiquant impérativement le numéro de version svn de l'original que vous avez traduit dans le message de commit
11. Mettez à jour cette page en indiquant que ce fichier est traduit, avec la version

Anciens mainteneurs, une table pour vous permettre de retrouver la traduction dont vous avez la charge dans la nouvelle arborescence de la documentation du trunk est en cours d'élaboration : OldNewDocTable

Etat des traductions

Liste des traductions

Interactions avec le dépôt original (subversion, django trunk)

Pour récupérer les fichiers, il faut atteindre le dépôt subversion du projet Django :

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

Pour remettre tous les fichiers à jour, lancez :

svn up

Pour connaître la version d'un fichier donné :

svn info intro/tutorial01.txt

Pour savoir ce qui a changé depuis votre dernière traduction :

svn diff -r7777 intro/tutorial.txt

avec 7777 la révision de votre dernière traduction.

Interactions avec le dépôt français (bitbucket/mercurial)

Pour récupérer les sources du site :

$ hg clone http://bitbucket.org/david/djangofr/

Vous allez ensuite pouvoir effectuer des modifications locales, lorsque vous êtes satisfait il suffit de faire :

$ hg ci -m "Message de commit"

Cela va ajouter une révision locale, il est nécessaire d'envoyer ces modifications au dépôt afin qu'elles soient accessibles à tous :

$ hg push

Si des modifications ont été réalisées par d'autres personnes, vous allez pouvoir les récupérer localement :

$ hg pull

Mais pour qu'elles soient appliquées à vos fichiers locaux, il vous faudra les mettre à jour :

$ hg up

Sinon les commandes sont les mêmes que pour subversion, en fait il y a juste une étape supplémentaire de pull/push. C'est le prix à payer pour pouvoir avoir un système décentralisé :-).

Développement du site

TODO.