Chronik - Online in der Cloud

PROGRAMM:

NAME/FUNKTION

Chronik - Ein einfacher Blog-Compiler.

ZUSAMMENFASSUNG

Chronik [Optionen]

Pfadoptionen:

--comments Gibt den Pfad zum optionalen Kommentarverzeichnis an.
--config Gibt eine zu lesende Konfigurationsdatei an.
--input Geben Sie das zu verwendende Eingabeverzeichnis an.
--output Geben Sie das Verzeichnis an, in das die Ausgabe geschrieben werden soll.
--theme-dir Gibt den Pfad zu den Themenvorlagen an.
--theme Geben Sie das zu verwendende Thema an.
--pattern Gibt das Dateimuster an, mit dem gearbeitet werden soll.
--url-prefix Geben Sie das Präfix für den Live-Blog an.
--sitemap-prefix Geben Sie das Präfix für die Sitemap an.

Optionen für Blogeinträge:

--format Geben Sie das Format Ihrer Eingaben an, HTML/Textil/Markdown.

Pre- und Post-Build-Befehle:

--pre-build Gibt einen Befehl an, der vor dem Erstellen des Blogs ausgeführt werden soll.
--post-build Geben Sie einen Befehl an, der ausgeführt werden soll, sobald das Blog erstellt wurde.
--pre-filter Ein Befehl zum Filtern jedes Blogeintrags vor der HTML-Konvertierung.
--post-filter Ein Befehl zum Filtern jedes Blogeintrags nach der HTML-Konvertierung.

Sortieroptionen:

--recent-dates-first Zeigt die letzten Einträge zuerst in der Archivansicht an.
--recent-tags-first Zeigt die letzten Einträge zuerst in der Tag-Ansicht an.

Zähloptionen:

--entry-count=N Anzahl der im Index anzuzeigenden Beiträge.
--rss-count=N Anzahl der Beiträge, die in den RSS-Index-Feed aufgenommen werden sollen.

Optionale Ausstattung:

--author Geben Sie die E-Mail-Adresse des Autors an
--comment-days Geben Sie das maximale Alter von Beiträgen an, um Kommentare zu akzeptieren.
--date-archive-path Fügt das Datum in das Archiv ein.
--force Erzwingt das Kopieren statischer Dateien aus dem Blog-Theme.
--lang Geben Sie die Sprache an, die zum Formatieren von Datumsangaben verwendet werden soll.
--lower-case Verkleinert alle Dateinamen, die ausgegeben werden.
--no-archive Keine Archivseite erstellen.
--no-cache Die optionalen Memcache-Funktionen nicht verwenden, selbst wenn sie verfügbar sind.
--no-calendar Den optionalen Kalender für den Index nicht verwenden.
--no-comments Verbietet das Veröffentlichen von Kommentaren.
--no-sitemap Erzeuge keine Sitemap.
--no-tags Erzeuge keine Tag-Seiten.
--no-xrefs Erzeuge keine Querverweise.

Hilfeoptionen:

--help Zeigt die Hilfeinformationen für dieses Skript an.
--manual Lesen Sie das Handbuch zu diesem Skript.
--verbose Zeigt nützliche Debugging-Informationen an.
--version Zeigt die Versionsnummer an und beendet das Programm.

ÜBER UNS

Chronicle ist ein einfaches Tool zum Konvertieren einer Sammlung von Textdateien,
sich in einem einzigen Verzeichnis befinden, in ein Blog bestehend aus statischen
HTML-Dateien.

Es unterstützt nur das Nötigste an Funktionen, die erforderlich sind
um nützlich zu sein:

* Tagging-Unterstützung.

* RSS-Unterstützung.

* Archivunterstützung.

Die offensichtlichen Mängel sind:

* Fehlende Unterstützung für sofortiges Kommentieren.

* Fehlende Pingback-/Trackback-Unterstützung.

Allerdings ist es ein robustes, stabiles und nützliches System.

BLOG FORMAT

Das Format der von uns verarbeiteten Textdateien ist entscheidend für die Ausgabe
Seiten. Jeder Eintrag sollte ungefähr so ​​aussehen:

Titel: Dies ist der Titel des Blogbeitrags
Datum: 2. März 2007
Tags: eins, zwei, drei, langer Tag

Hier steht der Text Ihres Eintrags.

HINWEIS: Die Kopfzeile MUSS vom Hauptteil des Eintrags um mindestens a . getrennt sein
einzelne leere Zeile.

In diesem Beispiel können wir sehen, dass der Eintrag selbst vorangestellt wurde
mit kleinem Kopf. Ein Eintragskopf enthält drei optionale Zeilen,
wenn diese nicht vorhanden sind, gibt es sinnvolle Voreinstellungen wie beschrieben
unten mit.

