{"id":6886,"date":"2012-04-21T18:12:51","date_gmt":"2012-04-21T16:12:51","guid":{"rendered":"https:\/\/www.gambaru.de\/blog\/?p=6886"},"modified":"2019-10-09T02:46:39","modified_gmt":"2019-10-09T00:46:39","slug":"chronicle-bloggen-mit-dem-blogkompilierer","status":"publish","type":"post","link":"https:\/\/gambaru.de\/blog\/2012\/04\/21\/chronicle-bloggen-mit-dem-blogkompilierer\/","title":{"rendered":"Chronicle: Bloggen mit dem Blogkompilierer"},"content":{"rendered":"<p><a href=\"http:\/\/www.steve.org.uk\/Software\/chronicle\/\">Chronicle<\/a> ist ein sogenannter Blogkompilierer, der aus einfachen Textdateien, Markdown und HTML ein vollst\u00e4ndiges Blog mit Schlagworten, Archiv und RSS-Feeds erstellen kann. Ich hatte urspr\u00fcnglich vorgesehen alle Webseiten von Hand zu erstellen, da <a href=\"http:\/\/linuxiuvat.de\">linuxiuvat.de<\/a> haupts\u00e4chlich zur Beschreibung von Spielen, Dokumentation und f\u00fcr Statistiken gedacht ist, f\u00fcr die ein CMS mit dynamischen Inhalten \u00fcber das Ziel hinaus schie\u00dfen w\u00fcrde. Auf die Idee nach einem statischen Webseitengenerator wie Chronicle zu suchen, hat mich ein <a href=\"https:\/\/www.gambaru.de\/blog\/2012\/03\/15\/dein-name-sei-debianspiele-ein-exkurs-in-markenrecht\/comment-page-1\/#comment-2074\">Kommentator<\/a> gebracht, der gerne mit Hilfe eines RSS-Feeds auf dem Laufenden bleiben wollte.<br \/>\nWie man Chronicle konfiguriert und bedient, darum geht es in diesem Beitrag.<\/p>\n<h2>Installation und Konfiguration<\/h2>\n<p><code>aptitude install chronicle<\/code><\/p>\n<p><code><\/code><br \/>\nEs gibt zwei M\u00f6glichkeiten Chronicle zu verwenden. Man kann den Blogkompilierer entweder direkt auf dem vServer installieren oder ebenso praktisch auf dem eigenen Rechner zu Hause und verschiebt dann die generierten Seiten per FTP\/SSH zum Webserver. Die Einstellungen werden global entweder in <em>\/etc\/chroniclerc<\/em> oder f\u00fcr jeden Benutzer einzeln in <em>~\/.chroniclerc<\/em> vorgenommen.<\/p>\n<blockquote><p># Hiervon werden die Blogeintr\u00e4ge gelesen<br \/>\ninput = \/home\/apo\/blog\/input<br \/>\n# In diesem Verzeichnis liegt sp\u00e4ter das fertige Blog<br \/>\noutput = \/home\/apo\/blog\/news<br \/>\n# Name des Themas. Die Themen liegen in \/usr\/share\/chronicle\/themes<br \/>\ntheme = default<br \/>\n# Anzahl der Blogeintr\u00e4ge auf der Startseite<br \/>\nentry-count = 10<br \/>\n# Anzahl der RSS-Eintr\u00e4ge<br \/>\nrss-count = 10<br \/>\n# Wir schreiben die Artikel in HTML. Alternativen sind Markdown und Textile<br \/>\nformat = html<br \/>\n# Kommentarfunktion einschalten<br \/>\nno-comments = 0<br \/>\n# Der Name des Blogs<br \/>\nblog_title = Linux iuvat \/news<\/p><\/blockquote>\n<p>Die Standardeinstellungen sind sinnvoll und es gibt nur noch wenige zus\u00e4tzliche Optionen. Um einen Blogartikel zu erstellen, gen\u00fcgt es eine Textdatei im Input-Ordner mit dem folgendem Format zu erstellen.<\/p>\n<pre class=\"brush:xml\">Title: Hallo Welt\nTags: Neuigkeiten, Debian, Ubuntu\nDate: 21st April 2012\n&lt;h2&gt;Wichtige Nachrichten&lt;\/h2&gt;\n&lt;p&gt;Mein Blog ist online!&lt;\/p&gt;<\/pre>\n<p>Lediglich die Datumsangaben m\u00fcssen in englischer Notation erstellt werden. Die Ausgabe kann aber mit der Option <strong>--lang=german<\/strong> angepasst werden.<br \/>\nNachdem auf die gleiche Weise alle Blogartikel geschrieben wurden, wird das gesamte Blog mit<br \/>\n<code>chronicle<\/code><br \/>\ngeneriert und landet im vorher definierten Output-Verzeichnis.<\/p>\n<h2>Kommentare<\/h2>\n<p>Wie <a href=\"https:\/\/www.gambaru.de\/blog\/2012\/04\/21\/die-eigene-homepage-cms-blogkompilierer-und-statisches-xhtml\/\">im letzten Artikel<\/a> erw\u00e4hnt, ist der Nachteil eines statischen Webseitengenerators, dass eine Kommentarfunktion entweder extern ausgelagert oder serverseitige Skripte zus\u00e4tzlich installiert werden m\u00fcssen. Im Falle von Chronicle wird aber schon ein CGI-Skript mitgeliefert, dass es m\u00f6glich macht Kommentare zu verfassen. Diese werden in einer Textdatei gespeichert und beim Neukompilieren des Blogs in die statischen Seiten integriert.<br \/>\nDrei Einstellungen sind in der <strong>comments.cgi<\/strong> zu \u00e4ndern.<\/p>\n<blockquote><p>my $COMMENT = \"\/var\/www\/comments\/\"<br \/>\nmy $TO = 'root@localhost';<br \/>\nmy $FROM = 'www-data@vps.example.com';<\/p><\/blockquote>\n<p>Der Ordner in dem die Kommentare gespeichert werden, sollte aus Sicherheitsgr\u00fcnden au\u00dferhalb des Webserver-Root-Verzeichnisses liegen. Die Benachrichtigungsadresse l\u00e4sst sich beliebig w\u00e4hlen. Anschlie\u00dfend muss die Datei nur noch in das CGI-Verzeichnis des Webservers kopiert werden. Wer z.B. <a href=\"http:\/\/www.lighttpd.net\/\">Lighttpd<\/a> benutzt, kann das entsprechende CGI-Modul mit<br \/>\n<code>lighty-enable-mod cgi<\/code><br \/>\naktivieren. Zus\u00e4tzlich muss noch folgendes bedingtes Konstrukt zur Konfiguration in der <em>lighttpd.conf<\/em> oder <em>\/etc\/lighttpd\/conf-available\/10-cgi.conf<\/em> hinzugef\u00fcgt werden.<\/p>\n<blockquote><p>$HTTP[\"url\"] =~ \"^\/cgi-bin\/\" {<br \/>\ncgi.assign = ( \"\" =&gt; \"\/usr\/bin\/perl\" )<br \/>\n}<\/p><\/blockquote>\n<p>Die Kommentare werden mit dem Befehl<br \/>\n<code>chronicle --comments=Pfad_zum_Kommentar_Ordner<\/code><br \/>\neingebunden. Es gibt verschiedene Ans\u00e4tze wie man dem Spamproblem entgegnen kann. Da ich bisher noch keine Probleme damit hatte, ein anderes Mal mehr dazu.<\/p>\n<h2>Fazit<\/h2>\n<p>Einige Ideen wie Chronicle aussehen kann, findet ihr <a href=\"http:\/\/blog.steve.org.uk\/\">im Blog des Machers<\/a>, Steve Kemp, auf der <a href=\"http:\/\/www.carbon-project.org\/\">Homepage von Kai Wasserb\u00e4ch<\/a> oder auf <a href=\"http:\/\/linuxiuvat.de\/news\/\">meiner News-Seite<\/a> bei linuxiuvat.de.<br \/>\nDie Themen lassen sich mit etwas HTML-Kenntnissen gut anpassen. Chronicle ist schlicht, aber dadurch meiner Meinung auch einfach zu erlernen. Man erh\u00e4lt mit lediglich einem Befehl ein vollst\u00e4ndiges Blog mit Schlagworten, Feeds und Archiven, dass ressourcenschonend und schnell ist. Wem das noch nicht zusagt, sollte auch einen Blick auf <a href=\"https:\/\/www.gambaru.de\/blog\/2012\/04\/21\/die-eigene-homepage-cms-blogkompilierer-und-statisches-xhtml\/\">die Alternativen<\/a> werfen.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Chronicle ist ein sogenannter Blogkompilierer, der aus einfachen Textdateien, Markdown und HTML ein vollst\u00e4ndiges Blog mit Schlagworten, Archiv und RSS-Feeds erstellen kann. Ich hatte urspr\u00fcnglich vorgesehen alle Webseiten von Hand zu erstellen, da linuxiuvat.de haupts\u00e4chlich zur Beschreibung von Spielen, Dokumentation und f\u00fcr Statistiken gedacht ist, f\u00fcr die ein CMS mit dynamischen Inhalten \u00fcber das Ziel &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/gambaru.de\/blog\/2012\/04\/21\/chronicle-bloggen-mit-dem-blogkompilierer\/\" class=\"more-link\"><span class=\"screen-reader-text\">\u201eChronicle: Bloggen mit dem Blogkompilierer\u201c<\/span> weiterlesen<\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[6],"tags":[39,53,108,202,204],"_links":{"self":[{"href":"https:\/\/gambaru.de\/blog\/wp-json\/wp\/v2\/posts\/6886"}],"collection":[{"href":"https:\/\/gambaru.de\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/gambaru.de\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/gambaru.de\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/gambaru.de\/blog\/wp-json\/wp\/v2\/comments?post=6886"}],"version-history":[{"count":1,"href":"https:\/\/gambaru.de\/blog\/wp-json\/wp\/v2\/posts\/6886\/revisions"}],"predecessor-version":[{"id":10712,"href":"https:\/\/gambaru.de\/blog\/wp-json\/wp\/v2\/posts\/6886\/revisions\/10712"}],"wp:attachment":[{"href":"https:\/\/gambaru.de\/blog\/wp-json\/wp\/v2\/media?parent=6886"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/gambaru.de\/blog\/wp-json\/wp\/v2\/categories?post=6886"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/gambaru.de\/blog\/wp-json\/wp\/v2\/tags?post=6886"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}