[ci skip] update docs build

.readthedocs.requirements.txt

@@ -1,5 +1,6 @@
-sphinx == 2.4.4
-breathe == 4.11.0
-sphinxcontrib-katex == 0.6.0
+sphinx == 5.1.1
+breathe == 4.34.0
+sphinx-rtd-theme == 1.0.0
+sphinxcontrib-katex == 0.8.6
 sphinxcontrib-contentui == 0.2.5
-docutils == 0.16
+docutils == 0.17.1

.readthedocs.yml

@@ -1,7 +1,7 @@
 requirements_file: .readthedocs.requirements.txt
 
-# conda:
-#     file: docs/environment.yml
+conda:
+  file: docs/environment.yml
 
 python:
-  version: 3.6
+  version: "3.8"

docs/environment.yml

@@ -1,9 +1,15 @@
-# problem: katex is not available on conda, yet
 
-name: gcem-docs
+name: optimlib-docs
 
 channels:
   - conda-forge
 
 dependencies:
-  - breathe
+  - doxygen=1.9.3
+  - pip:
+    - sphinx==5.1.1
+    - breathe==4.34.0
+    - sphinx-rtd-theme==1.0.0
+    - sphinxcontrib-katex==0.8.6
+    - sphinxcontrib-contentui==0.2.5
+    - docutils==0.17.1

docs/source/conf.py

@@ -15,7 +15,7 @@
 html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 
 def setup(app):
-    app.add_stylesheet("main_stylesheet.css")
+    app.add_css_file("main_stylesheet.css")
 
 # extensions = ['breathe','sphinx.ext.mathjax']
 extensions = ['breathe','sphinxcontrib.katex']