BUG: Transform SVG files in Sphinx

Transform the Binder badge SVG's for Latex / PDF generation, which does
not support SVG's.

Author: thewtex

.github/workflows/build-test-publish.yml

@@ -278,6 +278,7 @@ jobs:
           sudo apt-get install gnuplot dvipng
           sudo apt-get install texlive-full
           sudo apt-get install pandoc
+          sudo apt-get install imagemagick
 
           python -m pip install --upgrade pip
           python -m pip install ninja

Formatting/conf.py.in

@@ -42,7 +42,7 @@ primary_domain = 'cpp'
 # Add any Sphinx extension module names here, as strings. They can be extensions
 # coming with Sphinx (named 'sphinx.ext.*') or your custom ones.
 extensions = ['sphinx.ext.todo', 'sphinx.ext.imgmath', 'sphinx.ext.ifconfig',
-    'sphinx.ext.viewcode', 'breathe', 'doxylink', 'breathelink', 'nbsphinx']
+    'sphinx.ext.viewcode', 'sphinx.ext.imgconverter', 'breathe', 'doxylink', 'breathelink', 'nbsphinx']
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['templates']

README.rst

@@ -72,6 +72,7 @@ If building the documentation:
 - nbsphinx_
 - gnuplot_
 - dvipng_ ( for rendered equations )
+- imagemagick_
 
 PDF generation requires a TeX distribution like `TeX Live`_ or MiKTeX_.
 
@@ -96,3 +97,4 @@ Run the bash script ``SetupForDevelopment.sh``::
 .. _dvipng: https://sourceforge.net/projects/dvipng/
 .. _Pandoc: https://pandoc.org/
 .. _nbsphinx: https://nbsphinx.readthedocs.io/
+.. _imagemagick: https://www.imagemagick.org/