docbook:

& titles

On Jan 25,  1:48am, Martin WHEELER wrote:
> Subject: <article> & <articleinfo> titles
> Umm -- I'm having problems with knowing where to place document titles
> and sub-titles in DocBook 4.1 (article) markup for use by the LDP.
>
>
> If I put them under <article><title> and <article><subtitle>, then
> render the markup for html using jade/openjade and the ldp.dsl, the
> title of the overall document is placed as banner-text at the top of
> every rendered html page except the first (as I would expect); followed
> *immediately* by the text of the subtitle (which I would expect either
> to be suppressed, or at least placed on a line of its own).
> Also, on the first page, the sub-title is not placed after the title
> line at the top of the page, but instead is rendered as a rubric after
> all body text, and before the banner-text of the footer.
>
>
> If on the other hand I place them in the <articleinfo> section (i.e. as
> <articleinfo><title> and <articleinfo><subtitle> -- which for me is
> counter-intuitive), then after rendering, the title and sub-title show
> as the first two lines of the first html page; but nothing appears as
> a banner-text header on any succeeding html pages.
>
> The "write-around" I have currently come up with is to mark the
> document title first as <article><title>; then again as <articleinfo>
> <title>; and to mark the sub-title as <articleinfo><subtitle> only.
>
> But this is a horrendous example of marking-up to produce a desired
> visual effect in ONE rendering process only, and makes me most unhappy.
> Now -- if I were a dsssl stylesheet programmer...

"dsssl stylesheet programmer"...a rare breed apparently...;-)

Anyway, this looks like a bug to me; something didn't carry over
with the change from artheader to articleinfo.

I compared these two HOWTOs:

http://linuxdoc.org/HOWTO/Bootdisk-HOWTO/
    done in DocBook 3.1

http://linuxdoc.org/HOWTO/mini/Nvidia-OpenGL-Configuration/
    done in DocBook 4.1

Both contain the <title> *within* <artheader> for 3.1 and
<articleinfo> for 4.1, yet the title only carries over onto
subsequent pages in the 3.1 (Bootdisk-HOWTO) instance.

So you'd like to see the title carried over to all pages
(3.1 behavior), correct?

What about the subtitles? Do we want soemthing like this on
all HTML pages (centered; as in Bootdisk-HOWTO):

	my_title<br>
        my_subtitle

lmk and I'll try to get this fixed.

-- 
Greg Ferguson     - s/w engr / mtlhd         | gferg at sgi.com
SGI Tech Pubs     - http://techpubs.sgi.com/ |
Linux Doc Project - http://www.linuxdoc.org/ | gferg at metalab.unc.edu