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

[Tom Rini]

On Sun, Oct 05, 2025 at 11:10:11PM +0100, Adriano Carvalho wrote:

> SVG files are not handled directly in the *.tex files. This commit
> replaces all instances of ".. image::" with ".. kernel-figure::". With
> this, the kfigure sphinx extension (already present) ensures that SVG
> files are converted to PDF before the compilation of *.tex files.
> 
> If I don't do this, this is what I get with
> docker.io/trini/u-boot-gitlab-ci-runner:jammy-20250714-25Jul2025:
> 
> uboot at 35c89b9ab70e:~/u-boot$ make pdfdocs
> [...]
> xelatex  'android.tex'
> [...]
> Output written on android.pdf (28 pages).
> [...]
> xelatex  'api.tex'
> [...]
> Output written on api.pdf (431 pages).
> [...]
> xelatex  'arch.tex'
> [...]
> Output written on arch.pdf (62 pages).
> [...]
> xelatex  'board.tex'
> [...]
> 
> [152]
> Chapter 14.
> 
> ! LaTeX Error: Cannot determine size of graphic in boot_diagram_am62.svg (no Bo
> undingBox).
> 
> See the LaTeX manual or LaTeX Companion for explanation.
> Type  H <return>  for immediate help.
>  ...
> 
> l.11422 ...ncludegraphics{{boot_diagram_am62}.svg}
> 
> ?
> ! Emergency stop.
>  ...
> 
> [...]
> 
> Output written on board.pdf (156 pages).
> Transcript written on board.log.
> make[2]: *** [Makefile:29: board.pdf] Error 1
> make[1]: *** [doc/Makefile:95: pdfdocs] Error 2
> make: *** [Makefile:2687: pdfdocs] Error 2
> 
> NOTE: This won't completely fix the pdfdocs target. See next commit(s).
> 
> Signed-off-by: Adriano Carvalho <adrianocarvalho.pt at gmail.com>

Reviewed-by: Tom Rini <trini at konsulko.com>

-- 
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/20251006/accf7cdc/attachment.sig>