Uberspace on Søren's Blog

My Blogging Workflow as of mid 2025

Sun, 08 Jun 2025 05:00:00 +0000

Recently, Robert wrote about his updated blogging workflow. A good opportunity to update mine, too.

I wrote about my blogging workflow in 2020 and 2023.

Not much has changed since 2023. I use hugo for this blog, hosted in a repository on uberspace.

To create a new article, I …

take my iPhone. I would love to write more on the Mac but noticed that after long working days I barely want to spend more time in front of a „computer“.
go through Reminders & Notes. The 2023 article mentioned that I‘ll try out obsidian for draft creation - which I did and dumped again. Apple Notes is available on all my devices, convenient and thus my choice for creating drafts for blob articles. Reminders came in recently. An article from flip.de recommended using an iOS Shortcut in combination with a reminders list as an alternative to Pocket (the meanwhile shut-down read-later app). When I find something interesting on web, I use the shortcut to create the „read-later-reminder“ and when I am in the mood for writing, I go through that list and create a draft in Notes.
create bullet points in German. Within the note, I start by creating bullet points in German. Although the blog is in English, I find it easier to create the initial draft in German. The 2023 version mentioned that a draft can stay multiple days, weeks or even months in this state - but this is no longer the case, as long as I am not interrupted during the flow.
write paragraphs. Once the initial idea for the type is layer out, I copy them over to iA writer, create the front matter (title, tags, etc.) and start writing - English - paragraphs. I do one (!) proof read iteration.
start the git magic. iA saves the markdown in the local version of the git repository created by the Working Copy app. I open Working Copy, hit „commit & push“ and wait a few seconds. Here, I wrote about the post-hook that builds the blog after every commit.
Done

For me, this works and I noted that more complex (proof-reading and validation) procedures lead to not writing at all. A downside of this process is that the first time I see how the post will look is when it‘s available on the website. Thus, there is often a second iteration of steps 4 and 5, where I fix typos, add missing links or headings. Then, it’s really done 😅

Thank you for subscribing to this RSS feed. https://prev.soeren.me/ is søren's personal blog. If you want to get in touch, please reply to this post via email.

My blogging workflow as of late 2023

Wed, 29 Nov 2023 20:00:00 +0100

In 2019 I wrote an article about the technical background of this blog, and in 2020 there was a type about how I blogged using iPad. Neither of these articles mentioned the complete workflow, starting by how I capture ideas and how they slowly form into larger articles.

The idea of this type is to give this comprehensive overview. Not for you to replicate it, because it is so cool & smooth, but for me to see how things change over time. I feel ok with the current setup. If you have suggestions on how to improve it, please email me (using the button on the bottom of this page).

Collecting ideas

First step is idea collection. Without an idea, there won’t be a blog type. In the past, I used Pocket as a read-later app and pasted interesting articles or podcasts in there. It took some until I realised that links will remain there. I never found the time and commitment to go through the list again. Something simpler was needed. That’s when I switched to „Apple Notes“. The app is available on all my devices, it is fast, easy to use, and has the ability to paste almost anything in it. From the workflow perspective this means that I create a new note for every interesting topic I want to write about, paste links, pictures, and my thoughts into it and then leave it. I don’t care about formatting or well written text at this moment. The only purpose is to collect the ideas I have, when I have them, in an as easy as possible way.

Formulating ideas

Next step is the draft creation. Within my Notes app, I start formulating the raw notes into a text draft. Usually, I re-do this step a couple of times, slightly changing the text with every iteration. Formatting is still typeponed.

Transfer to markdown

Once the text is in a good enough state, I copy it over to a markdown file, add the front matter (proper title, tags, etc.) and links. Using the markdown syntax, the text is formatted for the first time. This goes hand-in-hand with another round of rephrasing sentences or even paragraphs.

Publish

The final step is publishing. This blog is maintained in a git repository, so in order to publish content, the markdown file needs to be added to the repository. If I blog from the MacBook, I just paste the file in the respective directory, run git add . and git commit -m …. If I publish from a mobile device, I add the file to the repository using Working Copy.

The git repository is hosted on uberspace, which allows some magic (aka a git hook), when something is pushed to it. Each time I push changes to the remote server, a small script runs that builds the static site and makes it available at my domain. No need to build the site manually each time - a big time and frustration safer 🙂

Once an article is published, I read it in the browser … and will definitely find some typos, broken links or formulations I don’t like. Ergo, switching apps, fixing it, and then re-publish the changes.

Ideas for the future

From the default-apps event, I learned that many people use obsidian for note taking. I will give it a try and see if it can replace my Notes and Markdown system break.

Thank you for subscribing to this RSS feed. https://prev.soeren.me/ is søren's personal blog. If you want to get in touch, please reply to this post via email.

Hugo mit Git auf dem uberspace nutzen

