Dienst:Homepage

Aus Freifunk Köln, Bonn und Umgebung
Zur Navigation springen Zur Suche springen


Dokumentation zur Homepage

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

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

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