Skip to contentSkip to conversation

buildtools-docs-tarball: add new Sphinx extension svg2pdfconverter

PATCH Superseded Quentin Schulz 2 participants 4 messages Dec 2, 2025

v1 of 3 Superseded Latest is v3 →

lore
Share & tools
lore
#0 lore raw

cover buildtools-docs-tarball: add new Sphinx extension svg2pdfconverter

This will soon be required to build the Yocto docs, so add a recipe for the Sphinx extension and add it to the docs tarball.

---
Quentin Schulz (2):
python3-sphinxcontrib-svg2pdfconverter: add new recipe
buildtools-docs-tarball: add python3-sphinxcontrib-svg2pdfconverter to the SDK

 meta/recipes-core/meta/buildtools-docs-tarball.bb     |  1 +
 .../python3-sphinxcontrib-svg2pdfconverter_2.0.0.bb   | 19 +++++++++++++++++++
 2 files changed, 20 insertions(+)

---
base-commit: ac7327583aef83fd400190506f3147623de38b68
change-id: 20251202-svg2pdf-e35074cd8cea

Best regards,

Signature · 1 line
Quentin Schulz <[email protected]>
#1 lore raw

PATCH 1/2 python3-sphinxcontrib-svg2pdfconverter: add new recipe

From: Quentin Schulz <[email protected]>

This will be a dependency for building the Yocto docs soon, so let's add a recipe for it.

This does SVG to PDF (or PNG) conversion for images used in Sphinx projects.

It exposes three different Sphinx extensions, each using a different tool for the conversion:
- cairosvg, a Python module with no available recipe,
- inkscape, only available in seemingly unmaintained 3rd party layer,
- rsvg-convert,

So we'll only support the last extension for now.

---
 .../python3-sphinxcontrib-svg2pdfconverter_2.0.0.bb   | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)
meta/recipes-devtools/python/python3-sphinxcontrib-svg2pdfconverter_2.0.0.bb new file +19 -0
new file mode 100644
index 0000000000..52f9825210
@@ -0,0 +1,19 @@
+SUMMARY = "Sphinx SVG to PDF or PNG converter extension"
+HOMEPAGE = "https://github.com/missinglinkelectronics/sphinxcontrib-svg2pdfconverter"
+LICENSE = "BSD-2-Clause"
+LIC_FILES_CHKSUM = "file://LICENSE.txt;md5=b11cf936853a71258d4b57bb1849a3f9"
+
+SRC_URI[sha256sum] = "ab9c8f1080391e231812d20abf2657a69ee35574563b1014414f953964a95fa3"
+
+inherit pypi python_setuptools_build_meta
+
+PYPI_PACKAGE = "sphinxcontrib-svg2pdfconverter"
+
+RDEPENDS:${PN} = "python3-sphinx"
+# Only support sphinxcontrib.rsvgconverter for now.
+# As cairosvgconverter depends on cairosvg module, no recipe available yet
+# As inkscapeconverter depends on inkscape, recipe in meta-office, 3rd-party
+# layer not updated in years
+RDEPENDS:${PN} += "librsvg"
+
+BBCLASSEXTEND = "native nativesdk"
Signature · 1 line
2.52.0
#2 lore raw

Re: [PATCH 1/2] python3-sphinxcontrib-svg2pdfconverter: add new recipe

Hi all,

Quoted 8 lines · Quentin Schulz

From: Quentin Schulz <[email protected]>

This will be a dependency for building the Yocto docs soon, so let's add a recipe for it.

This does SVG to PDF (or PNG) conversion for images used in Sphinx projects.

Quoted 8 lines

It exposes three different Sphinx extensions, each using a different tool for the conversion:
- cairosvg, a Python module with no available recipe,
- inkscape, only available in seemingly unmaintained 3rd party layer,
- rsvg-convert,

So we'll only support the last extension for now.

Don't bother running this through the autobuilder, this recipe was generated by "devtool add" and it's garbage. Will fix and send a v2.

Sorry for the noise.

Quentin

#3 lore raw

PATCH 2/2 buildtools-docs-tarball: add python3-sphinxcontrib-svg2pdfconverter to the SDK

In reply to Quentin Schulz

From: Quentin Schulz <[email protected]>

This will soon be required for building the Yocto docs so let's add it to the SDK toolchain.

---
 meta/recipes-core/meta/buildtools-docs-tarball.bb | 1 +
 1 file changed, 1 insertion(+)
meta/recipes-core/meta/buildtools-docs-tarball.bb +1 -0
index 98d47f7b71..3fc28fad93 100644
@@ -10,6 +10,7 @@ TOOLCHAIN_HOST_TASK += "\
     nativesdk-python3-sphinx-argparse \
     nativesdk-python3-sphinx-copybutton \
     nativesdk-python3-sphinx-rtd-theme \
+    nativesdk-python3-sphinxcontrib-svg2pdfconverter \
     nativesdk-python3-pyyaml \
     nativesdk-rsvg \
     "
Signature · 1 line
2.52.0