Add README

Signed-off-by: Chris Fiege <chris@tinyhost.de>

README.md

+# HackenOpenAir.de
+
+Dieses Repository enthält die Quellen zur Webseite hackenopenair.de.
+
+Hackenopenair.de wird mit dem static-site-generator [Flamingo](https://flamingo-web.org) erstellt.
+
+## Deployment
+
+Die Webseite wird ausgerollt, sobald du Änderungen auf die Branches `master` oder `testbed` pushed.
+
+Der Branch `master` wird auf https://hackenopenair.de ausgerollt.
+Der Branch `testbed` wird auf https://testbed.hackenopenair.de ausgerollt.
+
+Das Ausrollen dauert in der Regel zwischen ein und zwei Minuten.
+Den Prozess kann man [im Gitlab](https://gitli.stratum0.org/HOA/homepage/-/jobs) verfolgen.
+
+Möchtest du deine Änderungen nicht veröffentlichen, so lege sie auf einen anderen branch oder
+forke das Projekt.
+
+## Inhalte auf deinem Rechner schreiben
+
+Inhalte werden im Ordner `content/` geschrieben.
+In der Ausgabe werden zwei lange Webseiten (und das Impressum) erzeugt.
+Zu welcher langen Seite ein `rst`-Dokument gehört wird in den Metadaten festgelegt.
+Dazu die Anfahrtsbeschreibung als Beispiel:
+
+```
+menu: Anfahrt
+group: index
+order: 3
+template: base.html
+
+
+```
+
+Dieses Dokument wird in die Seite `index` (was bei uns die Sprache `de` ist) gerendert.
+Es taucht dabei an der 3. Position auf der Seite auf und wird im Menü als `Anfahrt`
+dargestellt.
+(Die Angabe des Templates hat hier keine Auswirkung.)
+Die Metadaten werden immer mit deiner doppelten Leerzeile abgeschlossen.
+Anschließend folgt in `rst` der eigentliche Artikel.
+
+
+## Webseite auf deinem Rechner ansehen
+
+Um die Webseite auf deinem Rechner zu testen hast du zwei Möglichkeiten:
+
+### HTML erzeugen
+
+Dies hat die geringsten Anforderungen an deine Arbeitsumgebung.
+Mache in diesem Verzeichnis ein `make html` und flamingo erzeugt die HTML-
+Ausgabe der Webseite:
+
+```
+chris@dauntless $ make html
+. env/bin/activate && \
+mkdir -p theme/static/css/ && \
+pysassc -t compressed theme/sass/*.scss theme/static/css/hoa.css
+. env/bin/activate && \
+flamingo build -p .
+```
+
+Anschließend liegen die Ausgaben in `output/`
+
+### Live-Server
+
+Für den Live-Server benötigst du mindestens `python 3.5.3`.
+
+Starte nun den Live-Server:
+```
+chris@dauntless $ make server 
+. env/bin/activate && \
+mkdir -p theme/static/css/ && \
+pysassc -t compressed theme/sass/*.scss theme/static/css/hoa.css
+. env/bin/activate && \
+flamingo server -p . --port=8080 --host=0.0.0.0
+starting server on http://localhost:8080/live-server/
+```
+
+Rufe nun in deinem Browser `http://localhost:8000/` auf, um die
+Webseite zu sehen.
+Unter `http://localhost:8080/live-server` bekommst du zusätzlich
+noch den Debugging-Rahmen von flaming: Hier werden z.B. Seiten
+beim Speichern der Quelldatei automatisch neu geladen.