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] A docbook-xsl parameter "bridgehead.renderas"

On 13/03/15 19:14, Richard Hamilton wrote:
Hi Erik,

I don't see anything wrong with the idea, though I'm not sure it
would be widely used (bridgeheads themselves don't seem to be widely
used, though they can be really helpful).

You can enter Feature Requests at
http://sourceforge.net/p/docbook/feature-requests/. You probably need
a sourceforge login, but that's easy and free.

OK. I started doing that, editing the request in the web interface, attaching a file with a patch, but when hitting the Save button nothing happened. Hitting once more: no dice.

Please, instead, find attached a proposed implementation of the feature that I described. It's a customization of the distribution-supplied bridgehead template in fo/sections.xsl. It presumes a newly introduced FO parameter "bridgehead.renderas", to be initially defined as:

    <xsl:param name="bridgehead.renderas"/>

The parameter can be assigned the same values as the "renderas" attribute to the bridgehead element: sect1, sect2, sect3, sect4, sect5.

For any particular bridgehead instance, the setting for its renderas
attribute overrides the setting of the document level parameter.

This stylesheet is provided to the docbook-xsl project as a basis
for a patch, at their discretion. And to everybody to use at liberty.


Erik Leunissen.

Best regards, Dick Hamilton ------- XML Press XML for Technical
Communicators http://xmlpress.net hamilton@xmlpress.net

On Mar 13, 2015, at 10:58, Erik Leunissen <elns@xs4all.nl> wrote:


As it happens, I find myself repeatedly in the situation where I
want to use bridgeheads.

In all of these cases I want all bridgeheads throughout the
document to be rendered in the same way; as a section at a specific
level (e.g. sect5). [*]

The facility to customize this is the renderas attribute to the
bridgehead element.

In my use case, it strikes me as inapt to have to adjust that
attribute in ever the same way for each instance of a bridgehead in
the document. It seems logical/practical to have a docbook-xsl
parameter (e.g. "bridgehead.renderas") which handles this at at the
document level.

The docbook-xsl stylesheets do not currently provide such a
facility. Well, I guess that amounts to a Feature Request ...

Anything wrong with this idea?


Erik Leunissen.

[*] I'm producing PDF output using docbook-xsl - xsltproc - fop


To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
For additional commands, e-mail:

Attachment: bridgehead.xsl
Description: application/xslt

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