diff options
author | Scott Rifenbark <scott.m.rifenbark@intel.com> | 2014-12-15 09:31:59 -0600 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2014-12-19 22:36:14 +0000 |
commit | c57655603373f72b6c6ca10cd488b85a2c188ca2 (patch) | |
tree | f361712c26e8b68756dcb3030f62a8826bb1a088 /documentation/yocto-project-qs/yocto-project-qs.xml | |
parent | 6ee3207ec757dacc462c95dac05841b78b9df735 (diff) | |
download | poky-c57655603373f72b6c6ca10cd488b85a2c188ca2.tar.gz |
yocto-project-qs, mega-manual: Conformed to YP book set
I discovered some artifacts and inconsistencies with how the YP
Quick Start was made. I made the following changes:
1. Changed the structure of the QS from "article" to "book"
as it is a separate book. This change doesn't fix anything
but it does bring the XML file closer to passing validation.
2. Removed the <abstract></abstract> tag. This tag was in place
simply to display the PNG file for the Yocto logo in the upper
right part of the first page. After turning the QS into a
book from an article, the title could be displayed as a PNG
file similar to the other books. This change solved two issues:
1) removed the empty "abstract" element from being displayed in
both the mega-manual and the PDF version, and 2), brought the
author and look of the first page into line with other YP
manuals.
3. Removed the old PNG file used to display the Yocto logo at
the top of the QS. This file was removed from both the
yocto-project-qs and mega-manual "figures" directories.
4. Added a new "yocto-project-qs-title.png" file to both the
yocto-project-qs and mega-manual "figures" directories.
5. Updated the "qs-style.css" file's .authorgroup element to
match and behave like the other YP manuals. This effectively
correctly displays the title PNG file for the QS.
6. Updated the Makefile area where the TAR files are made for
both the yocto-project-qs and the mega-manual. I had to
substitute in the new PNG file for the QS one and had to
add the title PNG to the mega-manual part.
(From yocto-docs rev: 914c482bd89071ab34b3381e3bd8065f871cc047)
Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/yocto-project-qs/yocto-project-qs.xml')
-rw-r--r-- | documentation/yocto-project-qs/yocto-project-qs.xml | 42 |
1 files changed, 29 insertions, 13 deletions
diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml index 9f1a4fbb36..1e2f3670f4 100644 --- a/documentation/yocto-project-qs/yocto-project-qs.xml +++ b/documentation/yocto-project-qs/yocto-project-qs.xml | |||
@@ -1,10 +1,33 @@ | |||
1 | <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | 1 | <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" |
2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" | 2 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" |
3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > | 3 | [<!ENTITY % poky SYSTEM "../poky.ent"> %poky; ] > |
4 | 4 | ||
5 | <article id='intro'> | 5 | <book id='intro' lang='en' |
6 | <articleinfo> | 6 | xmlns:xi="http://www.w3.org/2003/XInclude" |
7 | <title>Yocto Project Quick Start</title> | 7 | xmlns="http://docbook.org/ns/docbook" |
8 | > | ||
9 | <bookinfo> | ||
10 | <mediaobject> | ||
11 | <imageobject> | ||
12 | <imagedata fileref='figures/yocto-project-qs-title.png' | ||
13 | format='SVG' | ||
14 | align='left' scalefit='1' width='100%'/> | ||
15 | </imageobject> | ||
16 | </mediaobject> | ||
17 | |||
18 | <title> | ||
19 | Yocto Project Quick Start | ||
20 | </title> | ||
21 | |||
22 | <authorgroup> | ||
23 | <author> | ||
24 | <firstname>Scott</firstname> <surname>Rifenbark</surname> | ||
25 | <affiliation> | ||
26 | <orgname>Intel Corporation</orgname> | ||
27 | </affiliation> | ||
28 | <email>scott.m.rifenbark@intel.com</email> | ||
29 | </author> | ||
30 | </authorgroup> | ||
8 | 31 | ||
9 | <copyright> | 32 | <copyright> |
10 | <year>©RIGHT_YEAR;</year> | 33 | <year>©RIGHT_YEAR;</year> |
@@ -23,14 +46,7 @@ | |||
23 | from the Yocto Project website. | 46 | from the Yocto Project website. |
24 | </note> | 47 | </note> |
25 | </legalnotice> | 48 | </legalnotice> |
26 | 49 | </bookinfo> | |
27 | |||
28 | <abstract> | ||
29 | <imagedata fileref="figures/yocto-project-transp.png" | ||
30 | width="6in" depth="1in" | ||
31 | align="right" scale="25" /> | ||
32 | </abstract> | ||
33 | </articleinfo> | ||
34 | 50 | ||
35 | <section id='welcome'> | 51 | <section id='welcome'> |
36 | <title>Welcome!</title> | 52 | <title>Welcome!</title> |
@@ -962,7 +978,7 @@ | |||
962 | </section> | 978 | </section> |
963 | </section> | 979 | </section> |
964 | 980 | ||
965 | </article> | 981 | </book> |
966 | <!-- | 982 | <!-- |
967 | vim: expandtab tw=80 ts=4 | 983 | vim: expandtab tw=80 ts=4 |
968 | --> | 984 | --> |