# 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:

```zsh
[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:


```zsh
[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:

```zsh
brew install hugo
```

Erfolgskontrolle:
```zsh
$ 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:

```zsh
$ 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

```zsh
$ hugo new homepage/mynewpost.md
```
tbc

## Lokales Testen

Starten der Vorschau im lokalen Webserver:

```zsh
$  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).