Modifications for changed build on readthedocs

Author: j0r1

.readthedocs.yaml

@@ -0,0 +1,25 @@
+# .readthedocs.yaml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+# Set the version of Python and other tools you might need
+build:
+  os: ubuntu-22.04
+  apt_packages:
+    - doxygen
+    - graphviz
+  tools:
+    python: "3.11"
+
+# Build documentation in the docs/ directory with Sphinx
+sphinx:
+  configuration: sphinxdoc/source/conf.py
+
+# We recommend specifying your dependencies to enable reproducible builds:
+# https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+# python:
+#   install:
+#   - requirements: docs/requirements.txt

sphinxdoc/source/conf.py

@@ -353,11 +353,14 @@ def changeVersionString():
 
 try:
     if os.getenv("READTHEDOCS") == 'True':
-        dstdir = "_build/html"
+        dstdir = os.path.join(os.environ["READTHEDOCS_OUTPUT"], "html")
     else:
         dstdir = "../build/html"
 
     dstdir = os.path.abspath(dstdir)
+    if not os.path.exists(dstdir):
+        print("Destination directory did not exist, creating it")
+        os.makedirs(dstdir, exist_ok=True)
 
     os.chdir("../../")
     if os.path.exists("Doxyfile"):
@@ -391,11 +394,12 @@ def changeVersionString():
 finally:
     os.chdir(curpath)
 
-with open("test.rst", "wb") as f:
+with open("test.rst", "wt") as f:
     f.write("Test output\n")
     f.write("===========\n\n")
     f.write(".. code-block:: none\n\n")
     output = subprocess.check_output("which doxygen ; pwd ; set ; ls ; ls _build ; ls _build/html ; ls ../ ; ", shell = True)
+    output = output.decode()
     for l in output.splitlines():
         f.write("    ")
         f.write(l)