From 733631a77188d3a21ebbc55a45007f9952810c03 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 17:39:10 -0700
Subject: [PATCH] docs - more styling

---
 docs/source/_static/luadoc.css                | 36 ++++++++++++-------
 docs/source/_static/theme-override.css        | 24 +++++++++++++
 .../installation/install-game-files.rst       |  5 ++-
 .../manuals/installation/install-openmw.rst   |  4 +--
 4 files changed, 53 insertions(+), 16 deletions(-)

diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index b20f076204..f7fc66a550 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -1,9 +1,9 @@
-#luadoc code, #luadoc tt {
+#luadoc code, #luadoc tt, #luadoc p em {
     font-family: monospace;
 }
 
 #luadoc pre.example {
-    background-color: #eeffcc;
+    background-color: hsl(var(--accent)) !important;
     padding: 10px;
     margin: 10px 0 10px 0;
     overflow-x: auto;
@@ -11,7 +11,7 @@
 
 #luadoc pre.example code {
     color: black;
-    background-color: #eeffcc;
+    background-color: hsl(var(--accent)) !important;
     border: none;
     white-space: pre;
     padding: 0px;
@@ -22,15 +22,33 @@ html.dark #luadoc pre.example code {
   background-color: hsl(var(--muted));
   color: #ffffff;
 }
+
+#luadoc code {
+  background-color: unset;
+}
+
+#content #luadoc code a:not(.toc-backref) {
+  font-weight: 600;
+}
+
 #luadoc > p:nth-child(1) {
   margin: 12px 0 12px 0;
 }
 
-#luadoc a:not(:link) {
+#luadoc a:not([href]) {
     font-weight: bold;
-    color: var(--color-content-foreground);
     text-decoration: none;
     cursor: inherit;
+    color: inherit;
+}
+
+#luadoc a:not([href]):hover {
+    color: inherit;
+}
+
+#luadoc code a em {
+  color: inherit;
+  font-weight: inherit;
 }
 
 #luadoc em {
@@ -38,20 +56,12 @@ html.dark #luadoc pre.example code {
   font-style: normal;
 }
 
-#luadoc p em { font-family: 'monospace';}
-
-#luadoc a:link { font-weight: bold; color: var(--color-link);; text-decoration: none; }
-#luadoc a:visited { font-weight: bold; color: var(--color-link--hover); text-decoration: none; }
-#luadoc a:link:hover { text-decoration: underline; }
-
 .context-wrapper {
     display: flex;
     margin-top: 14px;
     gap: 4px;
 }
 
-#luadoc ul { list-style-type: disc; }
-
 #luadoc ul { list-style-type: disc; }
 #luadoc li {list-style: bullet;}
 
diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index f0a8a13302..6124a64e53 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -1,8 +1,32 @@
+:root {
+    --link: #4a90e2;
+    --link-hover: #1c6cd9;
+}
+
+/* Less aggressive dark background */
+.dark {
+    --background: 220 20% 7% !important;
+}
+
 /* Hide text underline in tables since the underlines clash with table lines */
 #content a.sd-badge:not(.toc-backref), #content table a:not(.toc-backref)  {
     text-decoration: none;
 }
 
+/* Override link colors, default is foreground */
+#content a:not(.toc-backref) {
+    color: var(--link);
+}
+
+#content a:not(.toc-backref):hover, #content a:not(.toc-backref):focus {
+    color: var(--link-hover);
+}
+
+#content .highlight {
+    background-color: hsl(var(--accent)) !important;
+    border-radius: 0.25rem;
+}
+
 /* Disables the saturation filter on project icon in dark mode */
 .dark\:invert {
     --tw-invert: none !important;
diff --git a/docs/source/manuals/installation/install-game-files.rst b/docs/source/manuals/installation/install-game-files.rst
index 42d4eb8d78..cb44f7d1de 100644
--- a/docs/source/manuals/installation/install-game-files.rst
+++ b/docs/source/manuals/installation/install-game-files.rst
@@ -163,7 +163,10 @@ Debian/Ubuntu - using "Steam Proton" & "OpenMW launcher".
 #. Launch "OpenMW launcher" and follow the setup wizard, when asked, point it at the location you installed Morrowind to, we will be looking for the directory that contains the Morrowing.esm file, for example '/steam library/steamapps/common/Morrowind/Data Files/'.
 #. Everything should now be in place, click that big "PLAY" button and fire up OpenMW.
 
-Note, Bloodmoon.esm needs to be below Tribunal.esm in your datafiles list, if you don't have the right order a red "!" will apear next to the filename in the datafiles section of the OpenMW launcher, just drag bloodmoon below tribunal to fix it.
+.. note::
+	`Bloodmoon.esm` needs to be below `Tribunal.esm` in your data files list.
+	If you don't have the right order a red `!` will apear next to the filename in the data files section of the OpenMW launcher.
+	To fix, drag `Bloodmoon.esm` below `Tribunal.esm`.
 
 Wine
 ~~~~
diff --git a/docs/source/manuals/installation/install-openmw.rst b/docs/source/manuals/installation/install-openmw.rst
index c4cb834632..5db6964072 100644
--- a/docs/source/manuals/installation/install-openmw.rst
+++ b/docs/source/manuals/installation/install-openmw.rst
@@ -31,8 +31,8 @@ Add it and install OpenMW::
 	$ sudo apt update
 	$ sudo apt install openmw
 
-The Arch Linux Way
-==================
+Arch Linux
+==========
 
 The binary package is available in the official [community] Repositories.
 To install, simply run the following as root (or in sudo)::