So sad to see the Mkdocs drama leading to a version 2 which smells lock-in by a lonely developer ignoring a community of thousands of users/contributors and the other part the @zensical team releasing a latest version of unmaintained Material for Mkdocs with a huge and unnecessary warning about mkdocs 2 incompatibility that feels somewhat FUD-driven.

#Mkdocs #MaterialForMkdocs #opensource

🚀 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

1.17.0 · Guts mkdocs-rss-plugin · Discussion #342

What's Changed Features and enhancements 🎉 refacto(material_integrations): use POO to manage integrations with Material theme framework by @Guts in #335 update(chore): use typed dataclasses instead...

GitHub

🚀 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

Changelog - MkDocs RSS Plugin

Release notes of the RSS plugin for MkDocs.

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

Personal website

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
Material for MkDocs

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

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+

MkDocs RSS Plugin

MkDocs RSS plugin: generate RSS and JSON feeds for your static website using git log ad YAML frontmatter (markdown pages'metadata header).

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.

  

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

#linux #sad #foss

Home - blendOS Docs

blendOS docs index

🚀 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

Changelog - MkDocs RSS Plugin

Release notes of the RSS plugin for MkDocs.

📚 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  (#Mkdocs
et #MaterialForMkdocs de @squidfunk ). Les grands esprits ne seront pas perdus.

Documentation Géoplateforme