This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: [docbook] Title for refnamediv
- From: "Bob Stayton" <bobs at sagehill dot net>
- To: "ben" <nicolas dot marsgui at libertysurf dot fr>, <docbook at lists dot oasis-open dot org>
- Date: Sun, 18 Apr 2004 13:15:47 -0700
- Subject: Re: [docbook] Title for refnamediv
- References: <407C43C3.8EED03F3@libertysurf.fr>
----- Original Message -----
From: "ben" <nicolas.marsgui@libertysurf.fr>
To: <docbook@lists.oasis-open.org>
Sent: Tuesday, April 13, 2004 12:47 PM
Subject: [docbook] Title for refnamediv
> Hello,
>
> I have a little trouble with the refnamediv translation since it cannot
> contain a title. If the heading is fixed (such like "Name" or "NAME") it
> can be contradictory with the heading rendering specified by the title
> of refsynopsisdiv. Besides, why this specific refentry section doesn't
> have title?
>
> Is there a way to specify the title, or is it possible to add this
> element under refnamediv?
There are a couple of stylesheet parameters that can help you. When
'refentry.generate.name' is set to 1 (the default), then the title 'Name' is
generated using the gentext machinery. It comes from the common/en.xml (or
other language file) from this line:
<l:gentext key="RefName" text="Name"/>
If you want to change that title for all your refentries, then you can
customize that gentext string, using the methods described in my book
DocBook XSL: The Complete Guide.
The other parameter is 'refentry.generate.title', which is normally set to
zero. When it is set to 1 (and 'refentry.generate.name' set to zero), then
the title is taken from the refmeta/refentrytitle element, or from the first
refname element if there is no refentrytitle. Does that help?
Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@sagehill.net
To unsubscribe from this list, send a post to docbook-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/.