Makefile

@@ -3,10 +3,10 @@
 
 # You can set these variables from the command line, and also
 # from the environment for the first two.
-SPHINXOPTS    ?= -c .
+SPHINXOPTS    ?=
 SPHINXBUILD   ?= sphinx-build
-SOURCEDIR     = ../
-BUILDDIR      = ../docs
+SOURCEDIR     = /home/kevinveenbirkenbach/Repositories/github.com/kevinveenbirkenbach/cymais/
+BUILDDIR      = docs
 
 # Put it first so that "make" without argument is like "make help".
 help:

conf.py

@@ -6,8 +6,6 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
-import sys
-
 project = 'CyMaIS - Cyber Master Infrastructure Solution'
 copyright = '2025, Kevin Veen-Birkenbach'
 author = 'Kevin Veen-Birkenbach'
@@ -29,12 +27,11 @@ html_theme = 'alabaster'
 html_static_path = ['_static']
 html_sidebars = {
     '**': [
-        'localtoc.html',  # Zeigt die lokale Navigation an
-        'relations.html',  # Vorherige/Nächste Seite
+        'globaltoc.html',    # globales Inhaltsverzeichnis
+        'relations.html',    # Prev/Next Navigation
         'searchbox.html',    # Suchfeld
     ]
 }
-
 html_theme_options = {
     'fixed_sidebar': True,
 }
@@ -57,3 +54,9 @@ myst_enable_extensions = [
     "colon_fence",  # Für erweiterte Syntax wie ::: Hinweisboxen etc.
     # weitere Erweiterungen nach Bedarf
 ]
+#
+#myst_xref_ignore = [
+#    r"\./roles/.*",
+#    "../"
+#]
+

index.rst

@@ -1,10 +1,10 @@
-Cyber Master Infrastructure Solution documentation
+.. CyMaIS - Cyber Master Infrastructure Solution documentation
 ===========================================================
 
 .. toctree::
-   :maxdepth: 1
-   :caption: About CyMaIS:
+   :maxdepth: 5
+   :caption: Index:
    :glob:
+   :titlesonly:
 
-   *
-   roles/index.rst
+   **

roles/README.md

@@ -1,3 +0,0 @@
-test
-
-# h1

roles/index.rst

@@ -1,13 +0,0 @@
-Applications and Roles
-===========================================================
-
-.. include:: ./README.md
-   :parsers: myst_parser
-
-.. toctree::
-   :maxdepth: 1
-   :caption: Included Applications:
-   :glob:
-
-   */README
-