New source files and Makefile update for Test Manual
PATCH 1/1 New source files and Makefile update for Test Manual
--- documentation/Makefile | 2 +- .../test-manual/figures/ab-test-cluster.png | Bin 0 -> 18684 bytes .../test-manual/figures/test-manual-title.png | Bin 0 -> 15382 bytes .../test-manual/test-manual-customization.xsl | 27 + .../test-manual/test-manual-intro.xml | 634 +++++++++++ .../test-manual/test-manual-style.css | 989 ++++++++++++++++++ .../test-manual/test-manual-test-process.xml | 109 ++ .../test-manual-understand-autobuilder.xml | 312 ++++++ documentation/test-manual/test-manual.xml | 103 ++ 9 files changed, 2175 insertions(+), 1 deletion(-) create mode 100644 documentation/test-manual/figures/ab-test-cluster.png create mode 100644 documentation/test-manual/figures/test-manual-title.png create mode 100644 documentation/test-manual/test-manual-customization.xsl create mode 100644 documentation/test-manual/test-manual-intro.xml create mode 100644 documentation/test-manual/test-manual-style.css create mode 100644 documentation/test-manual/test-manual-test-process.xml create mode 100644 documentation/test-manual/test-manual-understand-autobuilder.xml create mode 100755 documentation/test-manual/test-manual.xml
documentation/Makefile +1 -1
@@ -361,7 +361,7 @@ ifeq ($(DOC),test-manual) XSLTOPTS = --xinclude ALLPREQ = html tarball TARFILES = test-manual.html test-manual-style.css \ - figures/test-manual-title.png figures/ab-test-stack.png + figures/test-manual-title.png figures/ab-test-cluster.png MANUALS = $(DOC)/$(DOC).html FIGURES = figures STYLESHEET = $(DOC)/*.css
documentation/test-manual/figures/ab-test-cluster.png new file binary +0 -0
documentation/test-manual/figures/test-manual-title.png new file binary +0 -0
documentation/test-manual/test-manual-customization.xsl new file +27 -0
@@ -0,0 +1,27 @@ +<?xml version='1.0'?> +<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" xmlns="http://www.w3.org/1999/xhtml" xmlns:fo="http://www.w3.org/1999/XSL/Format" version="1.0"> + + <xsl:import href="http://downloads.yoctoproject.org/mirror/docbook-mirror/docbook-xsl-1.76.1/xhtml/docbook.xsl" /> + +<!-- + + <xsl:import href="../template/1.76.1/docbook-xsl-1.76.1/xhtml/docbook.xsl" /> + + <xsl:import href="http://docbook.sourceforge.net/release/xsl/1.76.1/xhtml/docbook.xsl" /> + +--> + + <xsl:include href="../template/permalinks.xsl"/> + <xsl:include href="../template/section.title.xsl"/> + <xsl:include href="../template/component.title.xsl"/> + <xsl:include href="../template/division.title.xsl"/> + <xsl:include href="../template/formal.object.heading.xsl"/> + + <xsl:param name="html.stylesheet" select="'test-manual-style.css'" /> + <xsl:param name="chapter.autolabel" select="1" /> + <xsl:param name="appendix.autolabel" select="A" /> + <xsl:param name="section.autolabel" select="1" /> + <xsl:param name="section.label.includes.component.label" select="1" /> + <xsl:param name="generate.id.attributes" select="1" /> + +</xsl:stylesheet>
documentation/test-manual/test-manual-intro.xml new file +634 -0
634 lines not on this page · raw message
documentation/test-manual/test-manual-style.css new file +989 -0
989 lines not on this page · raw message
documentation/test-manual/test-manual-test-process.xml new file +109 -0
109 lines not on this page · raw message
documentation/test-manual/test-manual-understand-autobuilder.xml new file +312 -0
312 lines not on this page · raw message
documentation/test-manual/test-manual.xml new file +103 -0
103 lines not on this page · raw message
Signature · 1 line
2.17.1
Quoted 12 lines · Mark Morton
Signed-off-by Mark Morton <[email protected]>--- documentation/Makefile | 2 +- .../test-manual/figures/ab-test-cluster.png | Bin 0 -> 18684 bytes .../test-manual/figures/test-manual-title.png | Bin 0 -> 15382 bytes .../test-manual/test-manual-customization.xsl | 27 + .../test-manual/test-manual-intro.xml | 634 +++++++++++ .../test-manual/test-manual-style.css | 989 ++++++++++++++++++ .../test-manual/test-manual-test-process.xml | 109 ++ .../test-manual-understand-autobuilder.xml | 312 ++++++ documentation/test-manual/test-manual.xml | 103 ++ 9 files changed, 2175 insertions(+), 1 deletion(-)
Quoted 8 lines
create mode 100644 documentation/test-manual/figures/ab-test-cluster.png create mode 100644 documentation/test-manual/figures/test-manual-title.png create mode 100644 documentation/test-manual/test-manual-customization.xsl create mode 100644 documentation/test-manual/test-manual-intro.xml create mode 100644 documentation/test-manual/test-manual-style.css create mode 100644 documentation/test-manual/test-manual-test-process.xml create mode 100644 documentation/test-manual/test-manual-understand-autobuilder.xml create mode 100755 documentation/test-manual/test-manual.xml
Thanks Mark, its great to have this here!
I've queued it in master-next. The only issue was the patch didn't apply cleanly, the Makefile change was trying to change something which wasn't there. I've made it do what I think it was meant to but you'd better check I have that part of the change correct.
Cheers,
Richard
Quoted 36 lines
-----Original Message-----
From: Richard Purdie <[email protected]>
Sent: Tuesday, June 16, 2020 3:08 PM
To: Morton, Mark <[email protected]>; [email protected]
Subject: Re: [docs] [PATCH] New source files andMakefileupdate for Test ManualQuoted 16 lines · Mark Morton
Signed-off-by Mark Morton <[email protected]>--- documentation/Makefile | 2 +- .../test-manual/figures/ab-test-cluster.png | Bin 0 -> 18684 bytes .../test-manual/figures/test-manual-title.png | Bin 0 -> 15382 bytes .../test-manual/test-manual-customization.xsl | 27 + .../test-manual/test-manual-intro.xml | 634 +++++++++++ .../test-manual/test-manual-style.css | 989 ++++++++++++++++++ .../test-manual/test-manual-test-process.xml | 109 ++ .../test-manual-understand-autobuilder.xml | 312 ++++++ documentation/test-manual/test-manual.xml | 103 ++ 9 files changed, 2175 insertions(+), 1 deletion(-) create mode 100644 documentation/test-manual/figures/ab-test-cluster.png create mode 100644 documentation/test-manual/figures/test-manual-title.png create mode 100644Quoted 8 lines
documentation/test-manual/test-manual-customization.xsl
create mode 100644 documentation/test-manual/test-manual-intro.xml create mode 100644 documentation/test-manual/test-manual-style.css create mode 100644 documentation/test-manual/test-manual-test-process.xml create mode 100644 documentation/test-manual/test-manual-understand-autobuilder.xml create mode 100755 documentation/test-manual/test-manual.xml
Quoted 6 lines
Thanks Mark, its great to have this here!
I've queued it in master-next. The only issue was the patch didn't apply cleanly, the
Makefilechange was trying to change something which wasn't there. I've made it do what I think it was meant to but you'd better check I have that part of the change correct.
Hi Richard - I just checked the file and tested the output. We are good to go.
Thanks,
-Mark
Quoted 5 lines
Cheers,
Richard
Building the new test-manual for pdf doesn't succeed for me. But that could indicate something wrong on my end.
A relevant snip is below, I'm not sure what the most important parts are.
$ cd yocto-docs/documentation $ make pdf DOC=test-manual
cd test-manual; ../tools/poky-docbook-to-pdf test-manual.xml ../template; cd ..
Note: namesp. cut : stripped namespace before processing
Yocto Project Test Environment Manual
Making portrait pages on A4 paper (210mmx297mm)
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
...
SEVERE: javax.xml.transform.TransformerException:
file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178:
Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178)
Jun 24, 2020 3:32:48 PM FOP startFOP
SEVERE: Exception
org.apache.fop.apps.FOPException: org.apache.fop.fo.ValidationException:
file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178:
Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178)
javax.xml.transform.TransformerException:
org.apache.fop.fo.ValidationException:
file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178:
Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178)
PS the other docs build fine for me as PDFs
It looks like a duplicate in the ID name – I’ll take a look and try and fix that.
Thanks,
-Mark
From: Trevor Woerner <[email protected]>
Sent: Wednesday, June 24, 2020 12:37 PM
To: Morton, Mark <[email protected]>
Cc: Richard Purdie <[email protected]>; [email protected]
Subject: Re: [docs] [PATCH] New source files and Makefile update for Test Manual
PS the other docs build fine for me as PDFs
Quoted 1 line · Mark
It looks like a duplicate in the ID name – I’ll take a look and try and fix that.
Great! Thanks for the quick reply.
Again, not sure if this is just happening to me or not but in the pdf the diagram isn't included.
A message that is not in the archive (sent off-list or not yet received): [email protected]
Quoted 3 lines · Trevor Woerner via lists.yoctoproject.org
Again, not sure if this is just happening to me or not but in the pdf the diagram isn't included.
Hmm... I just noticed the diagram(s) aren't showing up in my kernel-devl pdf manual either. Perhaps something on my side?
Hi Trevor:
I just pushed a patch – it should be arriving soon. PDFs are now building (with existing caveats)
Thanks for finding this.
-Mark
From: Trevor Woerner <[email protected]>
Sent: Wednesday, June 24, 2020 12:36 PM
To: Morton, Mark <[email protected]>
Cc: Richard Purdie <[email protected]>; [email protected]
Subject: Re: [docs] [PATCH] New source files and Makefile update for Test Manual
Building the new test-manual for pdf doesn't succeed for me. But that could indicate something wrong on my end. A relevant snip is below, I'm not sure what the most important parts are.
$ cd yocto-docs/documentation $ make pdf DOC=test-manual
cd test-manual; ../tools/poky-docbook-to-pdf test-manual.xml ../template; cd ..
Note: namesp. cut : stripped namespace before processing
Yocto Project Test Environment Manual
Making portrait pages on A4 paper (210mmx297mm)
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
XLink to nonexistent id:
...
SEVERE: javax.xml.transform.TransformerException: file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178: Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178) Jun 24, 2020 3:32:48 PM FOP startFOP
SEVERE: Exception
org.apache.fop.apps.FOPException: org.apache.fop.fo.ValidationException: file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178: Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178) javax.xml.transform.TransformerException: org.apache.fop.fo.ValidationException: file:/opt/oe/layers/master/yocto-docs/documentation/test-manual/test-manual.fo:442:178: Property ID "test-yocto-project-autobuilder-overview" (found on "fo:block") previously used; ID values must be unique within a document! (See position 442:178)