IBX-9609: Upgrade mkdocs (#2627)

* requirements.txt: Upgrade mkdocs to latest
* requirements.txt: Upgrade Markdown to latest
* requirements.txt: Upgrade Pygments to latest
* requirements.txt: Upgrade PyMdown Extensions to latest
* requirements.txt: Upgrade Material for MkDocs to latest
* requirements.txt: Upgrade Mkdocs-Macros to latest
* requirements.txt: Upgrade mkdocs-redirects to latest
* requirements.txt: Upgrade MkDocs Autolinks Plugin to latest
* navigation.css: Fix right ToC (probably due to Material for MkDocs upgrade)
* navigation.css: Fix left ToC (probably due to Material for MkDocs upgrade)
* .readthedocs.yml: Upgrade python & pip (#2653)
* mkdocs: `absolute_links: relative_to_docs`

(cherry picked from commit 97cf2cc)

Author: adriendupuis

.readthedocs.yml

@@ -7,9 +7,8 @@ mkdocs:
 build:
   os: ubuntu-20.04
   tools:
-    python: "3.11"
+    python: "3.13"
 
 python:
   install:
-    - requirements: pip_require.txt
     - requirements: requirements.txt

docs/css/navigation.css

@@ -56,6 +56,7 @@
 .md-nav--secondary {
     padding-left: 10px;
     padding-bottom: 10px;
+    margin-bottom: 0;
     padding-top: 7rem;
     height: calc(100vh - 138px);
 }
@@ -64,9 +65,12 @@
     position: relative;
 }
 
-.md-nav--secondary>ul {
+.md-nav--secondary > ul {
     border-left: 1px solid var(--mid-grey);
     margin-left: 0.4rem;
+}
+
+[dir=ltr] .md-nav--secondary ul.md-nav__list {
     padding-left: 0;
 }
 
@@ -118,7 +122,12 @@
 /* End Page TOC */
 
 /* Main nav */
-.md-nav--primary .md-nav__link {
+[dir=ltr] .md-nav--primary .md-nav__list {
+    padding-left: 0;
+}
+
+[dir=ltr] .md-nav--primary .md-nav__item > .md-nav__link {
+    margin-right: 0;
     font-size: 16px;
 }
 

mkdocs.yml

@@ -4,6 +4,9 @@ site_name: Developer Documentation
 repo_url: https://github.com/ibexa/documentation-developer
 site_url: https://doc.ibexa.co/en/latest/
 copyright: "Copyright 1999-2024 Ibexa AS and others"
+validation:
+    links:
+        absolute_links: relative_to_docs
 nav:
     - 'Ibexa Developer Documentation': 'index.md'
     - Getting started:

pip_require.txt

@@ -1,9 +1,9 @@
-mkdocs==1.5.1
-Pygments==2.15.0
-pymdown-extensions==10.0.1
-Markdown==3.2.1
-mkdocs-material==9.1.1
-mkdocs-macros-plugin==0.7.0
-mkdocs-redirects==1.2.0
-mkdocs-autolinks-plugin==0.7.0
+mkdocs==1.6.1
+Pygments==2.19.1
+pymdown-extensions==10.14.3
+Markdown==3.7
+mkdocs-material==9.6.5
+mkdocs-macros-plugin==1.3.7
+mkdocs-redirects==1.2.2
+mkdocs-autolinks-plugin==0.7.1
 Jinja2==3.1.6