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

nom de l'auteur du post (donc toi !) · date du post (pour antidater, c'est toujours pratique)

 # aptitude install python-setuptools git
 # pip install Blogofile

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

 $ blogofile build
 $ blogofile serve

 $ git add %liste_noms_fichiers%

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

 $ git push origin master

Merge request
   ---
   categories: comm
   date: 2042/10/10 10:10:10
   title: Le Loop envoi son premier hacker dans l'espace
   author: guyzmo
   summary: "Apres plusieurs mois de balade dans les squats les plus chaleureux de Paris, Le Loop est accueilli par la Gare XP !"
   ---
   Après 20 ans de recherches dans le cadre du programme "hackers in space", Le Loop est fier 
   d'avoir mis en orbite son premier geek! 

 $ ls *.mako
 how.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

 $ 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

   $ ls _controllers/blog
   __init__.py    chronological.py  post.py
   archives.py    feed.py
   categories.py  permapage.py

 # 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

@@ Line 20: / Line 20: @@
 == Routine ==
-=== Modifier le code ===
+Ajoutez un post ou modifiez le code (cf sections suivantes)
+=== 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 ===
+Retourner sur [https://gitorious.org/le-loop-blog/le-loop-blog Gitorious] et cliquer sur <tt>Merge request</tt>
+Puis soumettre un message pour proposer les changements en expliquant le tout.
+== Ajouter un post ==
+Imaginons que Le Loop vient d'envoyer son premier geek dans l'espace, et pour l'occasion on veut écrire un post de blog sur ce sujet. Voici comme ce faire.
+# éditer le fichier "_posts/042 - Un loopiot dans l'espace.markdown"
+# la structure d'un post est la suivante :
+    ---
+    categories: comm
+    date: 2042/10/10 10:10:10
+    title: Le Loop envoi son premier hacker dans l'espace
+    author: guyzmo
+    summary: "Apres plusieurs mois de balade dans les squats les plus chaleureux de Paris, Le Loop est accueilli par la Gare XP !"
+    ---
+    Après 20 ans de recherches dans le cadre du programme "hackers in space", Le Loop est fier
+    d'avoir mis en orbite son premier geek!
+* l'entête du post se situe entre les balises '---' et contient des champs au format YAML:
+** '''categories''' : liste de catégories dans lequel le post se situe (si une catégorie n'existe pas, elle est créée)
+** '''date''' : date du post (pour antidater, c'est toujours pratique)
+** '''title''' : titre du post
+** '''author''' : nom de l'auteur du post (donc toi !)
+** '''summary''' : résumé du post (ce champ est utilisé pour les résumés apparaîssant en index)
+* après l'entête, le texte répond au formatage choisi (via l'extension de fichier). Notamment, en ayant choisi une extension ".markdown", le formattage de l'article est en markdown. (on peut utiliser aussi .textile, et peut-être aussi .html... se référrer à la doc de blogofile pour ça).
+== Modifier le code ==
 Les fichiers en .mako sont des fichiers de [http://www.makotemplates.org/docs/syntax.html syntaxe mako].
@@ Line 31: / Line 92: @@
    _templates/header.mako    _templates/post_excerpt.mako
-==== Pages statiques ====
+=== Pages statiques ===
 * how.html.mako : contient le texte de la page "how"
@@ Line 38: / Line 99: @@
 * where.html.mako : contient le texte de la page "where"
-==== Pages dynamiques ====
+=== Pages dynamiques ===
 * feeds
@@ Line 57: / Line 118: @@
 ** '''_templates/chronological.mako''' : affiche tous les posts de blog en format paginé (correspond aussi à l'index du site)
-==== style, scripts et images ====
+=== style, scripts et images ===
 Il y a aussi du CSS, des images et un chouilla de JS parce qu'Anéfé ;)
@@ Line 67: / Line 128: @@
 x31.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
-==== contrôleurs ====
+=== contrôleurs ===
 Sinon, le code .py est en ... python, en utilisant la [http://blogofile.com/documentation/ bibliothèque blogofile].
@@ Line 87: / Line 148: @@
 les modules python ne sont à hacker que pour changer le comportement du site web (ajouter un champ aux posts etc..)
-=== 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 ===
-Retourner sur [https://gitorious.org/le-loop-blog/le-loop-blog Gitorious] et cliquer sur <tt>Merge request</tt>
-Puis soumettre un message pour proposer les changements en expliquant le tout.
 == Version courte ==

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

Revision as of 13:17, 24 August 2012

Contents

Prérequis

Obtenir le code source

Routine

Tester en local

Valider la modification

Publier la modification

Faire valider la mise à jour

Ajouter un post

Modifier le code

Pages statiques

Pages dynamiques

style, scripts et images

contrôleurs

Version courte

Navigation menu

Views

Personal tools

Wiki

accès direct

Search

Tools

leloop.org