🚀 I've just released the version 1.17.0 of the RSS plugin for MkDocs: https://github.com/Guts/mkdocs-rss-plugin/discussions/342

📰 It improves the integration with the blog plugin of the awesome Material for Mkdocs framework, developed by @squidfunk and co.

📑 More details in documentation: https://guts.github.io/mkdocs-rss-plugin/integrations/#blog-plugin-from-material-theme

#MkdocsRssPlugin #MaterialForMkdocs #RSS #json_feed #MkDocs

🚀 New version 1.16.0 of Mkdocs RSS plugin

It ships an extended integration with Material Social Cards plugin by supporting cards generated for Material Blog posts (which have specific paths).

Release notes: https://guts.github.io/mkdocs-rss-plugin/changelog/#1160---2024-10-24

#Mkdocs #MaterialForMkdocs #RSS

@squidfunk
After my previous experimentation I converted my website to #MaterialForMkDocs , restructured the content and added pages on #photography https://nicorikken.eu/

I checked how usable the #MaterialForMkDocs theme is in text-based webbrowers #lynx and #w3m. I'm impressed with a 'skip to content' to jump over the table of contents, good rendering of tables and footnotes working nicely. Unfortunately search doesn't work, as it depends on JavaScript and uses a popover. I already use the theme for documentation at work and am considering it for my personal website now. I can highly recommend it https://squidfunk.github.io/mkdocs-material/ @squidfunk

After several months with no time to devote to the project, I was able to get back to work on the #RSS plugin for #mkdocs (https://guts.github.io/mkdocs-rss-plugin/).

Some of highlights:

- support for JSON feed (RSS translation into JSON)
- support for multiple instances (typically, a feed for your doc a feed for your blog within the same site base)
- customizable output filenames
- improved integration with social cards of #MaterialForMkdocs framework (cc @squidfunk )
- modernized config to fit Mkdocs 1.6+

I'm completely rewriting #Griffe's docs. Griffe is all about public APIs, so its API docs should be exemplary.

These will be the best docs I've written until now. I've taken inspiration from projects with great documentation: #Hatch, #MaterialforMkDocs and #Textual notably 🙂

After building the #blendos preview #docs with #materialformkdocs, we now have to build a new v4 ISO because of a pkgbuild mirror change from tar.gz to tar.zst. Rudra said he was gonna build a new ISO and has not responded since. v4 currently cannot be installed.

This is wonderful. Rudra is usually absent for a while due to school and Ubuntu Unity, but this is one of the downsides of that.

:blobono:

(the docs are at https://blend-docs-material.pages.dev for now if you even care)

#linux #sad #foss

🚀 Recently, I've released new versions of the RSS plugin for Mkdocs with some exciting improvements and features:

- integration with Social Cards of Material theme of @squidfunk
- compatibility with Mkdocs>=1.4: configuration object, plugin logger, etc.
- renewed documentation
- Python 3.12 support

👀 Check it up: https://guts.github.io/mkdocs-rss-plugin/changelog/#1100---2023-12-17

#RSS #Mkdocs #MaterialForMkdocs

📚 Il y a un effort conséquent sur la documentation écrite en Markdown et publiée sur GitHub Pages : https://geoplateforme.github.io.

Oui, c'est la même techno que @geotribu :geotribu: (#Mkdocs
et #MaterialForMkdocs de @squidfunk ). Les grands esprits ne seront pas perdus.

@minecraft 1.20.2 came out with some neat Resource pack changes and other features, #MaterialForMkDocs releases 9.4.0 with darker dark theme and @Mastodon releases 4.2 with also nice features...

Today is a good day guys.

I updated the CSS and HTML template of my Mastodon-based comment-system to now resemble a actual Mastodon comment more closely.

The CSS also includes colours for Material for MkDocs' white (default) theme!

@MkDocs #materialformkdocs #mkdocs

I've spend the past 4 hours or so making a API reference for the API of my plugin #AdvancedServerList

I'm happy with how it turned out.
Keep in mind that I did this by hand, meaning I didn't use any sort of generator or alike...

https://docs.andre601.ch/AdvancedServerList/api/reference/

#mkdocs #materialformkdocs

@dpecos Made a variant that works for #mkdocs and #materialformkdocs
The Paste has basic instructions on how it can be implemented.
https://paste.gg/p/Andre601/4d1323b59c35421e90bcdc79f6ed8ff2

@dpecos Found your blog post and I'm now curious...
Do you by any chance know what adjustments would be needed to make it work with #mkdocs and the #materialformkdocs theme?

Like, I'm not entirely sure what CSS changes/additions I would need to make to include proper looking mastodon comments for my blog posts.

So far I copied the code snippet and adjusted the variables inside it to make it work with the #jinja2 syntax and so far it seems to work.

Now I just need to properly format everything, so if you could help by any means I would apreciate it (Even if it was just linking the (S)CSS used).

@aviram @feorlen #MaterialForMkDocs is the software, not a hosting platform. It looks closest to what I am aiming for, but it uses a development model where features are released under permissive licenses once the dev hits funding thresholds, but are available to sponsors early. At the moment that includes most of the blogging functionality.

Yesterday night I dedicated some time to improve the documentation of my web framework, and tried enabling #giscus comments. It works wonderfully and it's so user friendly to enable! ❤️

(this is still on my localhost)

#materialformkdocs #mkdocs #documenting