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
>
>