Lire::ReportParser::LaTeXDocBookFormatter3pm
Lire::docbookparser subclass which formats description to latex.
Usage
To convert a DocBook decription to LaTeX:
use Lire::ReportParser::LaTeXDocBookFormatter qw/dbk2latex/;my $LaTeX = dbk2latex( "<para>Test</para>" );
Overview
This package implements methods that can handle the content of "description" elements and it can be used by a subclass of Lire::ReportParser. Client only have to inherit from this module so that a handle_description() method is available to process the text formatted DocBook description.
This module also provide a convenient dbk2txt() function which can be used to format a string containing DocBook elements into an ASCII equivalent.
USING Lire::ReportParser::LaTeXDocBookFormatter
Lire::ReportParser processors that would like to work with text version of the description should inherit from Lire::ReportParser::LaTeXDocBookFormatter in addition to Lire::ReportParser. If they override the description_start(), description_end()methods, they must link to their parents' version using "SUPER::".
Additionnally, they should merge the value elements_spec() in their elements_spec() implementation.
The Lire::ReportParser::LaTeXDocBookFormatter should be listed before Lire::ReportParser in the @ISA. The LaTeXDocBookFormatter doesn't inherit directly from Lire::ReportParser so that it can be used in multiple inheritance scenario.
dbk_start_processing()
Initializes the parser's structure for formatting DocBook XML as ASCII. This is used from the description_start implementation.
dbk_end_processing()
Cleans the parser structure. This is used from the description_end() implementation.
handle_description( $description )
This method is invoked after the closing tag of the "description" element is encountered. The $description contains the description converter to LaTeX.
PROCESSING LaTeX DESCRIPTION
The generate LaTeX is encoded in UTF-8, so Omega must be used to process it. Additionnally, the result of calling dbk_latex_environment() should be added to the document preambule. It adds some environment and command definitions used by the formatter.
FORMATTING DocBook STRINGS
If you have DocBook content in a string, like you can obtain from some of the Report Specifications object, you can convert it to LaTeX by using the dbx2latex() function.
dbk2txt( $docbook_str, [$columns] )
Returns a plain text version of the DocBook XML fragment $docbook_str. The "columns" parameter sets the number of columns in which the DocBook text should be formatted.
This method will die() in case of error.
Version
$Id: LaTeXDocBookFormatter.pm,v 1.4 2006/07/23 13:16:31 vanbaal Exp $
Releases
6 releases since Debian 3.1 (Sarge); the text changed 5 times.