Dienst:Homepage: Unterschied zwischen den Versionen

Aus Freifunk Köln, Bonn und Umgebung
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
(github -> gitlab)
Zeile 1: Zeile 1:
[[Kategorie:Dienste]][[Kategorie:Infrastruktur]]
[[Kategorie:Dienste]][[Kategorie:Infrastruktur]]
{{:Mithilfe}}




Zeile 8: Zeile 6:


Q: Wie ändere ich was?
Q: Wie ändere ich was?
# Fork auf github erstellen.
# Eigenen Branch auf gitlab erstellen (https://git.kbu.freifunk.net/ff-kbu/website), d.h. auf den edit-Knopf drücken
# checkout & Aufsetzen der Entwicklungsumgebung (wie unten beschrieben)
# checkout & Aufsetzen der Entwicklungsumgebung (wie unten beschrieben)
# Ändern und testen
# Ändern und testen
# Pull-Request mit den Änderungen erstellen
# Merge-Request mit den Änderungen erstellen


== Technik ==
== Technik ==
Zeile 23: Zeile 21:


== Workflow ==
== Workflow ==
* Änderungsvorschläge werden als Pull-Request gegen das github-Repo erstellt (https://github.com/ff-kbu/website - Branch: master)
* Änderungsvorschläge werden als Pull-Request gegen das github-Repo erstellt (https://git.kbu.freifunk.net/ff-kbu/website - Branch: master)
* Nach dem 4-Augen Prinzip wird der Pull-Request merged -- Kommentare, fragen werden dort hinterlegt
* 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)
* Existiert eine Änderung, so wird die Homepage über gitlab-ci deployed (https://git.kbu.freifunk.net/ff-kbu/website/pipelines)


== Einrichten der Entwicklungsumgebung ==
== Einrichten der Entwicklungsumgebung ==
Zeile 36: Zeile 34:
<pre>
<pre>
apt-get install ruby1.9.1 jekyll bundler git imagemagick
apt-get install ruby1.9.1 jekyll bundler git imagemagick
git clone https://github.com/ff-kbu/website.git
git clone https://git.kbu.freifunk.net/ff-kbu/website.git
bundle install
bundle install
</pre>
</pre>
Zeile 50: Zeile 48:
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
git clone https://git.kbu.freifunk.net/ff-kbu/website.git
bundle install
bundle install
</pre>
</pre>
Zeile 66: Zeile 64:
Aktuellen Source der Page clonen
Aktuellen Source der Page clonen
<pre>
<pre>
git clone https://github.com/ff-kbu/website.git
git clone https://git.kbu.freifunk.net/ff-kbu/website.git
</pre>
</pre>


Zeile 75: Zeile 73:
git add README.md
git add README.md
git commit -m "first commit"
git commit -m "first commit"
git remote add origin https://github.com/username/repo-name.git
git remote add origin https://git.kbu.freifunk.net/username/repo-name.git
git push -u origin master
git push -u origin master
</pre>
</pre>
== 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

Version vom 12. Januar 2020, 19:31 Uhr


Dokumentation zur Homepage

Q: Wie ändere ich was?

  1. Eigenen Branch auf gitlab erstellen (https://git.kbu.freifunk.net/ff-kbu/website), d.h. auf den edit-Knopf drücken
  2. checkout & Aufsetzen der Entwicklungsumgebung (wie unten beschrieben)
  3. Ändern und testen
  4. Merge-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.
Dabei sollte die Einleitung auf der Homepage nur ein oder zwei Absätze lang sein, der Rest ist dann auf der folgeseite zu lesen. Das bitte in der Zukunft beachten.

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://git.kbu.freifunk.net/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://git.kbu.freifunk.net/ff-kbu/website.git
bundle install

How to Jekyll

Soweit so gut, jetzt können wir:

bundle exec jekyll build 	// die Seite bauen
bundle exec jekyll -w	        // uns Änderungen anzeigen lassen
bundle exec 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://git.kbu.freifunk.net/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://git.kbu.freifunk.net/username/repo-name.git
git push -u origin master