Habe gestern diesen Artikel über die Hintergründe bei #Mkdocs gelesen (https://fpgmaas.com/blog/collapse-of-mkdocs/) und jetzt eine Nacht darüber geschlafen. Da wir Mkdocs + Material in der #lernOS Produktionskette verwenden, besteht Handlungsbedarf.

Von den Optionen scheint der Wechsel zu #Zensical naheliegend (https://zensical.org). Feature Parität zu Material ist recht weit, Blogs gibt es noch nicht (auf lernos.org eingesetzt). Werde mal die aktiven Maintainer kontaktieren, damit wir das besprechen.

I just migrated my personal site from Mkdocs to Zensical.

My site: https://maulonobile.codeberg.page/
Learn more: https://zensical.org

#Zensical #MkDocs #Codeberg #OpenSource

I've recently migrated a few (small) sites from #MkDocs (no longer maintained) to #Zensical, which went very smoothly.

It also motivated me to write a small Markdown extension for including source code for #Python functions, classes, methods, etc, similar to the `:pyobject:` option in reStructuredText's `literalinclude` directive:

https://includepy.readthedocs.io/en/latest/

(I'm aware of the snippets extension, which has many more features, but requires adding markers to the source files)

When installing dependencies, formatting code, linting it, type-checking it, and building docs with #Poetry or #PDM, #Black, #Flake8, #Mypy and #MkDocs would previously take from 2min to several more, it now takes less than 15 seconds for the whole thing, thanks to #uv, #Ruff, #ty and #Zensical.

This is for 5 #Python versions (3.10 to 3.15).

The DX got much better 🥰

Overriding some CSS in a project that uses Sass but doesn't let you hook into it kind of sucks.

Sure, I _can_ hard-code something like "@media screen and (max-width: 76.2344em)" (which originates from an expression like "px2em(719.75px)") into my CSS file, but should I _have_ to?

(Looking at you, #Zensical.)

(Yes, I know Zensical is still at 0.0.something. I don't exactly _expect_ it to make this easy for me at this time. I'm just venting.)

Da werden wir mal im Lauf des Jahres ein #lernOS Leitfaden zum Test von #mkdocs auf #zensical umstellen.

From: @squidfunk
https://fosstodon.org/@squidfunk/115955190362504185

https://squidfunk.github.io/mkdocs-material/blog/2025/11/05/zensical/ Zensical – A modern static site generator built by the Material for MkDocs team

#documentation #zensical

RE: https://fosstodon.org/@squidfunk/115656211161522368

Already deployed some docs with #Zensical, including API reference 😎 That's where the screenshot comes from! Check it out here: https://pawamoy.github.io/yore/reference/api/

I need to figure out how I can embargo certain content with #Zensical, because I think my business model for surfhosting dot cc once launched is gonna be something like "pay $3 a year to get access to articles 6 months earlier than the genpop and every AI scraper which makes it across the moat"

I don't particularly love the idea of doing that, but I need to feed and house myself and I am absolutely not going to simply donate my research & writing to the techbro theft machines.

it may be as simple as a .htaccess redirect, I don't know.