Aus diesem Repository wird die Webseite openstreetmap.de generiert.
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 :)
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.