Rob,


On 7/31/20 8:19 AM, Rob Prowel wrote:
Is there some magic to building the PDF versions of the yocto docs? I've tried on multiple machines running debian and differing versions of ubuntu and consistently the PDF docs fail to build.

Font substitution errors are trivial, but not being able to locate the images that get are inserted is a pretty serious build bug.

What's the secret to building PDF docs, or where are they online?  and no, not interested in referring to cloud based HTML docs.  I want offline PDF documentation.


I believe you are hitting a known bug:  https://bugzilla.yoctoproject.org/show_bug.cgi?id=13767

regards,
Armin

Thanks!

$ make DOC=adt-manual pdf
cd adt-manual; ../tools/poky-docbook-to-pdf adt-manual.xml ../template; cd ..
Note: namesp. cut : stripped namespace before processing
            Yocto Project Application Developer's Guide

Making portrait pages on A4 paper (210mmx297mm)
Attributed 561 IDs for element, cleaned up 0
[warning] /usr/bin/fop: JVM flavor 'sun' not understood
Picked up _JAVA_OPTIONS: -Dawt.useSystemAAFontSettings=on -Dswing.aatext=true
[INFO] FopConfParser - Default page-height set to: 11in
[INFO] FopConfParser - Default page-width set to: 8.26in
[ERROR] FOUserAgent - Image not found. URI: figures/adt-title.png. (See position 2:38206)
[WARN] FOUserAgent - Font "Symbol,normal,700" not found. Substituting with "Symbol,normal,400".
[WARN] FOUserAgent - Font "ZapfDingbats,normal,700" not found. Substituting with "ZapfDingbats,normal,400".
[ERROR] FOUserAgent - Image not found. URI: figures/adt-title.png. (No context info available)
[INFO] FOUserAgent - Rendered page #1.
[INFO] FOUserAgent - Rendered page #2.
[INFO] FOUserAgent - Rendered page #3.
[INFO] FOUserAgent - Rendered page #4.
[INFO] FOUserAgent - Rendered page #5.
[ERROR] FOUserAgent - Image not found. URI: figures/using-a-pre-built-image.png. (See position 736:275)
[WARN] FOUserAgent - Font "veramono,italic,400" not found. Substituting with "veramono,normal,400".
[WARN] FOUserAgent - The contents of fo:block line 1 exceed the available area in the inline-progression direction by more than 50 points. (See position 496:372)
[WARN] FOUserAgent - The contents of fo:block line 1 exceed the available area in the inline-progression direction by more than 50 points. (See position 496:372)
[WARN] FOUserAgent - The contents of fo:block line 1 exceed the available area in the inline-progression direction by more than 50 points. (See position 496:372)
[WARN] FOUserAgent - The contents of fo:block line 1 exceed