Für die Nerds...

Wie diese Seite gebaut wird

Für die Erstellung dieser Seite nutze ich Obsidian. Obsidian speichert sogenannte Notes in einzelnen Markdown Dateien. Mithilfe dieser Rust CLI konvertiere ich die Obsidian Notes in reguläre Markdown Dateien und konvertiere sie mit einem Hilfsscript in eine Verzeichnisstruktur, die von mkdocs gerendert wird.

Die technischen Details zum Export von Obsidian in mkdocs findet ihr in diesem GitHub Gist.

Sobald ich Änderungen in das dahinterliegende GitHub Repository schreibe, startet ein GitHub Workflow der mithilfe von mkdocs die Markdown Dateien in statische HTML Seiten rendert und das ganze als GitHub Pages exportiert.

Vor die GitHub Pages habe ich eine eigene Domain geschaltet und GitHub gebeten das Ganze nur über eine gesicherte Verbindung auszuliefern.

Und so kommt ihr in den Genuss dieser Seite :)

Unterm Strich kann ich also den gesamten Inhalt der Seite bequem in Obsidian verwalten, während ein paar Scripte und GitHub Workflows dann alles zu einer Webseite konvertieren.

Warum?

Weil ich Obsidian als Notizbuch genutzt habe, um alles aufzuschreiben, was ich während dem Bau der CNC Fräse gelernt habe und zu faul war, das alles nochmal in einen Blog oder Webseiten-Baukasten zu tippern...