Dienst:Homepage

Dokumentation zur Homepage

• URL: https://kbu.freifunk.net

Q: Wie ändere ich was?

1. Fork auf github erstellen.
2. checkout & Aufsetzen der Entwicklungsumgebung (wie unten beschrieben)
3. Ändern und testen
4. Pull-Request mit den Änderungen erstellen

Technik

• Jekyll als Offline / Blogging System. Details: http://jekyllrb.com/

Blogposts

• Werden in Markdown geschrieben [1]
• Aus semantischen Gründen stehen nur die Überschrifen h1-h3, respektive # - ### in markdown zur Verfügung, beim Rendern werden diese verarbeitet
• Mittels <!--break--> kann ein Beitrag Einleitung und restlichen Text unterteilt werden.

Workflow

• Änderungsvorschläge werden als Pull-Request gegen das github-Repo erstellt (https://github.com/ff-kbu/website - Branch: master)
• Nach dem 4-Augen Prinzip wird der Pull-Request merged -- Kommentare, fragen werden dort hinterlegt
• Existiert eine Änderung, so wird die Homepage stündlich automatisch über jenkins deployed (https://apps.jluehr.de/jenkins/view/KBU/job/kbu-jenkins-deploy/configure)

Einrichten der Entwicklungsumgebung

Debian Stable / Wheezy

mkdir /verzeichnis/zur/website/
cd /verzeichnis/zur/website/

Notwendige Jekyll Komponenten installieren:

apt-get install ruby1.9.1 jekyll bundler git imagemagick
git clone https://github.com/ff-kbu/website.git  
bundle install

OSX

Getestet unter OS 10.6.8

mkdir /verzeichnis/zur/website/
cd /verzeichnis/zur/website/

Notwendige Jekyll Komponenten installieren, vorraussetzung ist Macports:

sudo port install ruby1.9 gem1.9 ImageMagick git-core Jekyll
gem1.9 install bundler
git clone https://github.com/ff-kbu/website.git  
bundle install

How to Jekyll

Soweit so gut, jetzt können wir:

jekyll build 	// die Seite bauen
jekyll -w	// uns Änderungen anzeigen lassen
jekyll serve -w	// Einen lokalen Server starten auf port 4000 (http://0.0.0.0:4000) auf dem wir eine Vorschau 
                // der Seite betrachten können. 

Git Repo

Aktuellen Source der Page clonen

git clone https://github.com/ff-kbu/website.git  

Wer einen Account auf github hat, kann so von der Shell auf ein neues Repo erstellen:

touch README.md
git init
git add README.md
git commit -m "first commit"
git remote add origin https://github.com/username/repo-name.git
git push -u origin master

Autodeployment via jenkins

Build & Deployment der Homepage

• Schedule: H/5 * * * *
• Kommando

/usr/local/bin/jekyll build
rsync -Havc -e "ssh -p 2222 -l www-data-jenkins" ./_site/ kbu.freifunk.net:/srv/apache2/kbu.freifunk.net/htdocs