Dienst:Homepage: Unterschied zwischen den Versionen
Zur Navigation springen
Zur Suche springen
D0b (Diskussion | Beiträge) |
D0b (Diskussion | Beiträge) Keine Bearbeitungszusammenfassung |
||
Zeile 33: | Zeile 33: | ||
<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 | ||
bundle install | bundle install | ||
Zeile 45: | Zeile 42: | ||
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 haben | jekyll serve -w // Einen lokalen Server starten auf port 4000 (http://0.0.0.0:4000) auf dem wir eine Vorschau haben | ||
</pre> | |||
== Git Repo == | |||
Aktuellen Source der Page clonen | |||
<pre> | |||
git clone https://github.com/ff-kbu/website.git | |||
</pre> | |||
Wer einen Account auf github hat, kann so von der Shell auf ein neues Repo erstellen: | |||
<pre> | |||
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 | |||
</pre> | </pre> | ||
Version vom 9. März 2015, 02:16 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
- apt-get install ruby1.9 jekyll bundler git ImageMagick
- git clone https://github.com/<Dein_Account>/website
- Im Verzeichnis website: bundle install
OSX
Getestet unter OS 10.6.8
mkdir /verzeichnis/zur/website/ cd /verzeichnis/zur/website/
Nun werden die notwenigen Jekyll Komponenten installiert. Vorraussetzung ist Macports.
sudo port install ruby1.9 gem1.9 ImageMagick git-core Jekyll gem1.9 install bundler bundle install
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 haben
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