#mkdocs — Public Fediverse posts

We start to convert our #b1gMail Wiki on #GitHub to Markdown and using Zensical for HTML documentation: https://docs.b1gmail.org

#zensical #mkdocs #documentation #email #hosting #selfhosting #mailserver #opensource

We start to convert our #b1gMail Wiki on #GitHub to Markdown and using Zensical for HTML documentation: https://docs.b1gmail.org

#zensical #mkdocs #documentation #email #hosting #selfhosting #mailserver #opensource

Seems like MkDocs 2.0 is aiming for being unusable: https://github.com/encode/mkdocs?tab=contributing-ov-file#maintainer-driven-issues

Can also very much recommend this blog post: https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

#opensource #mkdocs

¡Diablos! Mi página web está construida con el tema Material que funciona sobre MkDocs. Lo amo, es muy potente. Y mientras la renderizaba me encontré con una advertencia en la terminal y un enlace a la siguiente página ⚠️:

https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

#mkdocsMaterial #mkdocs #zensical #materialformkdocs

¡Diablos! Mi página web está construida con el tema Material que funciona sobre MkDocs. Lo amo, es muy potente. Y mientras la renderizaba me encontré con una advertencia en la terminal y un enlace a la siguiente página ⚠️:

https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

#mkdocsMaterial #mkdocs #zensical #materialformkdocs

Got the #MKDOCs machine fired-up... maybe I'll get more of the #manual done next week? It's mostly stubs right now but, I will at least use a #Motif. It is sporting my custom #font of course.

I changed tense at some point, it was late. I'll get back to it another time maybe.

https://dckim.org

#art #pixelArt #toronto #vancouver #montreal #ottawa #canada #UK #ontario #quebec #technology #news #indieweb #FOSS #opensource #indiedev #selfhosting #digitalArt #DCKIM #HDUB #vanilla #singleFile

Got the #MKDOCs machine fired-up... maybe I'll get more of the #manual done next week? It's mostly stubs right now but, I will at least use a #Motif. It is sporting my custom #font of course.

I changed tense at some point, it was late. I'll get back to it another time maybe.

https://dckim.org

#art #pixelArt #toronto #vancouver #montreal #ottawa #canada #UK #ontario #quebec #technology #news #indieweb #FOSS #opensource #indiedev #selfhosting #digitalArt #DCKIM #HDUB #vanilla #singleFile

Got the #MKDOCs machine fired-up... maybe I'll get more of the #manual done next week? It's mostly stubs right now but, I will at least use a #Motif. It is sporting my custom #font of course.

I changed tense at some point, it was late. I'll get back to it another time maybe.

https://dckim.org

#art #pixelArt #toronto #vancouver #montreal #ottawa #canada #UK #ontario #quebec #technology #news #indieweb #FOSS #opensource #indiedev #selfhosting #digitalArt #DCKIM #HDUB #vanilla #singleFile

Got the #MKDOCs machine fired-up... maybe I'll get more of the #manual done next week? It's mostly stubs right now but, I will at least use a #Motif. It is sporting my custom #font of course.

I changed tense at some point, it was late. I'll get back to it another time maybe.

https://dckim.org

#art #pixelArt #toronto #vancouver #montreal #ottawa #canada #UK #ontario #quebec #technology #news #indieweb #FOSS #opensource #indiedev #selfhosting #digitalArt #DCKIM #HDUB #vanilla #singleFile

Got the #MKDOCs machine fired-up... maybe I'll get more of the #manual done next week? It's mostly stubs right now but, I will at least use a #Motif. It is sporting my custom #font of course.

I changed tense at some point, it was late. I'll get back to it another time maybe.

https://dckim.org

#art #pixelArt #toronto #vancouver #montreal #ottawa #canada #UK #ontario #quebec #technology #news #indieweb #FOSS #opensource #indiedev #selfhosting #digitalArt #DCKIM #HDUB #vanilla #singleFile

CVE Alert: CVE-2026-7159 - douinc - mkdocs-mcp-plugin - https://www.redpacketsecurity.com/cve-alert-cve-2026-7159-douinc-mkdocs-mcp-plugin/

