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

Material for MkDocs

Write your documentation in Markdown and create a professional static site in minutes – searchable, customizable, in 60+ languages, for all devices

The MkDocs-Material default theme has the background of code blocks extend all the way to the viewport width on mobile, instead of being boxed in by the main container's padding.

I love small details like this.

#MkDocsMaterial #typography #webdesign

and there it is. 11-month blocker defeated.

#MkDocs #MkDocsMaterial #Surfhosting

@wyatt +1

I may just use #MkDocs-#Material if I ever setup a #blog.

#MkDocsMaterial #CMS #Markdown

@memesmadetorunonlinux you know what's real #GigaChad in terms of #Presentations?

  • When you write #Markdown that gets converted into HTML + #LaTeX and then spit out to into indexed, searchable and chapter'd #PDF|s.

For everyone else there's #MkDocs (or rather #MkDocsMaterial) for making beautiful #HTML presentations...

I have made a #mkdocsmaterial site to document stuff together with a lot of Git newbies.

So, in order to maintain a clean commit history and have a changelog every Friday, I set the repo so that even the Maintainer level people need to go through merge requests, in order to enforce the commit-lint ci check πŸ’πŸΌ

Well, this means I myself also can't just push to main directly.

#Git #GitLab

Gestern war ja irgendwie ein komischer Tag πŸ˜΅β€πŸ’«

Hab mir mal Kotlin angeschaut und ein altes Java Projekt portiert: πŸ€“
- Code in Kotlin πŸ’πŸΌ
- fΓΌr UniTests mit Coverage vorbereitet βœ…
- Doku als JavaDoc/Markdown πŸ“
- MkDocs Seite + Markdown Code-Doku integriert πŸ“–

Offensichtlich war ich am Ende ganz schΓΆn verkrampft. Als ich mich danach wieder entspannt hab, war der Tag um halb sechs quasi gelaufen. πŸͺ« πŸ€•

#Kotlin #Java #MkDocsMaterial

Thanks to @squidfunk and everyone contributing to #mkdocsMaterial for the fantastic mkdocs theme and developer experience. Adding the blog plugin was so easy πŸ₯Ή

I still have some work to do on other parts of the site - I need the home page to be more of a stylish landing page with concise messaging about the value of using our module, and the getting started section needs an overhaul with detailed guidance on prerequisites, installation, basic usage, and advanced automation.

"release often release fast" they said. #mkdocsmaterial has 352 releases... 13 releases the last 30 days... yeay?