Pelican

Structure de fichiers

• website/
  • content/
    • category/
      • article1.md
    • article2.md
    • pages/
      • about.md
  • pelicanconf.py
  • output/

Settings (pelicanconf.py, publishconf.py)

pelicanconf.py

# en-tête du fichier #!/usr/bin/env python # -*- coding: utf-8 -*- # from __future__ import unicode_literals AUTHOR = 'Moi' SITENAME = "Mon site" SITEURL = 'http://www.monsite.fr' TIMEZONE = "Europe/Paris" PATH = 'content' DEFAULT_LANG = 'fr' # spécifier les dossiers qui seront copiés sans modification vers output STATIC_PATHS = ['images', 'pdfs', '.'] # . désigne le dossier content lui-même # permet de visualiser le site sans démarrer de serveur web # can be useful in development, but set to False when you're ready to publish RELATIVE_URLS = True THEME = 'mon-theme'

Articles

MonArticle.md

Title: My super title Date: 2010-12-03 10:20 Modified: 2010-12-05 19:30 Category: Python Tags: pelican, publishing Slug: my-super-post Authors: Me, You Summary: Short version for index and feeds Retour à la ligne(2 espaces) Ligne suivante Liens [Article]({filename}/category/article.md)  [Fichier PDF]({filename}/pdfs/fichier.pdf) Citations > Avec retrait et en italique Code  :::python print("Hello") Avec les numéros de ligne #!python print("Hello")

Ne pas oublier de changer STATIC_PATHS pour les liens.

Publier le site

Générer le site

pelican [PATH] [-s pelicanconf.py] [-t theme] # PATH, chemin vers le dossier content, il peut être définit dans les settings pelicanconf.py # générer seulement une page pelican --write-selected output/article-1.html # debugguer la génération pelican --debug

Visualiser le site

L'option « RELATIVE_URLS = True » permet de visualiser le site sans lancer de serveur web.

# lancer un serveur pour afficher le résultat cd output python -m http.server # le site est accessible via http://localhost:8000/

Déployer le site

# regénérer le site avec les settings finaux pelican content -s publishconf.py # copie via ssh rsync -avc --delete output/ host.example.com:/var/www/your-site/

Thèmes

# lister les thèmes installés pelican-theme -l # installer un thème sudo pelican-themes -vi dossier_contenant_mon_theme # générer le site avec un thème spécifique pelican -t mon_theme # désinstaller un thème sudo pelican-themes -r mon_theme -v

Plugins

pelicanconf.py

PLUGIN_PATHS = ["pelican-plugins"] PLUGINS = ["gallery", "tipue_search"]

Installation

sudo pacman -S pelican python-markdown # avec pip sudo pip install pelican markdown