#OSINT #ThreatIntel #CyberSecurity #cve-2026-7159 #douinc #mkdocs-mcp-plugin

Statische Seiten: Ist Zensical der legitime Nachfolger von MkDocs (Material)

Als ich im Juni letzten Jahres MkDocs (genauer: Material für MkDocs) wiederentdeckte, war ich fasziniert. Denn mit diesem freien (BSD-Lizenz), in Python geschriebenen, Markdown-basierten Generator für statische Seiten, hatte ich bereits sehr gute Erfahrungen gemacht. https://kantel.github.io/posts/2026042101_zensical/ #MkDocs #Zensical #Markdown #StatischeSeiten #Zettelkasten #Webworking

Statische Seiten: Ist Zensical der legitime Nachfolger von MkDocs (Material)

Als ich im Juni letzten Jahres MkDocs (genauer: Material für MkDocs) wiederentdeckte, war ich fasziniert. Denn mit diesem freien (BSD-Lizenz), in Python geschriebenen, Markdown-basierten Generator für statische Seiten, hatte ich bereits sehr gute Erfahrungen gemacht. https://kantel.github.io/posts/2026042101_zensical/ #MkDocs #Zensical #Markdown #StatischeSeiten #Zettelkasten #Webworking

Statische Seiten: Ist Zensical der legitime Nachfolger von MkDocs (Material)

Als ich im Juni letzten Jahres MkDocs (genauer: Material für MkDocs) wiederentdeckte, war ich fasziniert. Denn mit diesem freien (BSD-Lizenz), in Python geschriebenen, Markdown-basierten Generator für statische Seiten, hatte ich bereits sehr gute Erfahrungen gemacht. https://kantel.github.io/posts/2026042101_zensical/ #MkDocs #Zensical #Markdown #StatischeSeiten #Zettelkasten #Webworking

Statische Seiten: Ist Zensical der legitime Nachfolger von MkDocs (Material)

Als ich im Juni letzten Jahres MkDocs (genauer: Material für MkDocs) wiederentdeckte, war ich fasziniert. Denn mit diesem freien (BSD-Lizenz), in Python geschriebenen, Markdown-basierten Generator für statische Seiten, hatte ich bereits sehr gute Erfahrungen gemacht. https://kantel.github.io/posts/2026042101_zensical/ #MkDocs #Zensical #Markdown #StatischeSeiten #Zettelkasten #Webworking

Ytterligare en bra grej med MkDocs som jag använder för sajten är att när jag kommer på nåt som vore bra så finns det redan en plugin för det.

Nu kan jag definiera priser och liknande i en fil och det uppdateras överallt där det används

#mkdocs

Info für Leitfaden-Maintainer zur Umstellung der #lernOS Produktionskette von #Mkdocs auf #Zensical: https://community.cogneon.de/t/migration-von-mkdocs-zu-zensical-lernos-produktionskette/4298

Info für Leitfaden-Maintainer zur Umstellung der #lernOS Produktionskette von #Mkdocs auf #Zensical: https://community.cogneon.de/t/migration-von-mkdocs-zu-zensical-lernos-produktionskette/4298

Info für Leitfaden-Maintainer zur Umstellung der #lernOS Produktionskette von #Mkdocs auf #Zensical: https://community.cogneon.de/t/migration-von-mkdocs-zu-zensical-lernos-produktionskette/4298

Info für Leitfaden-Maintainer zur Umstellung der #lernOS Produktionskette von #Mkdocs auf #Zensical: https://community.cogneon.de/t/migration-von-mkdocs-zu-zensical-lernos-produktionskette/4298

Info für Leitfaden-Maintainer zur Umstellung der #lernOS Produktionskette von #Mkdocs auf #Zensical: https://community.cogneon.de/t/migration-von-mkdocs-zu-zensical-lernos-produktionskette/4298

I am now using #Zensical for my #documentation website, using the same code I used for Materials for #mkdocs. I converted the mkdocs.yml to zensical.toml using #chatgpt, and I didn't like the TOML format. It looks unnecessarily complicated. So I will continue using YAML until it becomes necessary.

