mstdn.social is one of the many independent Mastodon servers you can use to participate in the fediverse.
A general-purpose Mastodon server with a 500 character limit. All languages are welcome.

Administered by:

Server stats:

16K
active users

#mkdocs

1 post1 participant0 posts today

I released both TypeScript and C handler for #mkdocstrings to the public. My time is limited, my knowledge of these languages too, and these handlers are experimental, so I decided to make them public, hoping they'll get traction and contributions from people experienced in these languages 🙂

- mkdocstrings.github.io/typescr
- mkdocstrings.github.io/c/

mkdocstrings.github.ioOverview - mkdocstrings-typescriptA Typescript handler for mkdocstrings.

Why Obsidian integrates better with #MkDocs than #GoHugo?

  1. MkDocs is really built for documentation (and notes), whereas Hugo are primarily for blogs
  2. Linking your notes in Obsidian translate into correct link in the output html files in MkDocs, whereas in Hugo you need to use rel or relref shortcodes.

So... First experiments with using Obsidian and mkdocs to create a static website has been successful.

As have been tests, setting up the free version of CloudFlare to protect my stuff from 'AI crawler bots'.

Next on the list, converting a Wordpress blog into an Obsidian vault and turn it into a static website.

With the current situation at Wordpress going on, I'm not exactly trusting them...

Weaving together my existing #selfhosted services to publish a university course schedule (tos.kultwiki.net/) from a #forgejo git repository (learn.kultwiki.net/thomas/TOSV). #ForgejoActions start #mkdocs and the result is rsynced to #NginxProxyManager, which serves it as static pages. Took a while to figure out how to run actions across docker containers but it is always rewarding to streamline workflows while retaining complete control.

tos.kultwiki.netTheories of Science

Thinking about transitioning my #blogging from #nikola to #mkdocs

Nikola is great but I've always felt like writing in Markdown is an also ran use case, as its native lingua franca is my long time nemesis #restructuredtext (Hate hate HATE! :) ).

mkdocs is built from the ground up to be super simple. Give it a pile of Markdown and it'll generate a site. There's a nice plugin for generating a blog:

github.com/squidfunk/mkdocs-ma

Documentation that simply works. Contribute to squidfunk/mkdocs-material development by creating an account on GitHub.
GitHubmkdocs-material/docs/setup/setting-up-a-blog.md at master · squidfunk/mkdocs-materialDocumentation that simply works. Contribute to squidfunk/mkdocs-material development by creating an account on GitHub.