I'm working with a local modification to quickbook which you might
like to consider including. I've added support for DocBook admonitions
(warning, caution, important, tip, warning).

[:[$images/note.png] This generates a blockquote which looks like a note.]

[note This generates a DocBook note. See
[EMAIL PROTECTED]://docbook.org/tdg/en/html/note.html]]

This has several benefits:

* the inline images used with the blockquote style looked poor using
  my PDF toolchain (they messed up the text layout); the docbook
  stylesheets did a much better job with admonition graphics

* the DocBook XML contains better structural information -- for example, the
  output HTML could present warnings and tips differently using
  appropriate CSS on the "warning" and "tip" classes.

* tweaking the styling of admonitions can be done using DocBook XSL
  parameters:

  admon.graphics
  admon.graphics.path
  admon.graphics.extension
  etc
  Thus, for example, we can have SVG graphics for PDF and PNG for
  HTML.

Of course, the downside is that the Quickbook syntax grows a little
bigger -- Quickbook shouldn't try and do everything DocBook can.

Let me know what you think and I can submit a patch.
--
Thomas Guest
http://www.wordaligned.org


-------------------------------------------------------
This SF.net email is sponsored by: Splunk Inc. Do you grep through log files
for problems?  Stop!  Download the new AJAX search engine that makes
searching your log files as easy as surfing the  web.  DOWNLOAD SPLUNK!
http://ads.osdn.com/?ad_idv37&alloc_id865&op=click
_______________________________________________
Boost-docs mailing list
[email protected]
Unsubscribe and other administrative requests: 
https://lists.sourceforge.net/lists/listinfo/boost-docs

Reply via email to