Re: [docbook-apps] getting both test and graphic label for admonitions

[Bob Stayton <bobs@sco.com>]

On Mon, May 05, 2003 at 04:42:33PM -0400, Robert P. J. Day wrote:
> 
>   with a simple test file, i created some admonitions and
> defined the xsl:params admon.graphics and admon.graphics.extension,
> and 
> 
> 1) converted XML to FO with xsltproc
> 2) converted FO to PDF with FOP
> 
>   now, each of the admonitions has *both* a text label and a
> graphic.  can i dump the text and just retain the graphic?
> i thought that was the default behavior.

I asked Norm about this a couple of months ago.
The DSSSL stylesheets always did one or the other.
But the XSL stylesheets have had both the word and the
graphic (when turned on) from their first release.
He thought it was probably a bug, but since it has been
in use for so long, some people expect the word to be
there too, so just turning it off seems like a bad idea.
That's as far as we got, and no changes were made.

Perhaps there should be a new parameter that would turn off
the text label.  Maybe 'admon.textlabel' with 1 (on)
as the default to retain the current behavior.

In the mean time, you could try the following crude
workaround in a customization layer:

<xsl:template match="note|important|warning|caution|tip"
              mode="object.title.markup">
</xsl:template>


The 'graphical.admonition' template processes the note
element in object.title.markup mode to get either the
explicit <title> element if it has one or the generated
text label "Note".  Making this an empty template like this will
deliver no text at that point.  It is kind of a crude
solution, and I don't know if there would be side effects.
I don't think that mode is used in other places for
admonitions because their titles don't appear in the table
of contents, and it would be rare to xref to one.

-- 

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