Die Formatierung der Ausgabedaten kann über die Schaltfläche . geändert werden
B<--lang>-Befehlszeilenoption (oder die entsprechende Option "lang=french" im
Konfigurationsdatei), aber das Datum des Eintrags selbst sollte in . angegeben werden
Englisch.

Titel: Beschreibt den Titel des Beitrags. Falls nicht vorhanden, wird der Dateiname des Eintrags verwendet
stattdessen. "Betreff:" kann auch verwendet werden.
Betreff: Dies ist ein Synonym für 'Titel:'.
Datum: Das Datum, an dem der Beitrag geschrieben wurde. Wenn nicht vorhanden, wird die Erstellungszeit der Datei verwendet
stattdessen.
Veröffentlichen: Dieser Header wird aus allen Einträgen entfernt und vom Chronik-Spooler verwendet
Skripte.
Tags: Alle Tags, die dem Eintrag zugeordnet werden sollen, durch Kommas getrennt.

Als Format des Eintrags wird HTML angenommen, es gibt jedoch Unterstützung
zum Verfassen Ihrer Einträge sowohl im Textil- als auch im Markdown-Format.

Das Format der Einträge wird über das Argument B<--format> angegeben, oder
über eine "format: foo"-Einstellung in Ihrer Chroniclerc-Datei.

Es wird davon ausgegangen, dass das Format der Einträge global ist; das sind alle deine einträge
Es wird davon ausgegangen, dass das gleiche Format vorliegt. Sie können jedoch a . hinzufügen
"format: foo" Pseudo-Header für bestimmte Einträge, wenn Sie schreiben möchten
bestimmte Einträge in einem anderen Format.

Um Flexibilität bei der Handhabung von Einträgen zu ermöglichen, wird jeder Blogeintrag
durch das Filterskript B geleitet werden
wodurch Sie diese Handhabung an einer einzigen Stelle ändern können. Dies
Skript ermöglicht die Aktualisierung von Einträgen über Filter sowohl vorher als auch nachher
die Konvertierung in HTML. Weitere Informationen finden Sie auf der Manpage für
dieses Skript.

CONFIGURATION

Die Konfiguration der Software ist minimal und wird im Allgemeinen durchgeführt
über die Kommandozeilenargumente. Es ist jedoch möglich, Einstellungen zu speichern
entweder in der Datei global /etc/chroniclerc oder pro Benutzer ~/.chronikler
Datei.

Wenn Sie möchten, können Sie den Namen einer anderen Konfigurationsdatei an . übergeben
das Skript mit dem Flag B<--config>. Dies wird nach der
beiden vorherigen Dateien und können alle vorhandenen Einstellungen überschreiben.

Die Konfigurationsdatei enthält Zeilen wie diese:

Eingabe = /home/me/blog

Ausgabe = /var/www/blog

Format = Abschlag

Unbekannte Schlüssel werden ignoriert.

OPTIONAL CACHEN

Um den Wiederaufbau eines großen Blogs zu beschleunigen, kann der Compiler ein lokales
Memcached-Daemon, falls installiert und verfügbar.

Um dies zu installieren, führen Sie unter einem Debian GNU/Linux-System bitte Folgendes aus:

apt-get update
apt-get installiere memcached libcache-memcached-perl

Sie können dieses Caching-Verhalten mit --no-cache deaktivieren und die
Effekt mit --verbose.

OPTIONAL KALENDER

Wenn das Modul 'HTML::CalendarMonthSimple' verfügbar ist, wird jeder Blog
enthalten eine einfache Monatsansicht des aktuellen Monats im Index.

Um dies zu deaktivieren, rufen Sie das Programm mit '--no-calendar' auf.

OPTIONAL KOMMENTIEREN

Im Chronik-Code enthalten sollten Sie die Datei finden
cgi-bin/comments.cgi.

Diese Datei wurde entwickelt, um eingereichte Kommentare an das lokale zu schreiben
Dateisystem Ihres Webservers. Wenn Sie das installieren und bearbeiten
Pfad am Anfang des Skripts sollten Sie einschließen können
Kommentare in Ihrem Blog.

Kurz gesagt gibt es drei Dinge, die Sie tun müssen:

Installieren Sie das CGI-Skript und bearbeiten Sie den Pfad am Anfang.
Kopieren Sie die Ausgabekommentare in Ihre lokale Blogquelle.
Führen Sie dieses Skript erneut mit --comments=./path/to/comments . aus

Dies sollte die Kommentare in der statischen Ausgabe enthalten. Mehr
explizite Anweisungen sind in der Datei 'COMMENTS' enthalten
in der Verteilung enthalten.

Verwenden Sie die Chronik online mit den onworks.net-Diensten