I figured I'd try out the new #mkdocs blogging feature and set up a little site for myself: https://gtmx.me/

#TIL #MkDocs #Material untestützt seit der Version 9.2 auch Blogs. Habe die Funktion mal ausprobiert und bin recht angetan von der Einfachheit. Wir werden im #lernOS Kernteam mal besprechen, auf https://lernos.org einen lernOS Blog zu starten.

Material für #Mkdocs ist in Version 9.2 erschienen (https://github.com/squidfunk/mkdocs-material/releases/tag/9.2.0). Damit wird in den Web-Versionen der #lernOS Leitfäden ein Blog möglich. Das werden wir zeitnah in die Produktionskette integrieren.

Goodbye #Jekyll, hello #MkDocs. After many years, I realized that I don't want a blog, just a site with docs-like info. Bonus: mkdocs is the easiest SSG I've used. :)

https://squidfunk.github.io/mkdocs-material/

@stefano I wasn't aware of Gitea's for-profit future, thanks!

I recently went through a long search journey for a wiki. Tried a few like #mkdocs, #DokuWiki and #Outline. Since I have users who have no experience (and will 🙂) to learn Markdown, I decided to go with #WikiJS as it is also quite easy to set up.

SQLDocs is a new cross-platform console application to create nice looking schema documentations with #mkdocs and #mkdocsmaterial for relational databases (currently supported are #PostgreSQL and #Firebird).

Let's try this: Dear #lazyweb / #lazyfedi, what is the current go-to if I have to/want to write application #documentation for #endusers?
It is a #rust application, that does contain a lot of #rustdoc already, but that is very specific to the code, like api/developers doc. It is not end user stuff.

So, what to do? Own branch and something in it, that then gets rendered on a Github-or-similar page? A .md file used with #mkdocs? Using #readthedocs and their #sphinx based setup (also their examples are pretty python related).

I would like to stay as near to the code as I can. *Ideally* it would be rustdoc comments, but that can't be, as that is used for the developers doc already. "Just" a file besides, maybe in doc/ sounds better than whole new branch?

Any #suggestions?

https://fortinux.com/python/automatizar-documentacion-python-con-mkdocs/

#python #mkdocs

@foosel that’s a neat solution! If I were still involved in the project I’d say that #MkDocs should have native support for something like this 😀

@Yahiko je cherchais aussi à un moment et c'est #bookstack https://www.bookstackapp.com/ qui gagne chez moi 😊 j'ai pas encore trop poussé de page
Par conte je crois qu'il faut une bdd avec

Autrement j'avais testé #mdbook https://rust-lang.github.io/mdBook/

C'est pas mal, codé en rust. C'est équivalent à #mkdocs

@thelinuxfraud
i like #Hugo and #Mkdocs

@squidfunk just pushed a community release of the #MaterialForMkdocs with #blog support a couple days ago

Mini-Eintrag im #Blog 👋

Hab mit ner von @carlschwan adaptierten Lösung das Fediverse als Kommentarfunktion eingebaut.

Wenn ich mal Zeit & Lust hab mach ich das vielleicht noch bisschen hübscher im Code wie es jetzt ist^^

https://9lukas5.gitlab.io/blog/2023/07/kommentare-im-statischen-blog/text.html

#Blog #MkDocs #StaticSiteGenerator #Comments

....why is #css nesting not working in my #mkdocs-material extra css?!

This works:

.outer {
...
}

.outer .inner {
...
}

This not:

.outer {
...

.inner {
...
}
}

mhhh, hab vorhin mal versucht git svn clone nur vom #svn trunk zu machen.
Ist aber irgendwie saumäßig lahm das ganze 😵‍💫
Ob das am #WSL2 liegt, oder #Git 🤔

Und glaub diese Doku die ich da grad neu erfassen soll, ich werd das glaub zur Demo wie fancy #Doku heute so geht mal noch als #MkDocs Seite anfangen 👀

Following the suggestion in https://github.com/mkdocs/mkdocs/discussions/3246, #MkDocs now has a group: @MkDocs. Mention it to post to the group, follow it to get all posts!

(the group is not official, I've created it myself)

New #mkdocs project: mkdocs-manpage 📗 https://pawamoy.github.io/mkdocs-manpage/

This plugin lets you generate a manual page of your docs site, usable through `man`. It uses the fabulous #pandoc to convert HTML to the manpage format.

Here is how it looks:

@codeHaiku i use #mkdocs for documentation.

I moved my blog over onto #mkdocs #material (shoutout to @squidfunk 🤩), running on #GitHub pages.

So happy to finally be able to use those ✨ sweet ✨ looking admonitions, icons, emojis etc that look consistently awesome! 🎉

https://fredrikaverpil.github.io

@squidfunk

#MkDocs look very cool at first sight!!!

Quick question, does the search feature work even if hosted on a private static web server? I assume the answer is yes since it is written that it could even work without a regular server, when building for offline usage (that is not what I'm asking).

The real question is how perfomant is it when doc size scale? Any stats or clues?

All in all, I'd say it is *WAY* easier than a server side implementation like apache lucene and the like!!!

For those of you who use #Python to create your web site with #mkdocs, you might want to consider this package for adding executable code to your docs. Learn more at: https://bouillotvincent.gitlab.io/pyodide-mkdocs/. Already used it? Let me know what you think!