2.5 KiB
kollegen-hugo
Die Kolleenrunden-Website besteht aus statischen Webseiten, die mittels dem Hugo-Framwork generiert werden. Es gibt zwei Repositories: kollegen-posts für die Inhalte der Blog-Beiträge und kollegen-hugo, was die Generierungsgrundlage beinhaltet. Um redaktionell mitzubloggen, benötigt man nur das Posts- Repository. Die Anleitung dazu findet man dort.
Diese Repository wird für Website-Bearbeitung benötigt, was im Folgenden beschrieben ist.
Lokales Setup
Klappt auf Linux, Windows und Mac. Beschrieben ist es hier für Linux.
Voraussetzungen:
- Installierter git-Client: https://git-scm.com/downloads
- Gitea-User aus dem Owners-Team
Verzeichnis anlegen
Die Installation kann in einem beliebigen Verzeichnis erfolgen, wir nehmen ~/kred und installieren dort das aktuelle Hugo-Release und das kollegen-hugo/Repository, jeweils in ein Unterverzeichnis:
$ mkdir ~/kred
$ cd ~/kred
$ mkdir hugo
Hugo-Release installieren
Das aktuelles hugo-Release für seine Zielplattform findet man auf gitHub: [https://github.com/gohugoio/hugo/releases/latest].
Wenn das aktuelle Hugo-Relase 0.76.4 ist, gilt für Linux:
$ wget https://github.com/gohugoio/hugo/releases/download/v0.76.4/hugo_0.76.4_Linux-64bit.tar.gz
...
hugo_0.76.4_Linux-64bit.tar. 100%[============================================>] 13,31M 1,54MB/s in 25s
2020-10-13 21:09:43 (547 KB/s) - »hugo_0.76.4_Linux-64bit.tar.gz« gespeichert [13953675/13953675]$ tar -xvf hugo_0.76.4_Linux-64bit.tar.gz --directory hugo
$ rm hugo_0.76.4_Linux-64bit.tar.gz
Nach erfolgreicher Installation sollte Hugo seine Version ausgeben können:
$ hugo/hugo version
Hugo Static Site Generator v0.76.4-50DFE40B linux/amd64 BuildDate: 2020-10-12T08:36:20Z
Web-Repository holen
Das Repository wird geklont und installiert sich im Unterverzeichnis:
git clone https://kollegen.uber.space/gitea/kollegenrunde/kollegen-hugo.git
ls kollegen-hugo
archetypes config.toml data layouts LICENSE README.md resources static themes
Als Theme wird Ananke verwendet. Dieses wurde einmalig als Submodul eingebunden:
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
Content/Repository holen (Posts)
Benötigt man zur Entwicklung auch den Content, so wird dieser neben dem Web-Repository installiert:
git clone https://kollegen.uber.space/gitea/kollegenrunde/kollegen-posts.git