Pelikan-Themen

Pelikan-Themen

Dieses Repository enthält Themes für Pelican. Fühlen Sie sich frei, zu klonen, Ihr eigenes Thema hinzuzufügen und eine Pull-Anfrage zu senden. Es wird von der Community verwaltet!

Eine Live-Version ist unter http://www.pelicanthemes.com zu sehen.

Verwenden von Themen

Bei diesen Anweisungen wird davon ausgegangen, dass Sie bereits die gesamte Pelican-Dokumentation gelesen haben, über eine funktionierende Site verfügen und nun ein nicht standardmäßiges Theme anwenden möchten.

Wählen Sie zunächst einen Ort für Ihre Themen aus. Für dieses Beispiel verwenden wir das Verzeichnis ~/pelican-themes , Ihr Verzeichnis könnte jedoch anders sein. Klonen Sie das pelican-themes Repository an diesen Speicherort auf Ihrem lokalen Computer:

git clone --recursive https://github.com/getpelican/pelican-themes ~ /pelican-themes

Jetzt sollte Ihr pelican-themes Repository unter ~/pelican-themes/ gespeichert sein.

Um eines der Designs zu verwenden, bearbeiten Sie Ihre Pelican-Einstellungsdatei so, dass sie diese Zeile enthält:

 THEME = "/home/user/pelican-themes/theme-name"

Um beispielsweise das mnmlist -Design zu verwenden, müssen Sie Ihre Einstellungsdatei so bearbeiten, dass sie Folgendes enthält:

 THEME = "/home/user/pelican-themes/mnmlist"

Speichern Sie die Änderungen in Ihrer Einstellungsdatei und generieren Sie dann Ihre Site neu, indem Sie das Makefile verwenden, das Sie bereits mit pelican-quickstart eingerichtet haben sollten:

make html

Themen können auch direkt über den Parameter -t ~/pelican-themes/theme-name im pelican -Befehl angegeben werden. Wenn Sie Ihr Theme bearbeiten möchten, stellen Sie sicher, dass alle von Ihnen vorgenommenen Änderungen an der in ~/pelican-themes/theme-name gespeicherten Kopie vorgenommen werden. Alle Änderungen an den im output Ihrer Site gespeicherten Dateien werden beim nächsten Generieren Ihrer Site gelöscht.

Generieren von Theme-Vorschauen

Das Generieren von Theme-Vorschauen erfolgt automatisch über einen GitHub Actions-Workflow. Anschließend werden diese Vorschauen auf https://pelicanthemes.com veröffentlicht. Wenn Sie Vorschauen lokal auf Ihrer Workstation generieren möchten, klonen Sie das Pelican-Repository (z. B. nach ~/projects/pelican/), klonen Sie dieses Repository irgendwo, wechseln Sie in das Stammverzeichnis dieses Klons und führen Sie die folgenden Schritte aus:

python -m pip install pelican[markdown] shot-scraper
mkdir _pelican
cp -r ~ /projects/pelican/samples _pelican/
python build-theme-previews.py