Statische Seiten mit MkDocs (Material)
Als ich vor etwa einem Jahr meinen Rechnerumzug organisierte, stolperte ich auch wieder eher zufällig über MkDocs, einen schnellen und freien (BSD-Lizenz), in Python geschriebenen, Markdown-basierten Generator für statische Seiten, der allem für die Dokumentation von Software-Projekten entwickelt worden war.
Ich hatte früher viel mit dem Teil gearbeitet und damit zum Beispiel meine Seiten »Processing.py in Beispielen« erstellt, eine Sammlung von Processing.py-Tutorials, die ich von 2015 bis 2018 geschrieben und online veröffentlicht hatte.
Doch Tempus fuget: Mittlerweile gibt es »Material für MkDocs«, eine Erweiterung, die sich von einem Template fast zu einer eigenständigen Anwendung entwickelt hat. James Willet hat darüber nicht nur das obige Video hochgeladen, sondern auch für alle, die lieber lesen, ein Tutorial »Getting Started with Material for MkDocs« publiziert, das natürlich mit Material für MkDocs erstellt wurde.
Doch jetzt kommt der Clou: Material für MkDocs kann nicht nur Dokumentationsseiten, sondern ist zu einem vollständigen Static Sites Generator aufgebohrt, das auch Blog kann. Dies demonstriert James Willet in seinem Video »How To Build and Deploy a Stunning Blog for free using Material for MkDocs«.
Jetzt bin ich natürlich hin- und hergerissen. Nicht, daß ich mit Quarto, der Engine, die momentan dieses Weblog Kritzelheft antreibt, unzufrieden wäre, aber ein wenig behäbig ist die Software doch geworden. Also habe ich mir erst einmal noch drei längere Videos zu MkDocs herausgesucht:
- Step-by-Step Guide To Making An MkDocs Material Website von Ken Harris.
- Art of Docs Fast Building with MkDocs, GitHub & ChatGPT vom Aeropa Webinars.
- How to create a Beautiful documentation-blog website for free with MkDocs Material von Thomas Wilde.
Doch das alles läuft erst einmal unter der Überschrift »Video-Tutorials zum Wochenende«, entschieden habe ich noch lange nichts. Still digging!
War sonst noch was? Ach ja, auf der 23. Gulaschprogrammiernacht des Chaos Computer Clubs hielt perrflynn am 21. Juni dieses Jahres den Vortrag »IndieWeb: Publish (on your) Own Site, Syndicate Elsewhere« (trotz des englisch klingenden Titels auf Deutsch). Passt doch irgendwie zum Thema, oder?
Bild: A Man in an Office, erstellt mit OpenArt.ai. Prompt: »colored belgian comic style, illustration of an clean shaven man, short white hair, blue eyes, glasses, sits at a desk in front of two huge monitors, there are a few open books on the desk, and large mug of steaming coffee next to them, and a computer keyboard in front of the monitor, on the wall there are many shelves with a lot of files and books, the shelves looks unorganized, the sun shines through a large window«. Modell: Flux (Pro), Style: None.