add(integrations): support integrations with MaterialX theme, fork of Material for Mkdocs

[Guts]

FYI @jaywhj

[jaywhj]

@Guts Excellent 👍

This PR uses dynamic retrieval of the theme name instead, which definitely offers better compatibility.

I will add the mkdocs-rss-plugin to the plugin recommendations in the MaterialX documentation.

[Guts]

Thanks for your fork.

I will add the mkdocs-rss-plugin to the plugin recommendations in the MaterialX documentation.

It's already done since it's was in Material https://jaywhj.github.io/mkdocs-materialx/setup/setting-up-a-blog.html#rss

[codecov]

Codecov Report

❌ Patch coverage is 76.92308% with 3 lines in your changes missing coverage. Please review.
✅ Project coverage is 83.24%. Comparing base (eea4e16) to head (1432ed6).
⚠️ Report is 3 commits behind head on main.

Files with missing lines	Patch %	Lines
...ocs_rss_plugin/integrations/theme_material_base.py	57.14%	2 Missing and 1 partial ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #437      +/-   ##
==========================================
- Coverage   83.52%   83.24%   -0.28%     
==========================================
  Files          11       11              
  Lines         783      788       +5     
  Branches      132      133       +1     
==========================================
+ Hits          654      656       +2     
- Misses         84       86       +2     
- Partials       45       46       +1     

Flag	Coverage Δ
unittests	83.24% <76.92%> (-0.28%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
..._plugin/integrations/theme_material_blog_plugin.py	80.00% <100.00%> (ø)
...lugin/integrations/theme_material_social_plugin.py	87.17% <100.00%> (ø)
...ocs_rss_plugin/integrations/theme_material_base.py	78.26% <57.14%> (-10.63%)	⬇️

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[jaywhj]

@Guts

I have another suggestion you could try.

I noticed that mkdocs-rss-plugin uses the creation and update dates of documents. You can obtain accurate dates directly via the API provided by MaterialX.

All of these date-related issues should be resolved, for example: #377 #317

In the past, neither MkDocs, mkdocs-material, nor other similar static site generators had a perfect solution for this.

MaterialX has now solved this (via its built-in plugin). It can accurately retrieve the original document timestamps in any environment (with or without Git) delivering a much better user experience. This data capability is already used to generate the lastmod field in sitemap.xml.

for detail, see developer-api

[Guts]

Can you fill an issue please?