$(blogging the nerd way)…soll in seiner Grundform veröffentlicht werden können, ohne den Anschein zu erwecken, es sei mit Formatierungsbefehlen versehen.
# [Markdown](http://markdown.de/)
## Formatierte Texte so einfach wie möglich:
Damit sie jede(r) *schnell*
1. lesen und
3. schreiben
kann.…ist ein in
Rubygeschriebener Generator für statische Websiten.
Jekyll ist ein Kommandozeilen-Programm.
Es generiert mittels der Ruby-Umgebung aus Text-Dateien statische Webseiten.
Dafür nutzt es die Liquid-Sprache für Templates. So können in Jekyll eigene Filter und Tags für kleine Aufgaben eingesetzt werden.
Einstellungen werden in der zentralen Datei _config.yml gespeichert.
$ sudo apt-get install ruby ruby-dev jekyll$ ruby -e "$(curl -fsSL https://raw.github.com/Homebrew/homebrew/go/install)" # installiert den Homebrew Paketmanager
$ brew install brew-gem # installiert den Ruky-Paketmanager
$ brew gem jekyll # installiert JekyllStruktur anlegen und in den Ordner wechseln
$ jekyll new jekyll-demo && cd jekyll-demoSeite generieren
$ jekyll build # (--destination _testsite)Testseite starten
$ jekyll serve # (--port 8000) (--watch).
├── _drafts (Entwürfe / bei Bedarf anlegen)
| ├── eine-Idee-zur-Rettung-der-Welt.textile
| └── noch-eine-Idee.markdown
├── _includes (HTML-Fragmente, die eingebunden werden können)
| ├── footer.html
| ├── head.html
| └── header.html
├── _layouts (die Templates)
| ├── default.html
| ├── page.html (für einzelne Seiten)
| └── post.html (für Blog-Posts)
├── _posts (hier kommen alles Blogeinträge hinein)
| └── 2014-05-06-welcome-to-jekyll.markdown
├── _site (hier generiert Jekyll die Seiten hinein)
├── css
| └── main.css (das Style-Sheet des Blogs)
├── .gitignore (für git)
├── _config.yml (Konfiguration)
├── about.md (Beispiel einer einzelnen Seite)
├── feed.xml (RSS-Feed)
└── index.html (das Template für die Index-Seite)_config.ymlname: Bloggen wie ein Nerd # Platz für Kreativität
highlighter: rouge # für farbige Anzeige von Code
markdown: kramdown # seit Jekyll 2.0 default
# zusätzliche, optionale Parameter:
timezone: Europe/Berlin
future: false # für vorbereitete Posts
url: # wenn nicht sicher, dann frei lassen
permalink: /:categories/:year/:month/:title.html
paginate: 10 # n Posts auf der Index-Seite
author: Thomas Friese
description: Presentation für die rp14
disqus_shortname:
include: [".htaccess"] # für Dateien mit "." oder "_"
exclude: ["_ORDNER_", "_DATEI_"]Datei 2014-05-07-toller-titel.md in _posts oder _drafts anlegen.
---
layout: post # Template für Blogpost oder Seite
title: "Mein erster Post"
date: 2014-05-07 15:15:00
categories: jekyll update
tags: [eins, zwei]
---
MARKDOWN_INHALTDer Kopf zwischen den ----Zeilen heißt “Front-matter”.
Die Parameter im Front-matter werden vom Liquid-Template abgerufen.
layout: bestimmt die Art der HTML-Seite aus dem Ordner _layouts.
Im Template wird der Parameter title mit {{ page.title }} abgerufen.
title: "Mein erster Post"wird zu HTML gewandelt
<title>Mein erster Post</title>und aus
title: "Mein erster Post"
date: 2014-05-07 15:15:00
categories: jekyll updatewird die URL
/jekyll/update/2014/05/07/mein-erster-post.html.
Die Parameter
tags: [eins, zwei]werden mit
{% for tag in page.tags %}
<a href="/tag/{{ tag | escape }}.html">{{ tag }}</a><br />
{% endfor %}in _layouts/default.html zu folgendem HTML
<a href="/tag/eins.html">eins</a>
<a href="/tag/zwei.html">zwei</a>…ist ein schnelles, dezentrales System zum Verwalten verschiedener Versionen von Projekten.
Quellcode einsehbarNeues git-Hauptverzeichnis auf dem Server anlegen (remote repository):
$ mkdir PROJEKT.git # Projekt-Ordner namens "PROJEKT.git" anlegen
$ cd PROJEKT.git # in den Ordner wechseln
$ git init -bare # leeres git repository anlegenAm eigenen Rechner den Arbeitsordner anlegen und initialisieren:
$ cd PROKEKT # in den Arbeitsordner namens "PROJEKT" wechseln
$ git init # Verzeichnis an git anmelden
$ git remote add -f MASTER NAME@SERVER:/PFAD/PROKEKT.git
# Verzeichnisse verbindenÄnderungen an Server übertragen (commit):
$ git add -A # alle Änderungen lokal mitteilen
$ git commit # die Änderungen mit Server abgleichen
$ git push # alles zum Server übertragenMit weiteren Computern arbeiten:
$ git clone NAME@SERVER:/PFAD/PROKEKT.git PROJEKT # downloadÄnderungen vom Server abholen:
$ git pullEinen privaten und einen öffentlichen Schlüssel generieren
[erna@Heimrechner ~]$ ssh-keygen -t rsa
# ...
# Your identification has been saved in /home/erna/.ssh/id_rsa.
# Your public key has been saved in /home/erna/.ssh/id_rsa.pub.
# ...Dem Server den öffentlichen Key übergeben
$ rsync -v -e ssh --archive ~/.ssh/id_rsa.pub _SERVER_:new_key.pub
$ ssh _SERVER_ "test -d .ssh || mkdir .ssh && chmod 700 .ssh"
$ ssh _SERVER_ "cat new_key.pub >> .ssh/authorized_keys"
$ ssh _SERVER_ "shred -u new_key.pub"
$ ssh-add ~/.ssh/id_rsa.pubGit-Hooks lösen bei Git-Aktionen andere Aktionen aus.
Ein Hook ist ein Skript, dass sich im Git-Unterverzeichnis hooks befindet. Die Skriptsprache wird am Anfang des Skriptes festgelegt (z.B. #!/bin/bash).
#!/bin/sh
GIT_WORK_TREE=/PFAD_HTML_ORDNER git checkout -f
LC_ALL="en_US.UTF-8" /.../bin/jekyll build -s \
/PFAD_HTML_ORDNER -d /PFAD_HTML_ORDNER/_site
exitGIT_PROJEKT/hooks/post-receive
löst auf dem Server den Shell-Befehl jekyll build aus
Zum Testen auf dem Computer überwacht Jekyll veränderungen und generiert sie neu mit dem Befehl
$ jekyll serve --watchUnd damit Jekyll auf dem Server im Hintergrund läuft
$ jekyll serve -B # (--detach)Jekyll mit Apache braucht eine .htaccess-Datei
<IfModule mod_rewrite.c>
Options +FollowSymlinks
RewriteEngine On
RewriteBase /
RewriteRule (.*) http://localhost:4000/$1 [QSA,P]
</IfModule>$(blogging the nerd way)