Site du Capitole du Libre

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.

Installation

1. prérequis

• curl
• python
• virtualenv (paquet python-virtualenv avec Ubuntu)
• make

1. créer un dossier virtualenv

virtualenv pelican-sites

2. 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

3. cloner le repository

git clone https://github.com/toulibre/capitoledulibre-site.git

4. lier le thème dans système de fichiers

cd capitoledulibre-site
pelican-themes -s cdltheme-2013

Générer le site en local

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.

Mettre en ligne 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 :-)

Édition

Architecture des pages

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.

Format rst

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.