Fri, 06 Sep 2019 00:00:00 +0000

Vorgeschichte

Vor gar nicht allzu langer Zeit bin ich mit diesem Blog von Ghost zu Jekyll gewechselt. Ghost hat mir eigentlich sehr gut getaugt, auch wenn ich nicht der größte Fan davon war, dass bloggen mit Markdown mit den neueren Versionen einen Klick weiter entfernt war. Außerdem war es für mich immer eine kleine Herausforderung bei neuen Versionen die Abhängigkeiten auf dem Betriebssystem auf dem neusten Stand zu halten und die Datenbank zu migrieren.

Bloggen mit einem Static-Site-Generator schien mir da der nächste logische Schritt. Ich habe also kurz Jekyll ausprobiert und bin schließlich bei Hugo gelandet. Hugo gebe ich aktuell den Vorzug, weil es sich leichter auf einem Windows-PC nutzen lässt und wesentlich schneller ist.

Der geneigte Leser wird wissen, das ich bezüglich Webhoster ein großer Fan der Jungs und Mädels von uberspace bin. Im folgenden also eine kleine Anleitung, um zu meinem aktuellen Setup zu kommen.

Dafür werden wir …

Git und Hugo lokal installieren
Einen neuen Hugo-Blog anlegen
Einen ersten Blog-Artikel schreiben
Den uberspace vorbereiten
Den Blog vom uberspace erstellen lassen
Uns über einen neuen Blog freuen :)

Git und Hugo lokal installieren

Eine Anleitung zur Installation von git findet ihr hier: https://book.git-scm.com
Wie man Hugo installiert, steht auf der Hugo-Webseite: https://gohugo.io/getting-started/installing/

Solltet ihr, wie ich aktuell, an einem Windows-PC sitzen hilft euch vielleicht auch dieses Video weiter. Gleiche Videos gibt es auch für andere Betriebssysteme.

Hugo-Blog anlegen

Ist Hugo installiert, könnt ihr mit hugo new site <sitename> einen neuen Blog anlegen. Wir erstellen das fiktive Blog hugoblog.com.

P.S. Ich nutze auch auf Windows meist die Git-Bash als Konsole. Die kennt auch Befehle wie ssh :)

[Batman@lokal ~]$ hugo new site hugoblog.com

Eine Hugo-Website kommt ohne Theme. Das müssen wir also als nächstes herunterladen. Ich mag das Base16-Theme. Falls euch das nicht zusagt, findet ihr hier aber sicher ein oder zwei Alternativen.

Das Theme müsst ihr in den Ordner themes eurer eben erstellten Seite herunterladen.

[Batman@lokal ~]$ cd hugoblog.com/themes
[Batman@lokal themes]$ git clone https://github.com/htdvisser/hugo-base16-theme.git base16

Und schließlich müssen wir Hugo noch mitteilen, dass ihr dieses Theme verwenden wollt. Dazu passen wir die Konfiguration an.

[Batman@lokal ~]$ cd ~/hugoblog.com
[Batman@lokal hugoblog.com]$ cat <<EOF>> config.toml
theme = "base16"
pygmentsuseclasses = true
EOF

Erster Artikel

Zeit für den ersten Artikel. Mittels touch erstellen wir unter content/posts/ ein neues Markdown-File und befüllen es mit ein ein bisschen Inhalt.

[Batman@lokal hugoblog.com]$ touch content/posts/cooler-artikel.md
[Batman@lokal hugoblog.com]$ cat <<EOF>> content/posts/cooler-artikel.md
+++
title = "Hello World"
date = "2019-09-06"
layout = ["article"]
author = "Batman"
tags = ["uberspace", "hugo", "blog"]
+++

# Lorem Ipsum

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.

EOF

Mal drauf schauen, wie der Artikel aussieht? Das geht ganz leicht mit hugo serve. Hugo erstellt dann einen lokalen Server und lässt euch eure Seite unter folgendem Link betrachten: localhost:1313.

[Batman@lokal hugoblog.com]$ hugo serve
Building sites …
                   | EN
+------------------+----+
  Pages            | 37
  Paginator pages  |  2
  Non-page files   |  0
  Static files     |  6
  Processed images |  0
  Aliases          | 14
  Sitemaps         |  1
  Cleaned          |  0
[...]
Environment: "development"
Serving pages from memory
Running in Fast Render Mode. For full rebuilds on change: hugo server --disableFastRender
Web Server is available at http://localhost:1313/ (bind address 127.0.0.1)
Press Ctrl+C to stop

Wenn alles gut aussieht, können wir auf dem uberspace weitermachen.

uberspace vorbereiten

In diesem Schritt können wir uns am Tutorial auf https://lab.uberspace.de/ orientieren. Danke an Christian, luto und Julian.

