openstreetmap.de Webseite

Aus diesem Repository wird die Webseite openstreetmap.de generiert.

Inhalt anlegen

Die openstreetmap.de-Website wird aus den Inhalten, die in den untergeordneten Verzeichnissen existieren, erzeugt.

Um einen neuen Artikel anzulegen, muss eine neue Datei in content mit der Endung .md (Markdown) angelegt werden. Ein Artikel beginnt mit den Metadaten ganz oben:

---
title: "Dies ist ein Titel"
date: "2019-02-29T15:00:00+02:00"
author: "Marta Musterfrau"
---

Anschließend kann der Inhalt geschrieben werden, z.B.

## Unterüberschrift

Hier ist etwas Text.

Und hier ist ein neuer Absatz.

Statische Inhalte wie Bilder und dergleichen, die nicht von Hugo interpretiert werden sollen, gehören unter static, nicht nach content.

Lokal kann die Webseite mithilfe von hugo generiert werden: Hugo Installationsanweisungen. Anschließend kann im Verzeichnis hugo serve ausgeführt werden. Dies startet einen lokalen Webserver, der üblicherweise unter http://localhost:1313 zu erreichen ist.

Im Zweifelsfall Inhalte anlegen und Pull Request öffnen, wir finden eine Lösung :)

Generierung der Webseite

Jedes mal, wenn dieses Repository auf Github geändert wird (entweder weil man auf Github eine Datei ändert oder wenn man in den main Branch pushed), dann wird die Webseite neu generiert und auf den Webserver übertragen. Das passiert über die "Github actions"-Funktion, die unter .github/workflows/build-and-deploy.yml konfiguriert wird. Der neue Inhalt ist dann nach wenigen Sekunden auf dem Webserver verfügbar.