Bonjour à tous,
Cela fait bien longtemps que je n'ai rien écrit sur ce site. Et pour
cause, je suis bien occupé :D.
J'ai quand même pris un peu de temps récemment pour passer entièrement mon
site sous Pelican.
C'est mon cadeau de Noël de Geek ;).
Qu'est-ce que Pelican ?
Pelican est un gestionnaire de blog statique.
Qu'est-ce que ça veut dire ?
Cela signifie que je vais écrire mes billets avec mon éditeur de texte
préféré (kwrite), au format Markdown (ou restructuredText), et que je
génère mon blog au format HTML avant publication. (De la même manière que
l'on compilerait un programme).
Le serveur n'a alors besoin de servir que des fichiers statiques, il n'y
a donc pas de surplus de mémoire, ou de délai dû à la nécessité de
générer les pages.
Les pages n'étant pas modifiées tous les jours, il n'y a de toute façon
pas d'intérêt de générer les pages à chaque accès.
Les avantages indéniables sont les suivants :
- Pas de base de données, pas de page générée à la volée : donc pas de
temps de latence. La page est servie dés qu'elle est demandée. De plus
il existe un plugin permettant de générer les pages au format pré-zippé,
ce qui fait un traitement de moins sur le serveur.
- Pas de faille de sécurité dû à un script mal paramétré.
- Je peux gérer mes billets sous un gestionnaire de version (exemple
Mercurial).
Par contre les inconvénients sont :
- Plus de commentaire direct sur le blog (sauf à utiliser des plateformes
tel que disqus)
- Je dois installer le générateur de blog sur la/les machines que je
souhaite utiliser pour générer le blog.
- Je dois ensuite utiliser SCP pour transférer mon blog.
Pour les deux derniers points, ils sont de mon choix. D'autres installent
ces outils sur le serveur, ils peuvent donc générer leur page directement
à partir du serveur.
Les implications
Les conséquences pour ce blog sont donc : plus de commentaire (jusqu'à
nouvel ordre). Vous pouvez toujours m'envoyer un mail, pour poser une
question, je l'ajouterai manuellement en tant que commentaire.
Je garde tout de même les anciens commentaires, qui peuvent contenir
parfois quelques informations utiles.
J'ai également profité de ce petit changement pour faire un petit
nettoyage et j'ai supprimé tous les billets d'humeur, pour ne garder que
les articles réellement intéressant.
Comment s'est déroulé la conversion ?
Dans cette partie, je vais décrire le déroulement de la conversion du
blog.
Cette conversion comprend les articles, les commentaires et le thème.
Exportation des billets provenant de dotclear
Il a d'abord fallu exporter les billets depuis le site sous
Dotclear. Sous Dotclear, dans la partie administration, il est possible
d'utiliser le plugin Import/Export pour exporter le site dans un fichier
texte.
Le fichier texte se présente alors comme un mixte entre un fichier INI et
un ensemble de fichier CSV. Il contient, les catégories, les articles, et
les commentaires.
Ce fichier peut alors être utilisé avec l'outil d'import de pelican pour
récupérer les différents billets.
Création d'un environnement pour pelican
La création de l'environnement se fait comme décrit sur le site de
pelican. Je ne vais donc pas le décrire une fois de plus.
Une fois installé, les billets sont à placer dans le dossier content.
Les fichiers générés par l'import seront donc placés dans ce dossier.
Importation des billets au format Markdown
L'import est décrit dans la documentation de pelican. Après différents
tests, l'import au format Markdown a été celui qui a donné de meilleurs
résultats.
Voici donc la commande qui m'a permis de réaliser cet import :
pelican-import --dotclear -m markdown --dir-cat 2012-12-11-shadoware-backup.txt -o content
Cela m'a généré une liste de 65 fichiers : 1 par billet. Parmi ces
billets, j'ai fait le tri, et j'ai supprimé les billets d'humeur. J'ai
ajouté également un tag indiquant l'état de draft sur quelques billets qui
sont en cours d'écriture et que je n'ai pas encore eu le temps de
terminer et de publier.
Puis j'ai effectué une passe sur chaque billet, pour
- reprendre les parties de code (coloration syntaxique),
- reprendre les tableaux,
- reprendre les tags (qui n'ont pas été importés),
- corriger les dates (la date était celle de création du poste, et non
celle de publication),
- modification des catégories.
Sous dotclear, j'avais fait plusieurs niveaux de catégories, alors que
sous pelican, il n'y a qu'un seul niveau de catégorie. J'ai donc dû mettre
à plat les différentes catégories.
Pour les tableaux, ces derniers étaient repris directement au format HTML,
ils étaient donc exploitables directement. J'ai préféré refaire les
tableaux au format Markdown.
Ajustement du fichier de configuration
Viennent ensuite les ajustements faits dans le fichier de configuration,
pour que les URL des articles sous dotclear soient les plus proches
possibles des nouvelles URL.
Pour cela, j'ai choisi d'avoir les mêmes adresses que sur le site dotclear
suivies de .html ou de .xml.
Dans le fichier, j'ai positionné les variables pelicanconf.py
ARTICLE_URL = 'post/{slug}.html'
ARTICLE_SAVE_AS = 'post/{slug}.html'
AUTHOR_SAVE_AS = False
FEED_DOMAIN = SITEURL
FEED_ALL_ATOM = 'feed/atom.xml'
CATEGORY_FEED_ATOM = 'feed/category/%s/atom.xml'
TAG_FEED_ATOM = 'feed/tags/%s/atom.xml'
TRANSLATION_FEED_ATOM = False
Dans le fichier, j'ai positionné les variables publishconf.py
ARTICLE_URL = 'post/{slug}'
PAGE_URL = 'pages/{slug}'
CATEGORY_URL = 'category/{slug}'
TAG_URL = 'tag/{slug}'
Du coté de nginx, le serveur d'application, j'ai ajouté les lignes
suivantes :
rewrite ^/dotclear/index.php/post/\\d+/\\d+/\\d+/\\d+-(.*)$ /post/$1 permanent;
rewrite ^/post/\\d+/\\d+/\\d+/\\d+-(.*)$ /post/$1 permanent;
rewrite ^/post/\\d+/\\d+/\\d+/(.*)$ /post/$1 permanent;
location / {
try_files $uri.html $uri.xml $uri $uri/ =404;
}
Les premières lignes permettent de reprendre les anciennes adresses
dotclear, et la commande try_files permet de reprendre les adresses
existantes et de les compléter par .html et par .xml selon le besoin.
Modification du thème
Enfin j'ai écrit un nouveau thème dans le dossier themes/shadoware. Ce
thème est fait pour coller le plus possible à celui que j'avais sur le
site dotclear.
Il génère donc la page de la même manière que dotclear le faisait (à
quelques différences prés) pour éviter de devoir ré-écrire la feuille de
style CSS.
L'écriture du thème n'est en soit pas très compliqué, car jinja2 est
assez simple d'utilisation. Je me suis inspiré des thèmes simple et
notmyidea pour écrire le thème, basé sur celui que j'avais sous
dotclear.
Vous pouvez trouver le thème au lien suivant.
Importation des commentaires.
Les commentaires existants sur mon blog actuel peuvent parfois contenir
des informations complémentaires. Les ignorer lors de la migration est
tout a fait possible, mais j'ai préféré les récupérer.
Pour cela j'ai installé le plugin comments. Ensuite j'ai modifié le
thème pour ajouter l'affichage des commentaires :
{% if article.comments %}
id="comments">
Commentaires
{% for comment in article.comments %}
class="comment-number" href="#">{{ loop.index }}.
Le {{ comment.date }} par {{ comment.author }}
{{ comment.content }}
{% endfor %}
{% endif %}
Cela permet d'afficher les commentaires à l'aide du plugin. Par contre le
problème est que les commentaires provenant de dotclear ne sont pas
importés.
Du coup j'ai modifié le script d'import, pour en faire un qui importe les
commentaires. Il doit être lancé séparément du script d'import
traditionnel.
Afin de pouvoir publier des articles sur le planet libre, je proposais
jusqu'ici des articles sur le planet libre à l'aide d'un tag de type
planet.
L'utilisation d'un tag de type planet permet de filtrer les articles
que je souhaite mettre sur le planet libre. Par contre avec pelican,
l'utilisation de ce tag fausse le calcul des billets liés.
Du coup j'ai décidé que la génération du flux ATOM donné au planet sera
générée avec les articles qui posséderont un metatag déposé au début de
chaque billet. Sous la présence du tag avec la valeur true, le billet est
ajouté dans le flux ATOM des planets.
Pour ajouter le tag, il faut donc au début de l'article écrire le texte
suivant :
Afin d'avoir une belle page 404 si la page n'est pas correctement trouvée
(par exemple si certaines URLs ne correspondent plus à celle de dotclear),
j'ai défini au niveau de pelican, la création d'une belle page 404 de la
manière suivante :
