cannot build PDF docs

cannot build PDF docs

[Rob Prowel]

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.

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

Re: [yocto] cannot build PDF docs

[Armin Kuster]

[-- Attachment #1: Type: text/plain, Size: 2725 bytes --]

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


[-- Attachment #2: Type: text/html, Size: 4026 bytes --]