Dienst:Homepage: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
D0b (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
D0b (Diskussion | Beiträge) |
||
Zeile 20: | Zeile 20: | ||
== Einrichten der Entwicklungsumgebung == | == Einrichten der Entwicklungsumgebung == | ||
=== Debian Stable / Wheezy === | === Debian Stable / Wheezy === | ||
<pre> | |||
mkdir /verzeichnis/zur/website/ | |||
cd /verzeichnis/zur/website/ | |||
</pre> | |||
Notwendige Jekyll Komponenten installieren: | |||
<pre> | |||
apt-get install ruby1.9 jekyll bundler git ImageMagick | |||
git clone https://github.com/ff-kbu/website.git | |||
bundle install | |||
</pre> | |||
=== OSX === | === OSX === | ||
Zeile 30: | Zeile 37: | ||
cd /verzeichnis/zur/website/ | cd /verzeichnis/zur/website/ | ||
</pre> | </pre> | ||
Notwendige Jekyll Komponenten installieren, vorraussetzung ist [https://www.macports.org/ Macports]: | |||
<pre> | <pre> | ||
sudo port install ruby1.9 gem1.9 ImageMagick git-core Jekyll | sudo port install ruby1.9 gem1.9 ImageMagick git-core Jekyll | ||
gem1.9 install bundler | gem1.9 install bundler | ||
git clone https://github.com/ff-kbu/website.git | |||
bundle install | bundle install | ||
</pre> | </pre> | ||
=== How to Jekyll === | |||
Soweit so gut, jetzt können wir: | Soweit so gut, jetzt können wir: | ||
<pre> | <pre> | ||
jekyll build // die Seite bauen | jekyll build // die Seite bauen | ||
jekyll -w // uns Änderungen anzeigen lassen | 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 | 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. | |||
</pre> | </pre> | ||
Version vom 9. März 2015, 02:22 Uhr
Dokumentation zur Homepage
Q: Wie ändere ich was?
- Fork auf github erstellen.
- checkout & Aufsetzen der Entwicklungsumgebung (wie unten beschrieben)
- Ändern und testen
- Pull-Request mit den Änderungen erstellen
Technik
- Jekyll als Offline / Blogging System. Details: http://jekyllrb.com/
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 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