From b60f79909dd7cb848eaff699bcf1aeaa01884d14 Mon Sep 17 00:00:00 2001
From: Timo Heister <timo.heister@gmail.com>
Date: Tue, 10 Dec 2024 10:30:26 -0500
Subject: [PATCH] sphinx doc: add plugin for svg conversion

sphinx pdf can not handle svg images without converting them first.
There are a few options available. I am using CairosSVG here.
---
 doc/sphinx/conf.py         | 3 ++-
 doc/sphinx/environment.yml | 1 +
 2 files changed, 3 insertions(+), 1 deletion(-)

diff --git a/doc/sphinx/conf.py b/doc/sphinx/conf.py
index 720f51de06c..f0a68b05a01 100644
--- a/doc/sphinx/conf.py
+++ b/doc/sphinx/conf.py
@@ -33,7 +33,8 @@
 extensions = [
     "myst_parser",
     "sphinxcontrib.bibtex",
-    "sphinxcontrib.tikz"
+    "sphinxcontrib.tikz",
+    "sphinxcontrib.cairosvgconverter"
 ]
 myst_enable_extensions = [
     "colon_fence",
diff --git a/doc/sphinx/environment.yml b/doc/sphinx/environment.yml
index e89736ff34a..29aff467574 100644
--- a/doc/sphinx/environment.yml
+++ b/doc/sphinx/environment.yml
@@ -9,3 +9,4 @@ dependencies:
   - pip>=20.1
   - pip:
     - sphinxcontrib-tikz
+    - sphinxcontrib-svg2pdfconverter[CairoSVG]