[PATCH 4/7] doc: make pdfdocs: Ensure SVG files are converted to PDF before the compilation of *.tex files

[Tom Rini]

On Wed, Aug 27, 2025 at 12:47:56AM +0100, Adriano Carvalho wrote:
> On Tue, 26 Aug 2025 at 00:00, Tom Rini <trini at konsulko.com> wrote:
> >
> > On Mon, Aug 25, 2025 at 11:44:47PM +0100, Adriano Carvalho wrote:
> >
> > > SVG files are not handled directly in the *.tex files.
> > > This commit adds sphinxcontrib.inkscapeconverter (from the sphinxcontrib-svg2pdfconverter package) to sphinx's extensions in conf.py to ensure SVG files are converted to PDF before the compilation of *.tex files.
> > > The needed steps are also updated and inkscape is specified as a dependency.
> >
> > This seems very heavy, is there not some other conversion we can do in
> > order to support PDF output?
> >
> > --
> > Tom
> 
> The extension itself is quite simple.
> 
> inkscape on the other hand, according to apt-rdepends has 755
> dependencies on Ubuntu 25.04.
> 
> rsvg-convert (librsvg2-bin) "only" has 179.
> 
> So, instead of sphinxcontrib.inkscapeconverter we can use
> sphinxcontrib.rsvgconverter and reduce the number of dependencies
> quite significantly.
> 
> Does this address your concern?

This is getting closer, yes. Looking at v6.16 in the kernel, it looks
like rsvg-convert is a pre-req for pdfdocs there, so we should adopt
that (and whatever general updates need to be done) as part of
supporting pdfdocs as a target. I was unaware until now just how
difficult adding SVG to PDF output was, sorry for the churn here.

-- 
Tom
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 228 bytes
Desc: not available
URL: <https://lists.denx.de/pipermail/u-boot/attachments/20250826/a3ba1f91/attachment.sig>