Revision as of 22:10, 13 July 2011

HOWTO modifier le site ouaibe du loop

Prérequis

• blogofile : http://blogofile.com
  • sudo aptitude install python-setuptools
  • sudo easy_install Blogofile
• git :
  • aptitude install git

Pour commencer

• sur gitorious cloner le dépôt git du blog du loop :
  • https://gitorious.org/le-loop-blog/le-loop-blog
  • faire cloner sur gitorious pour avoir votre propre version du site hébergée
• suivi d'un git clone git://git@gitorious.org/....votre...nom..../le-loop-blog

Routine

pour modifier le code

• les fichiers en .mako sont des fichiers de syntaxe mako
  • http://www.makotemplates.org/docs/syntax.html
• le code .py est en ... python, en utilisant la bibliothèque blogofile
  • http://blogofile.com/documentation/
• les autres sont du HTML, du CSS et un chouilla de JS parce qu'Anéfé ;)

une fois le code et/ou texte modifié

• git add %liste_noms_fichiers%
  • où %liste_noms_fichiers% est la liste des noms de fichiers modifiés pour ce changement
• blogofile build
• blogofile serve
• vérifier le résultat dans le navigateur sur http://127.0.0.1:8080

une fois qu'un changement a été vérifié et ne casse pas tout

il est important de faire des commit atomiques,  et donc de faire un changement, suivi d'une description de ce qui a été fait, chaque changement étant le plus petit possible.

• git commit -m "%description de ce qui a été fait dans le commit%"
  • avec dans le message "[ENH] added bla and bla" pour un ajout, "[FIX] fixed typo in bla and bla" pour une correction, "[DEL] removed ..." pour un retrait

une fois le code et/ou texte stable et vérifié et la série de changements terminée

• git push origin master

une fois les changements effectués et envoyés

• retourner sur gitorious et cliquer sur "merge request" puis soumettre un message pour proposer les changements en expliquant le tout.