Dienst:Homepage: Unterschied zwischen den Versionen

Aus Freifunk Köln, Bonn und Umgebung
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
Zeile 20: Zeile 20:
== Einrichten der Entwicklungsumgebung ==
== Einrichten der Entwicklungsumgebung ==
=== Debian Stable / Wheezy ===  
=== Debian Stable / Wheezy ===  
* <tt>apt-get install ruby1.9 jekyll bundler git ImageMagick</tt>
<pre>
* <tt>git clone https://github.com/</tt><Dein_Account><tt>/website</tt>
mkdir /verzeichnis/zur/website/
* Im Verzeichnis website: <tt>bundle install</tt>
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>
Nun werden die notwenigen Jekyll Komponenten installiert. Vorraussetzung ist [https://www.macports.org/ Macports].
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 haben
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?

  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

Workflow

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