Re: [docbook-apps] A docbook-xsl parameter "bridgehead.renderas"

[Erik Leunissen <elns@xs4all.nl>]

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.

Greetings,

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:
>
> > L.S.
> >
> > 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?
> >
> > Greetings,
> >
> > 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:
> > docbook-apps-help@lists.oasis-open.org

Attachment: bridgehead.xsl
Description: application/xslt