Move from Material for Mkdocs to Zensical
>>> [!note] Migrated issue
<!-- Drupal.org comment -->
<!-- Migrated from issue #3568729. -->
Reported by: [fjgarlin](https://www.drupal.org/user/2495842)
Related to !448
>>>
<h3 id="summary-problem-motivation">Problem/Motivation</h3>
<p>Per this <a href="https://duerrenberger.dev/blog/2025/11/06/material-for-mkdocs-is-no-more">blog post</a>, Material for MkDocs is now in maintenance mode only. There is a new tool called Zensical, by the same authors, which is supposed to be compatible.</p>
<h3 id="summary-proposed-resolution">Proposed resolution</h3>
<p>Let's try the new tool and use it to build the sites. We'll need to update the documentation. According to the posts, the current mkdocs.yml and docs folders set up might just work.</p>
<p>We should offer the possibility of still running the legacy Material theme, so let's also create and document a variable that would force using the old theme, but default to the newest.</p>
<p>Example for GitLab pages in <a href="https://zensical.org/docs/publish-your-site/#gitlab-pages">https://zensical.org/docs/publish-your-site/#gitlab-pages</a></p>
<pre>pages:<br> stage: deploy<br> image: python:latest<br> script:<br> - pip install zensical<br> - zensical build --clean <br> pages:<br> publish: public<br> rules:<br> - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'</pre>
issue