Pour éditer le wiki, il faut demander un compte à un Lapin !

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

From Le L∞p's Wiki
Jump to: navigation, search
m (Prérequis)
m ($ ~/bin/faire_chier_guyzmo.sh --troll-proof)
Line 16: Line 16:
 
* Faire <tt>Clôner</tt> pour obtenir une copie en local.
 
* Faire <tt>Clôner</tt> pour obtenir une copie en local.
 
Puis dans un shell :
 
Puis dans un shell :
   git clone git://git@gitorious.org/MONBLAZE/le-loop-blog
+
   $ 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.
 
Ce qui a pour effet de créer votre propre espace de travail sur Gitorious.
  
Line 40: Line 40:
  
 
Générer le site depuis les sources :
 
Générer le site depuis les sources :
   blogofile build
+
   $ blogofile build
   blogofile serve
+
   $ blogofile serve
  
 
Vérifier le résultat dans le navigateur sur http://127.0.0.1:8080/
 
Vérifier le résultat dans le navigateur sur http://127.0.0.1:8080/
Line 48: Line 48:
  
 
Une fois qu'un changement a été vérifié et ne casse pas tout, on ajoute les fichiers modifiés :
 
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%
+
   $ git add %liste_noms_fichiers%
 
où %liste_noms_fichiers% est la liste des noms de fichiers modifiés pour ce changement. Voir aussi <tt>git status</tt>.
 
où %liste_noms_fichiers% est la liste des noms de fichiers modifiés pour ce changement. Voir aussi <tt>git status</tt>.
  
 
Puis on enregistre la modification :
 
Puis on enregistre la modification :
   git commit -m "%description de ce qui a été fait dans le commit%"
+
   $ git commit -m "%description de ce qui a été fait dans le commit%"
  
 
Par convention :  
 
Par convention :  
Line 62: Line 62:
  
 
On envoie le tout sur Gitorious :
 
On envoie le tout sur Gitorious :
   git push origin master
+
   $ git push origin master
  
 
=== Faire valider la mise à jour ===
 
=== Faire valider la mise à jour ===

Revision as of 03:59, 14 July 2011

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
 # easy_install Blogofile
 # aptitude install git

Obtenir le code source

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

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

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-blogClone
 $ <é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-blogMerge request
 $ echo 'debout molasse' | mail webmaster@leloop.org