compile docs

.github/workflows/ci.yml

@@ -80,6 +80,23 @@ jobs:
       uses: actions/checkout@v4
       with:
         fetch-depth: 0
+    - name: Compile the docs
+      run: |
+        sudo apt update
+        sudo apt install latexmk texlive-latex-recommended texlive-latex-extra tex-gyre make
+        source $CONDA/bin/activate
+        conda install -c defaults -c conda-forge sphinx cloud_sptheme
+        pushd doc
+        sphinx-build -b latex -d _build/doctrees . _build/latex
+        sphinx-build -b html -d _build/doctrees . _build/html
+        pushd _build/latex
+        latexmk -pdf CVX.tex
+        popd
+        popd
+        mv doc _doc
+        mkdir doc
+        mv _doc/_build/{html,latexpdf/CVX.pdf} doc/
+        rm -rf _doc
     - name: Extract version info
       run: |
         /bin/echo -n Extracting and updating version information...

doc/conf.py

@@ -116,7 +116,7 @@
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-html_logo = 'cvxrlogo.png'
+html_logo = '_static/cvxrlogo.png'
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
@@ -178,7 +178,7 @@
 latex_elements = {
 	'papersize': 'letterpaper',
 	'pointsize': '11pt',
-	'preamble': '\usepackage{amsmath,amssymb}',
+	'preamble': r'\usepackage{amsmath,amssymb}',
 }
 
 # Grouping the document tree into LaTeX files. List of tuples