Bug 13552

Summary: Cannot build manuals without internet connectivity
Product: [Documentation] General Docs Reporter: Kevin Cribbs <kec201909>
Component: docs-generalAssignee: Unassigned <unassigned>
Status: RESOLVED OBSOLETE QA Contact:
Severity: enhancement    
Priority: Medium CC: akuster808, randy.macleod, richard.purdie
Version: unspecified   
Target Milestone: 4.99   
Hardware: x86   
OS: Multiple   
Whiteboard:
OS type for building Yocto: --- Type of Regression: ---
Verified: Documentation change: No (bug/feature does not impact docs)
Bug Depends on: 13874    
Bug Blocks:    

Description Kevin Cribbs 2019-09-25 18:20:55 UTC 
On computers without internet connectivity, attempts to build manuals fail with the following (or similar) output:


make html DOC=dev-manual
 
******** Building dev-manual
 
cd dev-manual; xsltproc --xinclude -o dev-manual.html dev-manual-customization.xsl dev-manual.xml; cd ..
error : No such file or directory
warning: failed to load external entity "http://downloads.yoctoproject.org/mirror/docbook-mirror/docbook-xsl-1.76.1/xhtml/docbook.xsl"
compilation error: file dev-manual-customization.xsl line 4 element import
xsl:import : unable to load http://downloads.yoctoproject.org/mirror/docbook-mirror/docbook-xsl-1.76.1/xhtml/docbook.xsl



make html DOC=mega-manual
 
******** Building mega-manual
 
cd mega-manual; xsltproc --stringparam html.stylesheet mega-style.css --stringparam  chapter.autolabel 1 --stringparam  section.autolabel 1 --stringparam  section.label.includes.component.label 1 --xinclude -o mega-manual.html mega-manual-customization.xsl mega-manual.xml; cd ..
error : No such file or directory
warning: failed to load external entity "http://downloads.yoctoproject.org/mirror/docbook-mirror/docbook-xsl-1.76.1/xhtml/docbook.xsl"
compilation error: file mega-manual-customization.xsl line 4 element import
xsl:import : unable to load http://downloads.yoctoproject.org/mirror/docbook-mirror/docbook-xsl-1.76.1/xhtml/docbook.xsl
 
******** Using mega-manual.sed to process external links
 
cd mega-manual; sed -f ../tools/mega-manual.sed < mega-manual.html > mega-output.html; cd ..
/bin/sh: mega-manual.html: No such file or directory
 
******** Cleaning up transient file mega-output.html
 
cd mega-manual; rm mega-manual.html; mv mega-output.html mega-manual.html; cd ..
rm: cannot remove ‘mega-manual.html’: No such file or directory
mv: cannot stat ‘mega-output.html’: No such file or directory
Comment 1 Kevin Cribbs 2019-09-25 18:40:15 UTC 
This was confirmed in a very recent poky 81f9e815d36848761a9dfa94b00ad998bb39a4a6.
Comment 2 Richard Purdie 2019-09-26 14:55:35 UTC 
This is a known issue, our manuals needs a copy of the dockbook xsl files to build. As such making this work offline is an enhancement we could consider in the next release. Not quite sure how we'd do that though.
Comment 3 Kevin Cribbs 2019-11-20 11:34:03 UTC 
Perhaps a bitbake recipe could be used so bitbake's abilities to support offline builds could be leveraged to support offline building of the documents.
Comment 4 Randy MacLeod 2022-05-05 15:11:23 UTC 
We have switch to Sphinx so this is obsolete.