#MkDocs
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
Prek, "a reimagined version of pre-commit, built in Rust", has a ✨ fresh ✨ documentation page, thanks to a contributed by yours truly and paid for by my employee, AOE GmbH, wo allows me to use some of my working time to contribute to OSS projects. 🫶
The docs were moved from material for mkdocs to @squidfunk (https://fosstodon.org/@squidfunk)'s new doc generator @zensical (https://fosstodon.org/@zensical)!
Site: https://prek.j178.dev
MR: https://github.com/j178/prek/pull/1421
#OSS #Documentation #Zensical #Mkdocs
📌 https://kevingimbel.de/status/1769068200
Kommt halt immer auf den Anwendungsfall an.
Our website is refreshed! Please check out our new website based on #mkdocs with #readthedocs theme:
TheProtocols Documentation
un échange sur les #outils de documentation de projet #Python : #mkdocs et le plugin #mkdocstring semblent n'être plus maintenus, #sphinx et son écosystème sont toujours là : https://mastodon.social/@hynek/115741361280546913
Utilisez-vous un framework pour documenter votre projet ? Si oui, lequel ?
L'occasion de (re)voir la présentation "Documentation : trouver son style " de Florian, qui aborde surtout la démarche documentaire plutôt que les solutions techniques : https://www.youtube.com/watch?v=0CB4iVcHcsU
I'm really not looking for extra work as 2025 comes to an end, but I recently stumbled across mkdocs-quiz (https://ewels.github.io/mkdocs-quiz/) and it looks fantastic, so now I want to add interactive quizzes to every chapter of Git is my lab book (https://git-is-my-lab-book.net/) 😮💨 ...
MkSlides – Markdown to slides with a similar workflow to MkDocs
https://github.com/MartenBE/mkslides
#HackerNews #MkSlides #Markdown #Slides #MkDocs #Workflow #Presentation #Tools
Just released django-classy-doc v0.1.0! 🎉
New in this release: mkdocstrings handler for inline docs. Now you can embed CCBV-style class documentation directly in your MkDocs sites.
::: myapp.models.MyModel
handler: classydoc
> pip install django-classy-doc[mkdocs]
@AstroHyde I used #eleventyjs on #GitHub pages, because #jekyll never sat well with me.
I am switching to #mkdocs this time, because I like #python better than #javascript
#Codeberg pages doesn't seem to have an opinion, as long as HTML is delivered to it.
Started experimenting with #Zensical as a replacement for #mkdocs-material.It's blazing fast and has a nice new look.
Mein Projekt #kraft hat endlich eine neue Webseite bekommen: https://volle-kraft-voraus.de Schön mit #mkdocs...
One thing I've learned to love on the Fedi are content notes. Which means that my blog needs them, too!
Here's how I set up a macro in #MkDocs to make writing them easy, concise, and without repeating the same markup in every source file.
https://scy.name/blog/2025/11/mkdocs-content-notes.html
I can now add a content note to any blog post (or any page on the website really) simply by adding something like this to the Markdown source:
{{ cn("velociraptors", "electrified fences") }}
So how did this come about?
We've been talking about having some multiple choice questions in the #nextflow training for a while. The website is built with the wonderful #mkdocs #material by @squidfunk
It came up again a few days ago, so I started poking around for plugins.
New open source package alert! 🔔 ewels.github.io/mkdocs-quiz/
A #MkDocs plugin to create interactive quizzes directly in your markdown:
<quiz>
What's the best static site generator?
- [x] mkdocs
- [ ] Jekyll
- [ ] Sphinx
You've come to the right place!
</quiz>
