This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: "titlepage" == "pagetitle"
- From: Bob Stayton <bobs at caldera dot com>
- To: Noel Bush <noel at x-31 dot com>, docbook at lists dot oasis-open dot org
- Date: Wed, 20 Nov 2002 14:18:02 -0800
- Subject: Re: DOCBOOK: "titlepage" == "pagetitle"
- References: <1037829640.6489.5.camel@localhost>
On Wed, Nov 20, 2002 at 05:00:40PM -0500, Noel Bush wrote:
> One of the more confusing things I've found in the (generally very
> wonderful and amazing) DocBook XSL material is that, at least when
> producing chunked HTML, the templates in "titlepage.mode" actually apply
> to *page titles*, not just the "title page" (which may not even be
> generated). It took me a long time to figure out how to suppress
> display of abstracts in the page title area because I assumed that all
> the mentions of "titlepage" referred to some, um, "title page", which I
> wasn't even generating. It might help other people trying to do similar
> things if this mode, and discussions of it, would refer to "page titles"
> instead. Just a suggestion. Thanks for the fabulous resource!
Good point. The "titlepage" mechanism in the stylesheets
is designed to be very general, so that it handles the
title and *info elements in many different output styles.
Page breaking after the title and info is just one feature.
Sometimes it generates separate title pages, as in the FO output
for a book, and sometimes it just prints the title and
*info elements without a page break, as in the FO output
for an article and for HTML output. The mode should
probably be called "title-and-info" or some such. 8^)
I'll clarify this in the doc.
--
Bob Stayton 400 Encinal Street
Publications Architect Santa Cruz, CA 95060
Technical Publications voice: (831) 427-7796
The SCO Group fax: (831) 429-1887
email: bobs@sco.com