Octopress Workflow

Weil viel magic involviert ist, halte ich hier mal kurz fest, was man fürs Bloggen mit Octopress wissen muss. Schritt 1 ist, falls nicht schon geschehen, einen Account im Stratum 0 GitLab anzulegen und einem Owner der Gruppe stratum0 Bescheid zu sagen, um in die Gruppe aufgenommen zu werden und Schreibrechte zu erhalten.

Octopress ist im Prinzip ein Framework für den Webseitengenerator Jekyll, welcher wiederum in Ruby implementiert ist. Octopress setzt außerdem auf Git als versionsverwaltendenden Datenspeicher. Also benötigte Software installieren und das Git-Repo klonen:

Setup für Debian-basierte Systeme
1
2
3
sudo apt-get install openssh-client git ruby ruby-dev bundler imagemagick
git clone ssh://git@gitli.stratum0.org/stratum0/stratum0-blog.git
cd stratum0-blog; bundle install --deployment

(Falls das jemand auf Windows oder Mac OS schon erfolgreich ausprobiert hat, immer her mit einer Anleitung :))

Posts erstellen und editieren
1
2
3
4
bundle exec rake preview
firefox http://localhost:4000/blog
bundle exec rake new_post"[New Post Title]"
vim source/_posts/2013-09-08-new-post-title.markdown

Solange der rake-preview-Prozess läuft, werden Änderungen an allen Source-Files automatisch und inkrementell geupdatet.

Die verwendete Markdown-Implementierung ist Kramdown (Quick Reference dort). Prinzipiell funktioniert aber auch Nachgucken in anderen Posts ziemlich gut. Wie zum Beispiel in diesem hier für Bilder, Codeschnipsel und Links :)

Weitere nützliche Referenzen:

  • Pro Git, Einführung in das Arbeiten mit Git
  • Jekyll Documentation, ausführliche Infos darüber, wie man z.B. Posts schreibt oder Plugins baut
  • Octopress Documentation, insbesondere die Abschnitte „Using Octopress“ und „Octopress Plugins - Usage & Examples“

Last but not least, den eben angelegten Post committen und aufs GitLab pushen:

Publishing
1
2
3
git add source/_posts/2013-09-08-post-title.markdown
git commit -m 'post: title'
git push