[patch] yocto-project-qs.xml: Add a title

[patch] yocto-project-qs.xml: Add a title

[Colin Walters]

[-- Attachment #1: Type: text/plain, Size: 128 bytes --]

We didn't have an <info> section, and thus the generated HTML at least
had <title></title> which is lame to see in a browser.

[-- Attachment #2: 0001-yocto-project-qs.xml-Add-a-title.patch --]
[-- Type: text/x-diff, Size: 1017 bytes --]

From 09089032c9d0f551996e913a1bdcce9080b0d9d4 Mon Sep 17 00:00:00 2001
From: Colin Walters <walters@verbum.org>
Date: Fri, 15 Apr 2011 09:34:35 -0400
Subject: [PATCH] yocto-project-qs.xml: Add a title

We didn't have an <info> section, and thus the generated HTML at least
had <title></title> which is lame to see in a browser.
---
 .../yocto-project-qs/yocto-project-qs.xml          |    3 +++
 1 files changed, 3 insertions(+), 0 deletions(-)

diff --git a/documentation/yocto-project-qs/yocto-project-qs.xml b/documentation/yocto-project-qs/yocto-project-qs.xml
index f011f09..83fcdfb 100644
--- a/documentation/yocto-project-qs/yocto-project-qs.xml
+++ b/documentation/yocto-project-qs/yocto-project-qs.xml
@@ -3,6 +3,9 @@
 
 <article id='intro'>
    <imagedata fileref="figures/yocto-project-transp.png" width="6in" depth="1in" align="right" scale="25" />
+   <info>
+     <title>Yocto Project Quick Start</title>
+   </info>
 
 <section id='fake-title'>
     <title>Yocto Project Quick Start</title>
-- 
1.7.1

Re: [patch] yocto-project-qs.xml: Add a title

[Rifenbark, Scott M]

Hi Colin, 

The Quick Start has a different format than the other Yocto Project manuals.  Namely, there is no title page or large title.  We did this purpose.  In order to accomplish it within our manual generation scheme I had to hack the DocBook code a bit, which is why the '<title></title>' lame code appears.  I can't really offer anything but an explanation at this point for the way the front matter of the Quick Start is designed.  

Thanks,
ScottR

-----Original Message-----
From: poky-bounces@yoctoproject.org [mailto:poky-bounces@yoctoproject.org] On Behalf Of Colin Walters
Sent: Friday, April 15, 2011 6:51 AM
To: poky
Subject: [poky] [patch] yocto-project-qs.xml: Add a title

We didn't have an <info> section, and thus the generated HTML at least had <title></title> which is lame to see in a browser.

Re: [patch] yocto-project-qs.xml: Add a title

[Colin Walters]

On Fri, Apr 15, 2011 at 9:55 AM, Rifenbark, Scott M
<scott.m.rifenbark@intel.com> wrote:
> Hi Colin,
>
> The Quick Start has a different format than the other Yocto Project manuals.  Namely, there is no title page or large title.  We did this purpose.  In order to accomplish it within our manual generation scheme I had to hack the DocBook code a bit, which is why the '<title></title>' lame code appears.  I can't really offer anything but an explanation at this point for the way the front matter of the Quick Start is designed.

Oh, hm, can't say I understand exactly, but - can we do a quick hack
to fixup the HTML after it's generated then?

Re: [patch] yocto-project-qs.xml: Add a title

[Rifenbark, Scott M]

Colin, 

Yes - I can put a title between tags and it will result in an appropriately named tab.  Thanks for pointing out. 

ScottR

-----Original Message-----
From: cgwalters@gmail.com [mailto:cgwalters@gmail.com] On Behalf Of Colin Walters
Sent: Friday, April 15, 2011 6:58 AM
To: Rifenbark, Scott M
Cc: poky
Subject: Re: [poky] [patch] yocto-project-qs.xml: Add a title

On Fri, Apr 15, 2011 at 9:55 AM, Rifenbark, Scott M
<scott.m.rifenbark@intel.com> wrote:
> Hi Colin,
>
> The Quick Start has a different format than the other Yocto Project manuals.  Namely, there is no title page or large title.  We did this purpose.  In order to accomplish it within our manual generation scheme I had to hack the DocBook code a bit, which is why the '<title></title>' lame code appears.  I can't really offer anything but an explanation at this point for the way the front matter of the Quick Start is designed.

Oh, hm, can't say I understand exactly, but - can we do a quick hack
to fixup the HTML after it's generated then?

Re: [patch] yocto-project-qs.xml: Add a title

[Rifenbark, Scott M]

Colin, 

So I am looking at this a bit closer and all our YP manuals have the HTLM code '<title></title>' generated.  It is not just the quick start.  Also, when we "Make" the manuals the HTML code is generated from DocBook source.  The HTML code is then included into the tarball for the manual and ends up in the git repository.  So to create HTML code that has something between the title tags I am going to have to figure out how to do that in the DocBook source so when the manual is generated the HTML code will have it at that point.  I will have to further investigate this. 

ScottR

-----Original Message-----
From: cgwalters@gmail.com [mailto:cgwalters@gmail.com] On Behalf Of Colin Walters
Sent: Friday, April 15, 2011 6:58 AM
To: Rifenbark, Scott M
Cc: poky
Subject: Re: [poky] [patch] yocto-project-qs.xml: Add a title

On Fri, Apr 15, 2011 at 9:55 AM, Rifenbark, Scott M
<scott.m.rifenbark@intel.com> wrote:
> Hi Colin,
>
> The Quick Start has a different format than the other Yocto Project manuals.  Namely, there is no title page or large title.  We did this purpose.  In order to accomplish it within our manual generation scheme I had to hack the DocBook code a bit, which is why the '<title></title>' lame code appears.  I can't really offer anything but an explanation at this point for the way the front matter of the Quick Start is designed.

Oh, hm, can't say I understand exactly, but - can we do a quick hack
to fixup the HTML after it's generated then?