I am now using #Zensical for my #documentation website, using the same code I used for Materials for #mkdocs. I converted the mkdocs.yml to zensical.toml using #chatgpt, and I didn't like the TOML format. It looks unnecessarily complicated. So I will continue using YAML until it becomes necessary.

I am now using #Zensical for my #documentation website, using the same code I used for Materials for #mkdocs. I converted the mkdocs.yml to zensical.toml using #chatgpt, and I didn't like the TOML format. It looks unnecessarily complicated. So I will continue using YAML until it becomes necessary.

I am now using #Zensical for my #documentation website, using the same code I used for Materials for #mkdocs. I converted the mkdocs.yml to zensical.toml using #chatgpt, and I didn't like the TOML format. It looks unnecessarily complicated. So I will continue using YAML until it becomes necessary.

I am now using #Zensical for my #documentation website, using the same code I used for Materials for #mkdocs. I converted the mkdocs.yml to zensical.toml using #chatgpt, and I didn't like the TOML format. It looks unnecessarily complicated. So I will continue using YAML until it becomes necessary.

New Blog Post: My move to ProperDocs and why you should too

I'll explain why I moved to #ProperDocs and why you should no longer stick with #MkDocs

https://andre601.ch/blog/2026/03-24-my-move-to-properdocs

(Post may take a while to show up)

I've been testing #zensical since I will have to migrate off of #mkdocs and #mkdocsmaterial.

Across 3 sites, I only had to change one line in the yaml files and run `zensical` instead of `mkdocs`. Total potential migration time for 3 sites, 10 minutes.

Why potential and not complete? Pending blog and OpenAPI spec support. Once those are released, I can finish testing and migrate.

@squidfunk looking good so far. Thanks!

#technology #tech #indieweb #blog #technicalwriting #docs #docsascode

I've been testing #zensical since I will have to migrate off of #mkdocs and #mkdocsmaterial.

Across 3 sites, I only had to change one line in the yaml files and run `zensical` instead of `mkdocs`. Total potential migration time for 3 sites, 10 minutes.

Why potential and not complete? Pending blog and OpenAPI spec support. Once those are released, I can finish testing and migrate.

@squidfunk looking good so far. Thanks!

#technology #tech #indieweb #blog #technicalwriting #docs #docsascode

I've been testing #zensical since I will have to migrate off of #mkdocs and #mkdocsmaterial.

Across 3 sites, I only had to change one line in the yaml files and run `zensical` instead of `mkdocs`. Total potential migration time for 3 sites, 10 minutes.

Why potential and not complete? Pending blog and OpenAPI spec support. Once those are released, I can finish testing and migrate.

@squidfunk looking good so far. Thanks!

#technology #tech #indieweb #blog #technicalwriting #docs #docsascode

I've been testing #zensical since I will have to migrate off of #mkdocs and #mkdocsmaterial.

Across 3 sites, I only had to change one line in the yaml files and run `zensical` instead of `mkdocs`. Total potential migration time for 3 sites, 10 minutes.

Why potential and not complete? Pending blog and OpenAPI spec support. Once those are released, I can finish testing and migrate.

@squidfunk looking good so far. Thanks!

#technology #tech #indieweb #blog #technicalwriting #docs #docsascode

I've been testing #zensical since I will have to migrate off of #mkdocs and #mkdocsmaterial.

Across 3 sites, I only had to change one line in the yaml files and run `zensical` instead of `mkdocs`. Total potential migration time for 3 sites, 10 minutes.

Why potential and not complete? Pending blog and OpenAPI spec support. Once those are released, I can finish testing and migrate.

@squidfunk looking good so far. Thanks!

#technology #tech #indieweb #blog #technicalwriting #docs #docsascode

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.

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.

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.

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.

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.

There's a new piece explaining "The Slow Collapse of #MkDocs": "How personality clashes, an absent founder, and a controversial redesign fractured one of Python's most popular projects."

https://fpgmaas.com/blog/collapse-of-mkdocs/

