# blog

Hugo-basierter Blog mit dem Terminal-Theme. 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. Dort muss die index.html liegen, da es die Startseite der Domain darstellt. Der zugreifende Gitea-User muss den ssh-Key konfigurierte haben, damit git und rsync per ssh genutzt werden kann.

## Lokales Setup

Benötigte Tools:

- hugo
- git
- rsync

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

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

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

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


Sollen auch Icons erstellt werden, wird noch das website-git benötigt:

    $ git clone kollegen@kollegen.uber.space:website/website.git


## Konfiguration des Blogs

Es gibt posts und tiles. Tiles stellen die Link-Kacheln dar. 

## Neuen Post erstellen

Eine Bundle-Post:

    $ hugo new posts/RFduino-Implementation-of-DDO/index.md

## Lokales Testen

Starten der Vorschal 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

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