blog

Hugo-basierter Blog mit dem Theme hugo-scroll. Der gesamte Content, liegt in disem Repository. Das Editieren erfolgt lokal, das Publishing per rsync.

Setup Uberspace

Nur dieses git-Repository. Das Publishing erfolgt in das Website-Vezeichnis /home/kollegen/html/tempelgold. Der zugreifende Gitea-User muss den ssh-Key konfigurierte haben, damit git und rsync per ssh genutzt werden kann. Hugo wird nicht benötigt; stattdessen wird der fertige Content hochgeladen.

Subdomain

Die Seite soll unter der Subdomain tempelgold.kollegen.uber.space erreichbar sein (und nicht unter kollegen.uber.space/tempelgold).

Einrichten der Subdomain:

[kollegen@despina ~]$ uberspace web domain add tempelgold.kollegen.uber.space

Der Webcontent für diese Subdomain muss in einem gleichnamigen Verzeichnis neben dem html-Verzeichnis liegen. Dieser Content wird per lokalem Skript deploy.sh angelegt. Es wird einmalig das leere Verzeichnis angelegt und ein symbolischer Link im Home-Verzeichnis erstellt:

[kollegen@despina ~]$ mkdir /var/www/virtual/kollegen/tempelgold.kollegen.uber.space
[kollegen@despina ~]$ ln -s /var/www/virtual/kollegen/tempelgold.kollegen.uber.space ~/tempelgold.kollegen.uber.space

Lokales Setup

Benötigte Tools:

• hugo
• git (wird vorausgesetzt)
• rsync (wird vorausgesetzt)

Hugo wie auf https://gohugo.io/installation/macos/, beschrieben mit brew installieren:

brew install hugo

Erfolgskontrolle:

$ hugo version
hugo v0.137.1+extended darwin/amd64 BuildDate=2024-11-05T11:49:09Z VendorInfo=brew

Das git-Repository auschecken. Es wird in ~/kollegen/tempelgold gearbeitet.

$ mkdir ~/kollegen/tempelgold
$ cd ~/kollegen
$ git clone kollegen@kollegen.uber.space:website/tempelgold.git
$ cd tempelgold

Das Theme hugo-scroll ist als submodule eingebunden, also nicht Teil des repos - das Verzeichnis themes/hugo-scroll ist dementsprechend leer. Laden von hugo-scroll:

$ git submodule init
Submodule 'themes/hugo-scroll' (https://github.com/zjedi/hugo-scroll.git) registered for path 'themes/hugo-scroll'
$ git submodule update
Cloning into '/home/chris/prj/kollegen/blog/themes/hugo-scroll'...
Submodule path 'themes/hugo-scroll': checked out '9d458d193fee9dd35843baddd41e1ba99c29aef4'

Konfiguration des Blogs

Es gibt nur die Homepage-Beiträge.

Neuen Bereich erstellen

$ hugo new homepage/mynewpost.md

tbc

Lokales Testen

Starten der Vorschau im lokalen Webserver:

$  hugo server -D 
(...)
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop

Wird nicht automatisch aktualisiert: config.toml ändern und abspeichern. Webclient-Cache löschen.

Update der Website

Hugo generiert den Content nach /public.

$ hugo
Start building sites … 
(...)
Total in 47 ms

Das Skript startet hugo und kopiert anschließend /public in den Webcontent-Bereich auf Uberspace:

$ ./deploy

Redaktion

Vollformat-Bilder sind auf 700px Blog-Breite zu skalieren und auf ~75% zu komprimieren, sie werden nicht von Hugo geändert (da keine Resource).