Pelican Weblog mit Markdown und reStructuredText

Wir wollten für eben dieses Weblog eine möglichst einfache und sichere Möglichkeit, Weblogs zu erstellen — vor allem keine PHP-/SQL-basierende Lösung (Performance, Gefahr von SQL-Injection). Pelican ist eine in Python geschriebene Generator-Software, d.h., die Erfassung der Texte etc. erfolgt offline in einfachen Textdateien unter Verwendung der Auszeichnungssprachen Markdown oder ReStructuredText; das eigentliche Weblog wird dann durch manuellen oder automatischen Aufruf von pelican als reine HTML-Webseite geschrieben.

Pelican ist zwar am Anfang in der Bedienung etwas “sperrig”, da das Zielpublikum definitiv keine DAUs sind und die Dokumentation entsprechend teilweise sehr dürftig ist, aber wenn man sich erst einmal eingearbeitet hat so lassen sich sehr flott und effizient Beiträge schreiben.

Um die Lernkurve etwas besser zu gestalten hier unsere Sammlung von Hinweisen für einen schnellen Einstieg.

Installation

Siehe auch Installationshinweise auf der Pelican Homepage.

Über die Distribution (in unserem Fall: openSUSE mit dem Verwaltungswerkzeug Yast2 bzw. dessen Kommandozeilenversion zypper) kontrollieren ob Python und PIP (Python Install Packages) sowie event. Pillow (Bildmanipulation in Python) installiert sind; gegebenenfalls nachinstallieren:

server:/ # zypper se python | grep "^i"

i | python                     | Python Interpreter
i | python-Pillow              | Python Imaging Library (Fork)
i | python-pip                 | Pip installs packages. Python packages.

server:/ # python -V

Python 2.7.8

Pelican selbst und seine Voraussetzungen installiert man über PIP:

server:/ # pip install Markdown
server:/ # pip install pelican
server:/ # pip install markupsafe
server:/ # pip install typogrify

Dann initialisieren wir die Pelican-Umgebung:

server:/ # mkdir /wo/soll/mein/blog/sein
server:/ # cd /wo/soll/mein/blog/sein
server:/wo/soll/mein/blog/sein # pelican-quickstart

Struktur

[[http://docs.getpelican.com/en/3.5.0/settings.html]]

Plugins

Vielleicht gibt es auch einen einfacheren Weg - einstweilen arbeiten wir so:

  • im Blog-Ordner ein Unterverzeichnis “plugins” anlegen
  • mit git oder von ((https://github.com/getpelican/pelican-plugins)) über “Download ZIP” das Archiv “pelican-plugins-master.zip” herunterladen
  • die gewünschten Plugin-Verzeichnisse aus dem ZIP in den eben angelegten plugins-Ordner kopieren

Danach noch in der Konfigurationsdatei den Pfad zu den Plugins setzen und die gewünschten Plugins aktivieren:

PLUGIN_PATHS = ['./plugins']
PLUGINS = ['better_figures_and_images']

Markdown (MD) vs. reStructuredText (RST)

Überschriften

Formatierungen

Kursiv, Fett und Fett kursiv bzw.
Kursiv, Fett und Fett kursiv

Absatzumbruch: einfach zwei Returns hintereinander.

Zeilenumbruch: am Ende der Zeile zwei oder mehr Leerzeichen, dann ein Return.

Gedankenstrich (—): —

Links

Grafiken

Siehe auch: Pelican Homepage Markdown: Syntax

blogroll

social