Différences

Ci-dessous, les différences entre deux révisions de la page.

--- informatique:serveur:pelican [2014/05/31 17:10]
igor [Installation] suite
+++ informatique:serveur:pelican [2018/07/29 09:08] (Version actuelle)
@@ Ligne 1: / Ligne 1: @@
 ====== Pelican ======
+En cours de rédaction : FIXME
+FIXME : plus à jour...
 En terme de [[http://id-libre.org/shaarli/?searchtags=publication_web|publication Web]], j'utilise, ou j'ai utilisé, différents outils, comme par exemple :
@@ Ligne 6: / Ligne 10: @@
   * [[:informatique:serveur:pluxml|PluXml]]
-Pour diverses raisons, je cherche à explorer d'autres pistes, comme [[http://jekyllrb.com/|Jekyll]], [[http://jekyllrb.com/|Makefly]] ou [[http://blog.getpelican.com/|Pelican]]. [[:informatique:serveur:pelican|Sur cette page]], je documente ma découverte de ce dernier.
+Pour diverses raisons, je cherche à explorer d'autres pistes, comme [[http://jekyllrb.com/|Jekyll]], [[http://makefly.depotoi.re/|Makefly]] ou [[http://blog.getpelican.com/|Pelican]]. [[:informatique:serveur:pelican|Sur cette page]], je documente ma découverte [//laborieuse//] de ce dernier.
 ===== Documentation =====
@@ Ligne 15: / Ligne 19: @@
 J'ai rangé ce moteur de site statique dans la partie [[:informatique:serveur|serveur]] de ce wiki, mais je l'installe sur mon ordinateur de [[:informatique:desktop|bureau]].
+==== Prérequis ====
+  * python, python-virtualenv, virtualenvwrapper, python-pip
+==== Mise en place ====
   - Création du répertoire dans lequel on va travailler : ''mkdir /chemin/vers/repertoire/''
@@ Ligne 24: / Ligne 34: @@
   - Installation de Fabric, qui permet d'automatiser un certain nombre de tâches : ''pip install Fabric''
-En cours de rédaction : FIXME
+===== Création du site =====
+  - ''mkdir /chemin/vers/repertoire/site''
+  - ''cd /chemin/vers/repertoire/site''
+  - ''pelican-quickstart'' et répondre aux questions
+===== Produire du contenu =====
+Ça se passe dans ''/chemin/vers/repertoire/site/content''. On peut ''mkdir pages articles'' pour avoir les répertoires qui vont bien, avec des pages statiques et des articles aux bons endroits. On peut également ''mkdir images docs'' et d'autres pour avoir des répertoires contenant les images, les documents mis à disposition, etc.
+Lorsque l'on crée ces derniers répertoires, il faut les ajouter à la listes des chemins statiques, dans le fichier ''pelicanconf.py'', avec ''STATIC_PATHS = ['images', 'docs', ...]''.
+===== Générer le site =====
+On peut le faire avec ''fab build''. Dans ma configuration, il faut que l'environnement virtuel soit activé, bien entendu. ''fab regenerate'' permet d'automatiser la génération à chaque modification.
+**Attention :** lors de mon premier essai, à la génération du site après ajout d'une page statique, rien ne s'est passé et les erreurs suivantes se sont affichées :
+  WARNING: Could not process output/authors.html
+  'NoneType' object has no attribute 'lower'
+  WARNING: Could not process output/archives.html
+  'NoneType' object has no attribute 'lower'
+  WARNING: Could not process output/index.html
+  'NoneType' object has no attribute 'lower'
+  WARNING: Could not process output/tags.html
+  'NoneType' object has no attribute 'lower'
+  WARNING: Could not process output/categories.html
+  'NoneType' object has no attribute 'lower'
+Après quelques rapides recherches, il s'avère qu'il est nécessaire de préciser également dans le ''pelicanconf.py'' le ''PATH = 'content'''
+''fab serve'' démarre un serveur web local, sur le port ''8000''. Du coup, on peut afficher son site sur ''http://localhost:8000''.
+===== Thème =====
+Les thèmes se trouvent dans ''~/.virtualenvs/[install-pelican]/lib/python2.7/site-packages/pelican/themes''. J'imagine que le plus simple pour commencer, c'est de faire une copie du thème simple, et de tester des modifications sur ce dernier.

notes

Outils pour utilisateurs

Outils du site

Différences

Outils de la page