Well, that says a lot. But what's really interesting is that MkDocs 2.x is being developed as part of the "encode" organization. That's great, right? The people who gave us such great libraries as #httpx?

Well, turns out no, not at all. It looks like encode has already crumbled and became immensely toxic.

httpx is not allowing bug reports anymore, apparently because of "absurdly skewed gender representation", whatever that means.

https://web.archive.org/web/20260228113715/https://github.com/encode/httpx/discussions/3784

That also explained why starlette moved out of the organization a while back:

https://web.archive.org/web/20260323042730/https://github.com/Kludex/starlette/issues/3180

There's a great rot in #OpenSource.

#FreeSoftware #Python

Tester et valider mkdocs pour créer un wiki interne de l'entreprise accessible depuis les dossiers partagés (hors forges logicielles) : ✅
#mkdocs #wiki #entreprise #collaborateurs

Tester et valider mkdocs pour créer un wiki interne de l'entreprise accessible depuis les dossiers partagés (hors forges logicielles) : ✅
#mkdocs #wiki #entreprise #collaborateurs

Tester et valider mkdocs pour créer un wiki interne de l'entreprise accessible depuis les dossiers partagés (hors forges logicielles) : ✅
#mkdocs #wiki #entreprise #collaborateurs

Tester et valider mkdocs pour créer un wiki interne de l'entreprise accessible depuis les dossiers partagés (hors forges logicielles) : ✅
#mkdocs #wiki #entreprise #collaborateurs

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 just migrated my personal site from Mkdocs to Zensical.

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

#Zensical #MkDocs #Codeberg #OpenSource

So, remember how all the cool kids dumped #Sphinx and went for the shiny #MkDocs thing? And then used the shiny Material for MkDocs theme?

Well, apparently MkDocs 1.x is dead, and MkDocs 2.0 is coming with no support for plugins, incompatible theming system, closed contribution model and unclear licensing.

So which hype train are the cool kids jumping to these days?

https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

#Python

So, remember how all the cool kids dumped #Sphinx and went for the shiny #MkDocs thing? And then used the shiny Material for MkDocs theme?

Well, apparently MkDocs 1.x is dead, and MkDocs 2.0 is coming with no support for plugins, incompatible theming system, closed contribution model and unclear licensing.

So which hype train are the cool kids jumping to these days?

https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

#Python

So, remember how all the cool kids dumped #Sphinx and went for the shiny #MkDocs thing? And then used the shiny Material for MkDocs theme?

Well, apparently MkDocs 1.x is dead, and MkDocs 2.0 is coming with no support for plugins, incompatible theming system, closed contribution model and unclear licensing.

So which hype train are the cool kids jumping to these days?

https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

#Python

So, remember how all the cool kids dumped #Sphinx and went for the shiny #MkDocs thing? And then used the shiny Material for MkDocs theme?

Well, apparently MkDocs 1.x is dead, and MkDocs 2.0 is coming with no support for plugins, incompatible theming system, closed contribution model and unclear licensing.

So which hype train are the cool kids jumping to these days?

https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

#Python

So, remember how all the cool kids dumped #Sphinx and went for the shiny #MkDocs thing? And then used the shiny Material for MkDocs theme?

Well, apparently MkDocs 1.x is dead, and MkDocs 2.0 is coming with no support for plugins, incompatible theming system, closed contribution model and unclear licensing.

So which hype train are the cool kids jumping to these days?

https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

#Python

Die Hölle friert zu: Nele Hirsch empfiehlt Publii

Mir gefällt die kompetente und unaufgeregte Art, mit der Nele Hirsch ihr eBildungslabor betreibt, und darin die Themen zur Bildung im digitalen Wandel behandelt. Lediglich eines hatte bei mir immer ein Stirnrunzeln erzeugt: Wenn es um die Frage »Publizieren im Web« ging, kannte sie bisher nur eine Lösung – ein selbstgehostetes WordPress. https://kantel.github.io/posts/2026030402_publii/ #StatischeSeiten #Publii #Webworking #Markdown #MkDocs