yocto-project-qs, mega-manual: Overhaul of the QS

Changed the way the YP QS looks.  The QS now has numbered sections
rather than just formatted section heads.  This allows the reader
to better track the hierarchy of the sections.  This feature has
been asked for before and I decided it was time to implement it.
One thing though, is I am not generating a full TOC at the head
of the book as is done in the other YP manuals.

Decided to add a manual title .PNG file.  This required a new figure
file (ypqs-title.png) that needed to reside in the figures folder of
both the yocto-project-qs and mega-manual.  Updates were required in
the Makefile to include the figure.  Updates required in the
YP QS style sheet to display the figure.  Basically, there were all
kinds of changes to get this title to show up properly in both the
YP QS and in the Mega Manual.

Turned the structure of the YP QS into a book now rather than an
article.  This required creating a "qs.xml" file that has the actual
content.

(From yocto-docs rev: ef05f5c7ba2a61ebc4c58873cbbc32d35652659d)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>

documentation/Makefile

@@ -141,10 +141,15 @@ STYLESHEET = $(DOC)/*.css
 endif
 
 ifeq ($(DOC),yocto-project-qs)
-XSLTOPTS = --xinclude
+XSLTOPTS = --stringparam html.stylesheet qs-style.css \
+           --stringparam  chapter.autolabel 1 \
+           --stringparam  section.autolabel 1 \
+           --stringparam  section.label.includes.component.label 1 \
+           --xinclude
 ALLPREQ = html eclipse tarball
+
 TARFILES = yocto-project-qs.html qs-style.css \
-           figures/yocto-project-transp.png \
+           figures/yocto-project-transp.png figures/ypqs-title.png \
            eclipse
 MANUALS = $(DOC)/$(DOC).html $(DOC)/eclipse
 FIGURES = figures
@@ -244,7 +249,7 @@ TARFILES = mega-manual.html mega-style.css \
 	figures/sdk-environment.png figures/sdk-installed-standard-sdk-directory.png \
 	figures/sdk-devtool-add-flow.png figures/sdk-installed-extensible-sdk-directory.png \
 	figures/sdk-devtool-modify-flow.png figures/sdk-eclipse-dev-flow.png \
-	figures/sdk-devtool-upgrade-flow.png figures/bitbake-build-flow.png
+	figures/sdk-devtool-upgrade-flow.png figures/bitbake-build-flow.png figures/ypqs-title.png
 	endif
 
 MANUALS = $(DOC)/$(DOC).html

documentation/mega-manual/mega-manual.xml

@@ -122,8 +122,12 @@
 
 <!-- Includes yocto-project-qs -->
 
+    <para>
+        <imagedata fileref="figures/ypqs-title.png" width="100%" align="left" scalefit="1" />
+    </para>
+
     <xi:include
-        xmlns:xi="http://www.w3.org/2003/XInclude" href="../yocto-project-qs/yocto-project-qs.xml"/>
+        xmlns:xi="http://www.w3.org/2003/XInclude" href="../yocto-project-qs/qs.xml"/>
 
 <!-- Includes dev-manual title image and then dev-manual chapters -->
 

documentation/yocto-project-qs/qs-style.css

@@ -118,12 +118,13 @@ h6 {
   background-color: transparent;
   background-repeat: no-repeat;
   padding-top: 256px;
-  background-position: top;
+  background-image: url("figures/ypqs-title.png");
+  background-position: left top;
   margin-top: -256px;
   padding-right: 50px;
-  margin-left: 50px;
-  text-align: center;
-  width: 600px;
+  margin-left: 0px;
+  text-align: right;
+  width: 740px;
 }
 
 h3.author {
@@ -791,9 +792,9 @@ div.article .titlepage .title
 
 div.preface .titlepage .title,
 div.colophon .title,
-div.chapter .titlepage .title,
-div.article .titlepage .title
-{
+div.chapter .titlepage .title {
+  background-position: bottom;
+  background-repeat: repeat-x;
 }
 
 div.section div.section .titlepage .title,

documentation/yocto-project-qs/yocto-project-qs-customization.xsl

@@ -19,6 +19,19 @@
   <xsl:include href="../template/division.title.xsl"/>
   <xsl:include href="../template/formal.object.heading.xsl"/>
 
+<!--
+
   <xsl:param name="generate.toc" select="'article nop'"></xsl:param>
   <xsl:param name="html.stylesheet" select="'qs-style.css'" />
+
+-->
+
+  <xsl:param name="html.stylesheet" select="'qs-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:param name="generate.toc" select="'article nop'"></xsl:param>
+
 </xsl:stylesheet>