Le site utilise pelican pour générer les pages HTML à partir de fichiers en rst.
Il suffit d'installer pelican dans un virtualenv en local pour générer le site entier, il n'est pas utile de l'installer sur le serveur.
- prérequis
- curl
- python
- virtualenv (paquet python-virtualenv avec Ubuntu)
- make
- créer un dossier virtualenv
virtualenv pelican-sites
- installer pelican, ses plugins et les dépendances nécessaires
cd pelican-sites source bin/activate easy_install pelican icalendar git clone https://github.com/cozo/pelican-plugins.git src/pelican-plugins cd src/pelican-plugins git checkout working
- cloner le repository
git clone https://github.com/toulibre/capitoledulibre-site.git
- lier le thème dans système de fichiers
cd capitoledulibre-site pelican-themes -s cdltheme-2013
Générer le site à l'aide du script de développement :
cd capitoledulibre-site make clean make devserve
Puis visiter la page http://localhost:8000/ pour visualiser le site.
Pour envoyer les fichiers situés dans "output" sur le serveur, vous pouvez vous aider de la commande
make rsync_upload
Cette commande génère le site avec les paramètres pour la version de production, puis synchronise les fichiers avec le serveur.
Les paramètres de connexion sont dans le fichier Makefile, il faut une clé ssh pour se connecter au serveur bien sûr :-)
Les fichiers source se trouvent dans le dossier src, les fichiers
générés dans le dossier output.
Les pages classiques sont dans le dossier src/pages, mais sont générées
à la racine du dossier output.
Les actualités (billets de blog) sont dans le dossier src/blog et
générées dans le dossier output-cdl2013/blog.
Les pages source sont au format restructured text
L'essentiel à savoir est qu'il faut mettre un titre principal à toute page:
================= Titre de la page =================
et que les liens sont notés `nom du lien <url>`_
Vous pouvez également utiliser le convertisseur en ligne Pandoc de John Mc Farlane.
En savoir plus sur l'édition des pages et du blog du site du Capitole du Libre.