Try to fix developer documentation deployment (#372)

Author: mcbarton

.readthedocs.yaml

@@ -5,12 +5,12 @@ sphinx:
   builder: html
 
 build:
-  os: "ubuntu-22.04"
+  os: "ubuntu-24.04"
   tools:
     python: "3.11"
   apt_packages:
-    - clang-13
+    - clang-18
     - cmake
-    - libclang-13-dev
-    - llvm-13-dev
-    - llvm-13-tools
+    - libclang-18-dev
+    - llvm-18-dev
+    - llvm-18-tools

docs/DevelopersDocumentation.rst

@@ -429,4 +429,4 @@ CppInterOp maintains an internal Doxygen documentation of its components.
 Internal documentation aims to capture intrinsic details and overall usage of
 code components. The goal of internal documentation is to make the codebase
 easier to understand for the new developers. Internal documentation can be
-visited : `here </en/latest/build/html/index.html>`_
+visited : `here <build/html/index.html>`_

docs/conf.py

@@ -50,8 +50,8 @@
 html_extra_path = [CPPINTEROP_ROOT + '/build/docs/']
 
 import subprocess
-command = 'mkdir {0}/build; cd {0}/build; cmake ../ -DClang_DIR=/usr/lib/llvm-13/build/lib/cmake/clang\
-         -DLLVM_DIR=/usr/lib/llvm-13/build/lib/cmake/llvm -DCPPINTEROP_ENABLE_DOXYGEN=ON\
+command = 'mkdir {0}/build; cd {0}/build; cmake ../ -DClang_DIR=/usr/lib/llvm-18/lib/cmake/clang \
+         -DLLVM_DIR=/usr/lib/llvm-18/lib/cmake/llvm -DCPPINTEROP_ENABLE_DOXYGEN=ON \
          -DCPPINTEROP_INCLUDE_DOCS=ON'.format(CPPINTEROP_ROOT)
 subprocess.call(command, shell=True)
 subprocess.call('doxygen {0}/build/docs/doxygen.cfg'.format(CPPINTEROP_ROOT), shell=True)