Skip to contentSkip to conversation

cannot build PDF docs

DISCUSSION Rob Prowel 2 participants 2 messages Jul 31, 2020

lore
Share & tools
lore

Rob Prowel

author
#0 lore raw

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

#1 lore raw

Rob,

Quoted 11 lines · 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.

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

regards,
Armin

Quoted 44 lines

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