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
(→‎pour modifier le code)
(pif paf)
Line 1: Line 1:
−
= HOWTO modifier le site ouaibe du loop =
+
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. <small>(ici faudrait un exemple)</small>
  
 
== Prérequis ==
 
== Prérequis ==
  
−
* blogofile : http://blogofile.com
+
Installer [http://blogofile.com blogofile] et git :
−
** sudo aptitude install python-setuptools
+
  # aptitude install python-setuptools
−
** sudo easy_install Blogofile
+
  # easy_install Blogofile
−
* git :
+
  # aptitude install git
−
** aptitude install git
+
  
−
== Pour commencer ==
+
== Obtenir le code source ==
  
−
* sur gitorious cloner le dépôt git du blog du loop :
+
Clôner le dépôt git depuis Gitorious :
−
** https://gitorious.org/le-loop-blog/le-loop-blog
+
* Sur https://gitorious.org/le-loop-blog/le-loop-blog
−
** faire cloner sur gitorious pour avoir votre propre version du site hébergée
+
* Faire <tt>Clôner</tt> pour obtenir une copie en local.
−
* suivi d'un git clone git://git@gitorious.org/....votre...nom..../le-loop-blog
+
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 ==
 
== Routine ==
  
−
=== pour modifier le code ===
+
=== Modifier le code ===
−
* les fichiers en .mako sont des fichiers de syntaxe mako
+
 
−
** http://www.makotemplates.org/docs/syntax.html
+
Les fichiers en .mako sont des fichiers de [http://www.makotemplates.org/docs/syntax.html syntaxe mako].
−
* le code .py est en ... python, en utilisant la bibliothèque blogofile
+
  $ ls *.mako
−
** http://blogofile.com/documentation/
+
  how.html.mako  index.html.mako  what.html.mako  when.html.mako  where.html.mako
−
* les autres sont du HTML, du CSS et un chouilla de JS parce qu'Anéfé ;)
+
 
 +
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 [http://blogofile.com/documentation/ 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 <tt>git status</tt>.
 +
 
 +
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 ===
  
−
=== une fois le code et/ou texte modifié ===
+
Retourner sur [https://gitorious.org/le-loop-blog/le-loop-blog Gitorious] et cliquer sur <tt>Merge request</tt>
−
* 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 ===
+
Puis soumettre un message pour proposer les changements en expliquant le 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 ===
+
== Version courte ==
 +
  # aptitude install python-setuptools git
 +
  # easy_install Blogofile
 +
  https://gitorious.org/le-loop-blog/le-loop-blog ↔ <tt>Clone</tt>
 +
  $ <é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 ↔ <tt>Merge request</tt>
 +
  $ echo 'debout molasse' | mail webmaster@leloop.org
  
−
* retourner sur gitorious et cliquer sur "merge request" puis soumettre un message pour proposer les changements en expliquant le tout.
 
  
 
[[Category:Projects]]
 
[[Category:Projects]]

Revision as of 00:09, 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-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
Retrieved from "http://wiki.leloop.org/index.php?title=Howto:Mise_à_jour_du_site_web&oldid=806"