From e754f0ecdb864f6eb13e2a49d6ee8548ea837191 Mon Sep 17 00:00:00 2001
From: Karen Stuitje <e.k.e.stuitje@student.rug.nl>
Date: Fri, 29 May 2026 16:07:28 +0200
Subject: [PATCH 1/3] add extra.css for diagrams and remove redundant style
 configuration in footnotes.css

---
 docs/stylesheets/extra.css     | 20 ++++++++++++++++++++
 docs/stylesheets/footnotes.css |  8 --------
 2 files changed, 20 insertions(+), 8 deletions(-)
 create mode 100644 docs/stylesheets/extra.css

diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
new file mode 100644
index 0000000..af97b0d
--- /dev/null
+++ b/docs/stylesheets/extra.css
@@ -0,0 +1,20 @@
+.mod-diagram {
+  width: 100%;
+  height: auto;
+  aspect-ratio: 12.1 / 9;  /* specific aspect ratio for the module diagram */
+  display: none;
+}
+/* Light mode: show light diagram */
+[data-md-color-scheme="default"] .mod-diagram--light {
+  display: block;
+}
+
+/* Dark mode: show dark diagram (Material's default dark scheme is "slate") */
+[data-md-color-scheme="slate"] .mod-diagram--dark {
+  display: block;
+}
+
+/* Remove underline from links that contain only an image */
+.md-typeset p a:has(> img) {
+  text-decoration: none;
+}
\ No newline at end of file
diff --git a/docs/stylesheets/footnotes.css b/docs/stylesheets/footnotes.css
index f3729cf..20bb8fb 100644
--- a/docs/stylesheets/footnotes.css
+++ b/docs/stylesheets/footnotes.css
@@ -18,12 +18,4 @@
   font-size: 1em !important;
 }
 
-/* reduce space under the page title */
-.md-typeset h1 {
-  margin-bottom: 0.2rem;  /* try 0, 0.2rem, 0.5rem */
-}
 
-/* optionally reduce any top margin on the first image */
-.md-typeset h1 + p img {
-  margin-top: 0;
-}

From 9c7ce77158771673d496da64d13873b2b2eb40fb Mon Sep 17 00:00:00 2001
From: Karen Stuitje <e.k.e.stuitje@student.rug.nl>
Date: Fri, 29 May 2026 16:07:50 +0200
Subject: [PATCH 2/3] add extra.css and remove PLATON links + update fastchem
 and atmodeller

---
 mkdocs.yml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/mkdocs.yml b/mkdocs.yml
index 80c4bc0..842a5f1 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -78,10 +78,9 @@ nav:
       - 🔗 Zalmoxis: https://proteus-framework.org/Zalmoxis/
       - 🔗 Aragog: https://proteus-framework.org/aragog/
       - 🔗 SPIDER:  https://proteus-framework.org/SPIDER/
-      - 🔗 Atmodeller: https://atmodeller.readthedocs.io/en/latest/
-      - 🔗 FastChem: https://newstrangeworlds.github.io/FastChem/
-      - 🔗 PLATON: https://platon.readthedocs.io/en/latest/
-      - 🔗 SOCRATES: https://github.com/FormingWorlds/SOCRATES/
+      - 🔗 Atmodeller: https://github.com/FormingWorlds/Atmodeller/
+      - 🔗 FastChem: https://github.com/FormingWorlds/FastChem/
+      - 🔗 SOCRATES: https://proteus-framework.org/SOCRATES/
 
 # footer:
 extra:
@@ -139,6 +138,7 @@ theme:
 extra_css:
   - stylesheets/proteus_theme.css
   - stylesheets/footnotes.css
+  - stylesheets/extra.css
  
 markdown_extensions:
   - admonition

From 6e6419cd2f87121992b6c788be41c77301a6c2bc Mon Sep 17 00:00:00 2001
From: Karen Stuitje <e.k.e.stuitje@student.rug.nl>
Date: Fri, 29 May 2026 16:08:05 +0200
Subject: [PATCH 3/3] add silent title and update schematic

---
 docs/proteus_framework.md | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/docs/proteus_framework.md b/docs/proteus_framework.md
index 47f76d4..9912d6f 100644
--- a/docs/proteus_framework.md
+++ b/docs/proteus_framework.md
@@ -1,3 +1,7 @@
+---
+title: MORS in the PROTEUS framework
+---
+
 <h1 align="center">
     <a href="https://proteus-framework.org">
     <div>
@@ -7,14 +11,11 @@
     </a>
 </h1>
 
-MORS is the stellar rotation and evolution module of <b>PROTEUS</b> (/ˈproʊtiəs, PROH-tee-əs), a modular Python framework that simulates the coupled evolution of the atmospheres and interiors of rocky planets and exoplanets. A schematic of PROTEUS components and corresponding modules can be found below. Its coupling to MORS is explained [here](Explanations/proteus.md).
-<br>
-<br>
-You can find the <b>documentation of each PROTEUS module</b> in the sidebar.
-<br>
+
+MORS is the **stellar rotation and evolution module** of [PROTEUS](https://proteus-framework.org/PROTEUS) (/ˈproʊtiəs/, PROH-tee-əs), a modular Python framework for the coupled evolution of the atmospheres and interiors of rocky planets and exoplanets. A schematic of PROTEUS components and corresponding modules can be found below. Click any module in the diagram to open its documentation, or navigate to it from the sidebar.
 <br>
 
-<p align="center">
-    <img src="assets/PROTEUS_schematic_lightmode.png#only-light" style="max-width: 90%; height: auto;" alt="PROTEUS schematic"><img src="assets/PROTEUS_schematic_darkmode.png#only-dark" style="max-width: 90%; height: auto;" alt="PROTEUS schematic"><br>
-    <b>Schematic of PROTEUS components and corresponding modules.</b>
-</p>
\ No newline at end of file
+<object type="image/svg+xml" data="https://cdn.jsdelivr.net/gh/FormingWorlds/PROTEUS@main/docs/assets/proteus_modules_schematic.svg" class="mod-diagram mod-diagram--light" aria-label="PROTEUS module schematic (light mode)">PROTEUS module schematic (light mode)</object>
+<object type="image/svg+xml" data="https://cdn.jsdelivr.net/gh/FormingWorlds/PROTEUS@main/docs/assets/proteus_modules_schematic_darkmode.svg" class="mod-diagram mod-diagram--dark" aria-label="PROTEUS module schematic (dark mode)">PROTEUS module schematic (dark mode)</object>
+
+<p style="text-align: center;"><strong>Schematic of PROTEUS components and corresponding modules.</strong></p>
\ No newline at end of file