Moved sphinx files to an own folder

index.rst

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

roles/README.md

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

roles/index.rst

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

sphinx/Makefile

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

sphinx/conf.py

@@ -6,6 +6,8 @@
 # -- 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'
@@ -27,11 +29,12 @@ html_theme = 'alabaster'
 html_static_path = ['_static']
 html_sidebars = {
     '**': [
-        'globaltoc.html',    # globales Inhaltsverzeichnis
+        'localtoc.html',  # Zeigt die lokale Navigation an
-        'relations.html',    # Prev/Next Navigation
+        'relations.html',  # Vorherige/Nächste Seite
-        'searchbox.html',    # Suchfeld
+        'searchbox.html',  # Suchfeld
     ]
 }
+
 html_theme_options = {
     'fixed_sidebar': True,
 }
@@ -54,9 +57,3 @@ myst_enable_extensions = [
     "colon_fence",  # Für erweiterte Syntax wie ::: Hinweisboxen etc.
     # weitere Erweiterungen nach Bedarf
 ]
-#
-#myst_xref_ignore = [
-#    r"\./roles/.*",
-#    "../"
-#]
-