Webseite

Aus RaumZeitLabor Wiki
Wechseln zu: Navigation, Suche
       
Webseite

Release status: stable [box doku]

Description Die neue Webseite des Vereins.
Author(s)  else, silsha
Last Version  1.0
Platform  World Wide Web
Download  http://github.com/raumzeitlabor/rzl-homepage

else hat in den vergangenen acht Jahren an einer neuen Webseite geschraubt. Nun ist sie fertig. \o/

Anleitungen

Generell würden wir dich bitten, Änderungen nicht direkt auf das Original-Repository zu pushen, sondern immer einen Pull Request zu stellen. Hierzu musst Du das Repository erstmal in deinen Github-Account forken. [1].

Alle Änderungen werden von Travis CI im Hintergrund getestet. Für jeden Pull Request votet Travis dann, ob deine Änderungen gut oder böse ist. Nur gute Änderungen werden akzeptiert.

Blogeinträge

Um einen Blogeintrag anzulegen gehst Du wie folgt vor:

  1. Erstelle eine neue Datei im Verzeichnis app/_posts mit dem Dateinamen JAHR-MONAT-TAG-title-bindestrich-foo-bar.md
  2. Schreibe deinen Blogeintrag und benutze hierfür die Markdown-Syntax. http://daringfireball.net/projects/markdown/syntax
  3. Checke die neu erstelle Datei ein: git add app/_posts/….md
  4. optional: Checke dazugehörige Dateien mit ein (z.B. Bilder). Achte darauf, dass diese möglichst < 512 KB sind.
  5. Erstelle einen neuen Commit mit einer möglichst aussagekräftigenden Commitmessage (Englisch bevorzugt) und pushe sie in dein geklontes Repository.
  6. Stelle einen Pull Request und bitte jemanden, diesen zu reviewen und freizuschalten. [2]

Events

Wir benutzen einen CalDAV-Server zur Verwaltung unserer Termine. Um selber Events anzulegen benötigt ihr einen Kalenderclient der CalDAV unterstützt (hier eine Liste.)

Den read-only-Feed des Kalenders erhaltet ihr hier: https://raumzeitlabor.de/events/ical/

Die Logindaten zum CalDAV-Server erhältst du von einem beliebigen Laboranten, der sie schon kennt.

Der neue Kalendereintrag muss einen Titel, ein Start- und Enddatum, einen Ort (bitte nur die zertifizierten Orte™ aus der Liste unten verwenden) und eine Beschreibung haben.

Zertifizierte Orte™

  • RaumZeitLabor (falls der gesamte Space eingenommen wird)
  • Hauptraum
  • Workshopraum
  • Werkstatt
  • Fablab
  • E-Ecke
  • Küche
  • Olymp

Falls mehrere Orte von einem Event benötigt werden, die Orte bitte mit Komma trennen. Das BLOC-Team behält sich vor, Verstöße rigorus zu Verfolgen und zur Anzeige zu bringen.

Einzelseiten

Einzelseiten werden im Ordner /app/[SEITENNAME]/ angelegt. Die Seiten müssen entweder als HTML (index.html) oder als Markdown (index.md) angelegt werden. Bei einfachen, textlastigen Seiten ist Markdown fast immer zu bevorzugen.

  1. Erstelle einen neuen Ordner im Verzeichnis app/
  2. Erstelle eine neue Datei im Verzeichnis app/[SEITENNAME] namens index.html oder index.md (s. oben)
  3. Checke die neu erstelle Datei ein: git add app/[SEITENNAME]/
  4. Optional: Checke dazugehörige Dateien mit ein (z.B. Bilder). Achte darauf, dass diese möglichst < 512 KB sind.
  5. Erstelle einen neuen Commit mit einer möglichst aussagekräftigenden Commitmessage (Englisch bevorzugt) und pushe sie in dein geklontes Repository.
  6. Stelle einen Pull Request und bitte jemanden, diesen zu reviewen und freizuschalten. [3]

Disclaimer

Das BLOC-Team behält sich vor, dreckige Commits rigorus zu Verfolgen und zur Anzeige zu bringen. Hierzu zählen insbesondere:

  1. Direktes pushen auf den master Branch
  2. Nichtssagende Commitmessages
  3. Große Dateien einchecken
  4. Build brechen
  5. push --force