Difference between revisions of "Howto:Mise à jour du site web"

Revision as of 18:37, 22 August 2012

La mise à jour du site ouaibe pour les nuls.

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. (ici faudrait un exemple)

Prérequis

Installer blogofile et git :

 # aptitude install python-setuptools git
 # pip install Blogofile

Obtenir le code source

Clôner le dépôt git depuis Gitorious :

• Sur https://gitorious.org/le-loop-blog/le-loop-blog
• Faire Clôner pour obtenir une copie en local.

Puis dans un shell :

 $ git clone git://git@gitorious.org/MONBLAZE/le-loop-blog

Ce qui a pour effet de créer votre propre espace de travail sur Gitorious.

Routine

Modifier le code

Les fichiers en .mako sont des fichiers de syntaxe mako.

 $ ls *.mako
 how.html.mako  index.html.mako  what.html.mako  when.html.mako  where.html.mako
 $ ls _templates/*.mako
 _templates/atom.mako           _templates/footer.mako  _templates/permapage.mako     _templates/rss.mako
 _templates/base.mako           _templates/head.mako    _templates/post.mako          _templates/site.mako
 _templates/chronological.mako  _templates/header.mako  _templates/post_excerpt.mako

Il y a aussi du CSS, des images et un chouilla de JS parce qu'Anéfé ;)

 $ ls css/
 site.css
 $ ls js/
 blink.js
 $ ls img/
 88x31.png  adfreebutton.jpg  bg.jpeg  blackboxe.png  lqdn-censortefeux-1.gif  lqdn.png  phack.png  rss.png  tetalab.png  tmplab.png  toile-libre.png  usi.png  vi_powered.gif

Sinon, le code .py est en ... python, en utilisant la bibliothèque blogofile.

Tester en local

Générer le site depuis les sources :

 $ blogofile build
 $ blogofile serve

Vérifier le résultat dans le navigateur sur http://127.0.0.1:8080/

Valider la modification

Une fois qu'un changement a été vérifié et ne casse pas tout, on ajoute les fichiers modifiés :

 $ git add %liste_noms_fichiers%

où %liste_noms_fichiers% est la liste des noms de fichiers modifiés pour ce changement. Voir aussi git status.

Puis on enregistre la modification :

 $ git commit -m "%description de ce qui a été fait dans le commit%"

Par convention :

• "[ENH] added bla and bla" pour un ajout (enhancement)
• "[FIX] fixed typo in bla and bla" pour une correction
• "[DEL] removed ..." pour un retrait

Publier la modification

On envoie le tout sur Gitorious :

 $ git push origin master

Faire valider la mise à jour

Retourner sur Gitorious et cliquer sur Merge request

Puis soumettre un message pour proposer les changements en expliquant le tout.

Version courte

 # aptitude install python-setuptools git
 # easy_install Blogofile
 https://gitorious.org/le-loop-blog/le-loop-blog ↔ Clone
 $ <éditeur> *.mako css/* js/* img/*
 $ blogofile build
 $ blogofile serve
 <zieute>
 $ firefox http://127.0.0.1:8080/ &
 $ git add %fichiers%
 $ git commit -m "[FIX] changé l'eau en vin"
 $ git push origin master
 https://gitorious.org/le-loop-blog/le-loop-blog ↔ Merge request
 $ echo 'debout molasse' | mail webmaster@leloop.org