Re: DOCBOOK: Admonitions

[Dan York <dyork@e-smith.com>]

Ken,

> I am working with admonitions, specifically <tip> and <warning> and would
> like to include a graphic.
> 
> I have tried using <tip graphic="tip.gif">Tie your shoe laces...</tip> but
> cannot seem to output the graphic in html (I'm using chunk.xsl).

You do not need to do anything in your DocBook code... just make sure
that you are enabling the admonition graphics in the XSL stylesheets.
In you customization layer[1], you will need to set the parameters:

  <!-- Should graphics be used for admonitions (notes, warnings)? 0 or 1 -->
  <xsl:param name="admon.graphics" select="1"/>

  <!-- If 1 above, what is path to graphics? Make sure it ends in "/" and
       make sure that it is all on one line. -->
  <xsl:param name="admon.graphics.path">images/</xsl:param>

  <!-- Again, if 1 above, what is the filename extension for admon
       graphics? -->
  <xsl:param name="admon.graphics.extension" select="'.gif'"/>

On this latter one, Norm's default is to use the PNG graphics. (Note that
these comments are ones that I include in my customization layer.)

Next you need to copy the graphics you want to use to the subdirectory
mentioned in the parameters (and relative to where your document is).
Then just generate the files.  It works great.  You can see them in 
our online manual at pages like:

  http://www.e-smith.org/docs/manual/5.0/admin-backup.html

(2 Warnings and a Note)  This page was generated with the XSL stylesheets.

Hope that helps,
Dan

[1] If you do not have a customization layer, you need one.  See some
of the pointers on http://www.docbook.org/  I also have a page with
links to my customization layer at 
http://www.e-smith.org/docs/docprocess.html
  
-- 
Dan York, Director of Training, Network Server Solutions Group
Mitel Networks Corporation                  dan_york@mitel.com
Ph: +1-613-751-4401 Cell: +1-613-263-4312 Fax: +1-613-564-7739 
150 Metcalfe Street, Suite 1500, Ottawa,ON K2P 1P1 Canada
http://www.e-smith.com/         http://www.mitel.com/sme/