docs - more restructuring

docs/requirements.txt

@@ -3,4 +3,4 @@ sphinx==7.1.2
 docutils==0.18.1
 jinja2==3.1.6
 sphinx-design==0.5.0
-sphinxawesome-theme==6.0.0b2
+sphinxawesome-theme==5.3.2

docs/source/_static/luadoc.css

@@ -17,14 +17,11 @@
     padding: 0px;
 }
 
-@media (prefers-color-scheme: dark) {
+html.dark #luadoc pre.example,
-  #luadoc pre.example,
+html.dark #luadoc pre.example code {
-  #luadoc pre.example code {
+  background-color: hsl(var(--muted));
-    background-color: hsl(var(--muted));
+  color: #ffffff;
-    color: #ffffff;
-  }
 }
-
 #luadoc > p:nth-child(1) {
   margin: 12px 0 12px 0;
 }

docs/source/_static/theme-override.css

@@ -1,11 +1,9 @@
-#content a.sd-badge:not(.toc-backref)  {
+#content a.sd-badge:not(.toc-backref), #content table a:not(.toc-backref)  {
     text-decoration: none;
 }
 
-@media (prefers-color-scheme: dark) {
+.dark\:invert {
-    .dark\:invert {
+    --tw-invert: none !important;
-        --tw-invert: none;
-    }
 }
 
 code {
@@ -19,3 +17,7 @@ code {
 .md-content {
     margin-left: 500px; /* match the new sidebar width */
 }
+
+#searchbox kbd {
+    display: none !important;
+}

docs/source/conf.py

@@ -136,7 +136,8 @@ exclude_patterns = []
 #show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'github-dark'
+pygments_style = 'sphinx'
+pygments_style_dark = 'github-dark'
 
 # A list of ignored prefixes for module index sorting.
 #modindex_common_prefix = []

docs/source/index.rst

@@ -1,18 +1,20 @@
 Welcome to OpenMW's Documentation!
 ==================================
 
+This documentation covers all aspects of OpenMW development, scripting, and content creation.
+Use the categorized sections below to quickly access technical references, modding tools, and installation guides.
+
 .. toctree::
 	:caption: Reference
-	:hidden:
+   	:titlesonly:
 	:maxdepth: 4
 
 	reference/modding/index
 	reference/postprocessing/index
-	reference/documentationHowTo
 
 .. toctree::
 	:caption: Lua
-	:hidden:
+	:titlesonly:
 	:maxdepth: 4
 
 	reference/lua-scripting/overview
@@ -21,7 +23,7 @@ Welcome to OpenMW's Documentation!
 
 .. toctree::
 	:caption: Help
-	:hidden:
+	:titlesonly:
 	:maxdepth: 4
 
 	manuals/installation/index

docs/source/reference/lua-scripting/index_auxpackages.rst

@@ -7,10 +7,10 @@ Auxiliary Packages
 .. toctree::
     :hidden:
 
-    aux_calendar <openmw_aux_calendar>
+    calendar <openmw_aux_calendar>
-    aux_time <openmw_aux_time>
+    time <openmw_aux_time>
-    aux_ui <openmw_aux_ui>
+    ui <openmw_aux_ui>
-    aux_util <openmw_aux_util>
+    util <openmw_aux_util>
 
 
 **Auxiliary packages**

docs/source/reference/lua-scripting/index_interfaces.rst

@@ -16,7 +16,7 @@ Interfaces
     ItemUsage <interface_item_usage>
     MWUI <interface_mwui>
     Settings <interface_settings>
-    Skill_progression <interface_skill_progression>
+    SkillProgression <interface_skill_progression>
     UI <interface_ui>
     Crimes <interface_crimes>
 

docs/source/reference/modding/custom-models/index.rst

@@ -16,6 +16,7 @@ Below is a quick overview of supported formats, followed by separate articles wi
 
 .. toctree::
 	:caption: Table of Contents
+	:hidden:
 	:maxdepth: 1
 
 	pipeline-blender-collada-static-models

docs/source/reference/modding/settings/index.rst

@@ -50,28 +50,28 @@ The ranges included with each setting are the physically possible ranges, not re
 	:hidden:
 	:maxdepth: 2
 
-	camera
+	Camera <camera>
-	cells
+	Cells <cells>
-	fog
+	Fog <fog>
-	groundcover
+	Groundcover <groundcover>
-	map
+	Map <map>
-	GUI
+	GUI <GUI>
-	HUD
+	HUD <HUD>
-	game
+	Game <game>
-	general
+	General <general>
-	lua
+	Lua <lua>
-	shaders
+	Shaders <shaders>
-	shadows
+	Shadows <shadows>
-	input
+	Input <input>
-	saves
+	Saves <saves>
-	sound
+	Sound <sound>
-	terrain
+	Terrain <terrain>
-	video
+	Video <video>
-	water
+	Water <water>
-	windows
+	Windows <windows>
-	navigator
+	Navigator <navigator>
-	physics
+	Physics <physics>
-	models
+	Models <models>
-	postprocessing
+	Postprocessing <postprocessing>
-	stereo
+	Stereo <stereo>
-	stereoview
+	Stereoview <stereoview>

docs/source/reference/modding/texture-modding/texture-basics.rst

@@ -1,5 +1,3 @@
-autosectionlabel_prefix_document = True
-
 ######################
 Texture Modding Basics
 ######################