Domain anlegen

Falls ihr eine eigene Domain verwenden wollt, lest im uberspace-Wiki noch einmal nach wie das geht. Hier gehen wir davon aus, dass ihr eine Domain aufgeschaltet habt und diese auf euren Document-Root (html/) verweist.

Hugo installieren

Um Hugo auf dem uberspace zu installieren, laden wir als erstes die neuste Version von Github als tar herunter. Prüfe im Hugo Repository auf GitHub noch einmal welches die neuste Version ist und passe die Befehle entsprechend an. Anschließend entpacken, nach bin verschieben und aufräumen. Fertig.

[batman@helium ~]$ wget https://github.com/gohugoio/hugo/releases/download/v0.58.1/hugo_0.58.1_Linux-64bit.tar.gz
[batman@helium ~]$ tar -xvf hugo_0.58.1_Linux-64bit.tar.gz hugo
[batman@helium ~]$ mv hugo ~/bin
[batman@helium ~]$ rm hugo_0.58.1_Linux-64bit.tar.gz
[batman@helium ~]$ hugo version

Sollte es mal eine neuere Version von Hugo geben, wiederholt einfach diesen Schritt, um wieder up to date zu sein :)

Git-Repository für Hugo-Blog anlegen

Als nächstes legen wir uns im Home-Verzeichnis einen neuen Ordner an, in dem wir das Git-Repository für unseren neuen Hugo-Blog ablegen.

[batman@helium ~]$ mkdir hugo_websites
[batman@helium ~]$ mkdir hugo_websites/hugoblog.git
[batman@helium ~]$ cd hugo_websites/hugoblog.git
[batman@helium hugoblog.git]$ git init --bare

Git Hook anlegen

Wir möchten, das der uberspace mit jedem push in unser eben erstelltes Repository den Blog neu erstellt und auf der Domain verfügbar macht. Sagen wir ihm das. Dafür passen wir den post-update-hook wie folgt an.

[batman@helium hugoblog.git]$ touch hooks/post-update
[batman@helium hugoblog.git]$ cat <<EOF>> hooks/post-update
#!/bin/sh

# los geht's
echo "Start hook magic"

# hier definieren wir den Pfad zu unserem Git-Repository
GIT_REPO=$HOME/hugo_websites/hugoblog.git

# hier definieren wir ein temporäres Verzeichnis zum clonen des Repositorys
TMP_GIT_CLONE=$(mktemp -d)

# hier definieren wir den Pfad zu unserer öffentlichen Domain
PUBLIC_WWW=/var/www/virtual/$USER/html

# jetzt clonen wir das Repository in den temporären Ordner
git clone $GIT_REPO $TMP_GIT_CLONE
cd $TMP_GIT_CLONE

# Hugo anschmeißen
~/bin/hugo --cleanDestinationDir --destination $PUBLIC_WWW

# aufräumen
rm -Rf $TMP_GIT_CLONE
EOF

Push auf den uberspace

Damit ist alles vorbereitet. Wir sollten jetzt nur noch unser auf dem uberspace erzeugtes Git-Repository als remote zum lokalen Ordner hinzufügen, unseren Artikel committen und das ganze hochladen.

[batman@lokal ~]$ cd hugoblog.com
[batman@lokal hugoblog.com]$ git init
[batman@lokal hugoblog.com]$ git remote add origin ssh://batman@helium.uberspace.de/hugo_websites/hugoblog.git
[batman@lokal hugoblog.com]$ git add .
[batman@lokal hugoblog.com]$ git commit -m "Initial commit"
[batman@lokal hugoblog.com]$ git push origin master

Und das war’s dann auch schon. Auf den ersten Blick ist das ein bisschen länger geworden, aber diese Schritte müsst ihr ja nur einmal vornehmen.

Da ich viel von unterwegs blogge, genieße ich es, auf dem iPad zu schreiben und nur einmal git push eingeben zu müssen, um die Änderungen zu veröffentlichen. Wie ich von unterwegs blogge, werde ich vermutlich demnächst mal aufschreiben.

Und jetzt viel Spaß mit eurem neuen Blog.

Thank you for subscribing to this RSS feed. https://prev.soeren.me/ is søren's personal blog. If you want to get in touch, please reply to this post via email.

Uberspace on Søren's Blog

My Blogging Workflow as of mid 2025

My blogging workflow as of late 2023

Collecting ideas

Formulating ideas

Transfer to markdown

Publish

Refinement

Ideas for the future

Hugo mit Git auf dem uberspace nutzen

Vorgeschichte

Git und Hugo lokal installieren

Hugo-Blog anlegen

Erster Artikel

uberspace vorbereiten

Domain anlegen

Hugo installieren

Git-Repository für Hugo-Blog anlegen

Git Hook anlegen

Push auf den uberspace