Update documentation requirements

.readthedocs.yaml

@@ -4,13 +4,13 @@
 version: 2
 
 sphinx:
-  configuration: docs/conf.py
+   configuration: docs/conf.py
 
-formats: [htmlzip, pdf]
+formats: [htmlzip, pdf, epub]
 
 python:
-  install:
-  - requirements: docs/sphinx/requirements.txt
+   install:
+   - requirements: docs/sphinx/requirements.txt
 
 build:
    os: ubuntu-22.04
@@ -18,3 +18,5 @@ build:
       python: "3.10"
    apt_packages:
      - "doxygen"
+     - "gfortran" # For pre-processing fortran sources
+     - "graphviz" # For dot graphs in doxygen

docs/sphinx/requirements.in

-rocm-docs-core==1.2.0
+rocm-docs-core[api_reference]==1.2.0

docs/sphinx/requirements.txt

@@ -25,7 +25,12 @@ cffi==1.16.0
 charset-normalizer==3.3.2
     # via requests
 click==8.1.7
-    # via sphinx-external-toc
+    # via
+    #   click-log
+    #   doxysphinx
+    #   sphinx-external-toc
+click-log==0.4.0
+    # via doxysphinx
 cryptography==42.0.7
     # via pyjwt
 deprecated==1.2.14
@@ -36,6 +41,8 @@ docutils==0.21.2
     #   myst-parser
     #   pydata-sphinx-theme
     #   sphinx
+doxysphinx==3.3.8
+    # via rocm-docs-core
 fastjsonschema==2.19.1
     # via rocm-docs-core
 gitdb==4.0.11
@@ -50,6 +57,10 @@ jinja2==3.1.4
     # via
     #   myst-parser
     #   sphinx
+libsass==0.22.0
+    # via doxysphinx
+lxml==4.9.4
+    # via doxysphinx
 markdown-it-py==3.0.0
     # via
     #   mdit-py-plugins
@@ -60,8 +71,12 @@ mdit-py-plugins==0.4.1
     # via myst-parser
 mdurl==0.1.2
     # via markdown-it-py
+mpire==2.10.2
+    # via doxysphinx
 myst-parser==3.0.1
     # via rocm-docs-core
+numpy==1.26.4
+    # via doxysphinx
 packaging==24.0
     # via
     #   pydata-sphinx-theme
@@ -77,12 +92,17 @@ pygithub==2.3.0
 pygments==2.18.0
     # via
     #   accessible-pygments
+    #   mpire
     #   pydata-sphinx-theme
     #   sphinx
+pyjson5==1.6.6
+    # via doxysphinx
 pyjwt[crypto]==2.8.0
     # via pygithub
 pynacl==1.5.0
     # via pygithub
+pyparsing==3.1.2
+    # via doxysphinx
 pyyaml==6.0.1
     # via
     #   myst-parser
@@ -92,7 +112,7 @@ requests==2.32.3
     # via
     #   pygithub
     #   sphinx
-rocm-docs-core==1.2.0
+rocm-docs-core[api-reference]==1.2.0
     # via -r requirements.in
 smmap==5.0.1
     # via gitdb
@@ -135,6 +155,8 @@ sphinxcontrib-serializinghtml==1.1.10
     # via sphinx
 tomli==2.0.1
     # via sphinx
+tqdm==4.66.4
+    # via mpire
 typing-extensions==4.12.0
     # via
     #   pydata-sphinx-theme