blip
1.0.0
Blip verwendet eine spezielle Verzeichnisstruktur für Vorlagen und Website-Organisation. Sehen Sie sich das Verzeichnis example-site/ für eine Demo an oder lesen Sie weiter für eine vollständige Beschreibung.
Vorlagen sind Layout-Anleitungen für den Index und die Beitragsseiten Ihrer Website. Folgendes befindet sich in config/templates/ :
index_template.html : Die Hauptindexseiten Ihrer Website.
index_post_template.html : Das Layout der Beitragsvorschau auf den Indexseiten.
post_template.html : Das Layout der einzelnen Beitragsseite.
Blip verwendet einige benutzerdefinierte „Tokens“ für allgemeine Aufgaben und Textersetzungen. Verwenden Sie Config.swift um die Ersetzungszeichenfolgen anzupassen.
Markdown (Beiträge):
[[MORE]] : Unterbricht den Beitrag an dieser Stelle in den index*.html -Seiten und fügt einen Read More Link zum vollständigen Beitrag ein.Vorlagen:
$(COPYRIGHT) : Fügt eine benutzerdefinierte Copyright-Zeichenfolge in eine Indexvorlage ein.
$(POSTS) : Fügt eine Liste von Beitragsausschnitten in eine Indexvorlage ein.
$(POSTS_OLDER) : Fügt einen Link „Ältere Beiträge“ in eine Indexvorlage ein.
$(POSTS_NEWER) : Fügt einen Link „Neuere Beiträge“ in eine Indexvorlage ein.
$(POST_TITLE) : Fügt den Beitragstitel in eine Beitrags- oder Indexvorlage ein.
$(POST_TIMESTAMP) : Fügt den Post-Zeitstempel in eine Post- oder Indexvorlage ein.
$(POST_BODY) : Fügt den Beitragstext in eine Beitrags- oder Indexvorlage ein (die Indexvorlage wird bis zu jedem [[MORE]] Token angezeigt).
$(POST_PERMALINK) : Fügt einen Beitrags-Permalink in eine Beitrags- oder Indexvorlage ein.
Beiträge sollten im Markdown-Format vorliegen und der Namenskonvention YYYYMMDD.md folgen (die Dateierweiterung .markdown wird ebenfalls unterstützt).
Das Verzeichnis posts/ sollte mindestens zwei Unterverzeichnisse enthalten:
drafts : Hier sollten Sie Ihre Markdown-Dateien (.md) zur Veröffentlichung ablegen.
published : Blip generiert HTML index*.html und veröffentlicht Seiten in diesem Verzeichnis. Sie sollten den Inhalt dieses Verzeichnisses für Ihre Website verwenden.
Veröffentlichte Beiträge werden nach dem Datum in ihrem Dateinamen sortiert. So wird beispielsweise ein Beitrag mit dem Dateinamen 20171220.md unter folgendem Pfad veröffentlicht: posts/published/2017/12/20.md . Derzeit unterstützt Blip nur einen einzigen Beitrag pro Tag, hauptsächlich weil ich nicht sehr oft blogge ...
published/stylesheets/ : Die Standardvorlagen verwenden die enthaltene index.css als Stylesheet. Sie können hier andere CSS-Dateien einfügen und bei Bedarf in Ihren Vorlagen darauf verweisen.
published/images/ : Legen Sie Ihre Bilder hier ab und Sie können sie in Markdown wie folgt referenzieren: 
Schreiben Sie Ihren Beitrag in Markdown mit der richtigen Dateinamenskonvention ( YYYYMMDD.md ) und legen Sie ihn dann im drafts/ -Verzeichnis ab.
Führen Sie dann den folgenden Befehl aus:
./blip /path/to/your/blog/ -r
-r Erstellt die gesamte Site neu, indem alle Markdown-Dateien im drafts/ -Verzeichnis veröffentlicht werden.
-w Überwacht Ihr drafts/ -Verzeichnis auf neue Markdown-Dateien und veröffentlicht diese automatisch.
-i Erstellt nur die Site- index*.html Seiten neu.
-h Zeigt Hilfe an.
Ein einfacher, benutzerfreundlicher/erweiterbarer Dateisystem-Watcher mit Swift.
Blitzschnelles Markdown-Rendering in Swift, basierend auf cmark.
Besuchen Sie meine persönliche Website für ein Beispiel für die Verwendung von Blip.
