sigmoid.social is one of the many independent Mastodon servers you can use to participate in the fediverse.
A social space for people researching, working with, or just interested in AI!

Server stats:

525
active users

#mkdocs

3 posts3 participants1 post today

Oh look, a new player in the static site generator space: The "Material for MkDocs" team is saying goodbye to the unmaintained MkDocs base and are instead writing a new, modern SSG from scratch, called Zensical.

squidfunk.github.io/mkdocs-mat

It doesn't have feature parity yet, but already looks quite capable. No blogging or custom plugins yet though, else I might've tried Zensical for the upcoming relaunch of my personal site.

squidfunk.github.ioZensical - A modern static site generator - Material for MkDocsWe are thrilled to announce Zensical, our next-gen static site generator that addresses and overcomes the technical limitations of MkDocs

I’m sunsetting the Insiders program

I'm redirecting my time and energy from into (see the announcement here: squidfunk.github.io/mkdocs-mat) @zensical

All currently private features will be released to the public this week.

Thank you so much to all my current and past sponsors! You are fantastic

Only the Insiders program comes to an end ($$ -> access to private features): I will continue working on my open source projects, so you can keep sponsoring me if you like my work

squidfunk.github.ioZensical - A modern static site generator - Material for MkDocsWe are thrilled to announce Zensical, our next-gen static site generator that addresses and overcomes the technical limitations of MkDocs
Continued thread

(2/3) For those curious about the technical side: we are using to build the website inside on and push the resulting HTML to .

We want to thank all the developers of these tools and we want to thank @Codeberg and @whitequark for the hosting of code and website.

As always in this world: we build on the work of others to get much further much faster than we could have gone alone and we are so grateful for the FOSS community for making this possible!

can't sleep so taking a look at the state of static site generators in the wild. Gotta say has taken a big jump upwards in my personal estimation since my last sojourn in this space a few years ago. Material for MkDocs is polished and sharp - squidfunk.github.io/mkdocs-mat.
New to me is Blurry - blurry-docs.netlify.app/, which has some spunk. Stapy looks interesting - stapy.magentix.fr/.
It's good to see Pelican is still holding it's own (getpelican.com/); it would be nice to see some new theme energy.

squidfunk.github.ioMaterial for MkDocsWrite your documentation in Markdown and create a professional static site in minutes – searchable, customizable, in 60+ languages, for all devices
Replied in thread

@lumi @hazel yes, it's easier to avoid:

I merely use because they ain't got impacted by and their moderation team actually cares, and I don't expect other platforms to be able and willing to do the same.

  • If there is a convenient way to only use it to a copy of a repo & files as a "slave" (fork) repo (similar to ) I'll gladly consider that.

  • It's just not the highest priority rn as I'm preoccupied with more pressing issues.

Replied in thread

@pancake Relative.

  • I think in that case there's rather a systemic problem of underresourced projects: More funding and personnel would greatly help in said effort.

The only thing generates are due to new tickets being opened with the exact same problem

I don't deny the issue at hand; I just think that such a massive pile needs to be combed through better by using tags and prioritization. Even if that means one has split the backlog into half a dozen different baskets that read "feedback", "suggestion", "bug", "security", "ui/ux", "building", "l18n/i18n", "accessibility", "reproduceability", etc...

after switching from mac -> windows at the start of this year, i have finally finally Finally found a suitable replacement for Bear ( bear.app ) the best markdown note app, which is unfortunately Apple ecosystem only

mkdocs + plugins (mainly: live-edit, pymdownx.tasklist, search, & more) + local host w/ WSL

requires some CLI work & UI not as clean as Bear, but atleast it’s similar! joplin, obsidian, google docs & many others are just unusable

Durch die Umstellung meines Blogs von auf kann ich das Paket bei Hetzner von Level 9 (10,90/Monat) auf Level 1 (2,09/Monat) wechseln Dort sind jetzt nur noch die Email-Postfächer der Familie und die Domains.

Dabei ist mir noch aufgefallen, dass ich beim Hosting Storage Share für 1TB auf einem Alten Vertrag war (NX30). Habe den auf NX11 umgestellt, der kostet nur die Hälfte (5,11/Monat).

You'd think generating Markdown docs from Python docstrings would be straightforward and common, but apparently not.

Couldn't get lazydocs to work, reading some other things now…

On the plus side, I can just toss the `.md` files in the right spot, commit them to Codeberg, and get hosted API docs.

If I can't get this to work I can use mkdocs to pull the docstrings, generate HTML and host it on my website.