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

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


```console
[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
- rsync

Es wird eine aktuelle Hugo-Version ~/bin/hugo erwartet (Standard-Version, extended wird nicht benötigt, glaube ich).  
Das git-Repository auschecken. Es wird in ~/prj/kollegen/tempelgold gearbeitet.

    $ mkdir ~/prj/kollegen/tempelgold
    $ cd ~/prj/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/janraasch/hugo-scroll) 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).