OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] refentry section headings

Hi Brian,
I went through your code, and I'll use some of it
in the stylesheets.  I noticed a couple more
complications, though.

The refentry "Name" heading is not handled by the section.level
template in the stock stylesheets. It uses its own refentry.title.properties
attribute set, which produces a fixed size of 18pt in FO output.
I'll look at changing the refnamediv template to use the new
section.level computation.

Also, the returned level seems to be off by one, I think because
of the above problem. Your refentry.section.level template
returns the sum of two computed variables:

  $levelinRE  which is 1 for a refsect1, 2 for refsect2, etc.
  $RElevel which the level of the section containing the refentry.

So if the section containing a refentry is a sect1, then a refsect1
inside the refentry  would be given a level of 1 + 1 = 2.

But the refentry itself should be a level 2 since it is contained in
a level1 sect1, so the refsect1 should have a level of 3.  Does
this sound right?

Bob Stayton
Sagehill Enterprises

----- Original Message ----- 
From: "Brian McGurk" <brian@corvil.com>
To: "Bob Stayton" <bobs@sco.com>
Cc: <docbook-apps@lists.oasis-open.org>
Sent: Thursday, November 20, 2003 10:18 AM
Subject: Re: [docbook-apps] refentry section headings

> >>For example, if a refentry appears inside a sect1,
> >>then its NAME title should be format as section
> >>level 2, and any refsect1 should format as section
> >>level 3, etc.  Does that sound right?
> I had a go at fixing the section.level template in common/common.xsl
> so that when invoked on a refentry section/sect[12345] or
> refsynopsisdiv, it will include the depth of the containing section.
> I've attached (as common.sectionlevel.xsl) my replacement for
> section.level but I haven't tested it much. It works fine for the
> document that I've been writing but I've probably missed some
> cases. I'm sure it can be made much more compact but I'm not really
> familiar enough with XSLT syntax.
> The changes are picked up automatically by fo/refentry.xsl but
> xhtml/refentry.xsl merely sets the sectn headings to <h{n+1}> and
> doesn't use section.level. So I've attached (as xhtml.refentry.xsl)
> some templates that I've been using in my customisation layer to use
> the new section.level template.
> Pointings-out of any potential pitfalls appreciated.
> Brian McGurk


> To unsubscribe from this list, send a post to
docbook-apps-unsubscribe@lists.oasis-open.org, or visit

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]