man Publican::Builder::DocBook (3): A module to Convert XML to various output formats

SYNOPSIS

use Publican::Builder::DocBook;
my $builder = Publican::Builder::DocBook->new();
$builder->clean_ids();

DESCRIPTION

Manipulate DocBook XML and convert to other formats.

INTERFACE

new

Create a new Publican::Builder::DocBook object.

build

Transform the source in to another format.

#BUGBUG fix templates print( $OUT <<EOL \t\t\t\t\t\t<div class=group id=[% prod %]-[% ver.replace('\\.', '-')%]-$sort> \t\t\t\t\t\t\t<span>$term</span> EOL );

                                    print( $OUT <<EOL
\t\t\t\t\t\t\t<span>$text</span>
EOL
                                    ) if ( $text && $text ne "" );
                                    print( $OUT <<EOL
\t\t\t\t\t\t</div>
EOL
                                    );

transform

Run XSLT over XML

drupal_transform

Write csv file for drupal node import

escape_xml

Escapes an input string so that it can be used in an XML Element.

get_nodes_order

Get all nodes with id from xml files in order

get_chunk_filename

Gets the chunked filename for an LibXML::Node in a tree.

convert_num_to_alpha

Converts a numeric number to an alpha list item. ie 1 -> a, 27 -> aa

build_drupal_book

Convert each html file into csv a row for drupal.

adjustColumnWidths

Adjust column widths for XML Tables. Converts hard coded to px and relative withs to %.

FO input:

``<?xml version=\''1.0\``?>\n<fo:table-column xmlns:fo=\''http://www.w3.org/1999/XSL/Format\`` column-number=\''1\`` column-width=\''1*\``/>\n<fo:table-column xmlns:fo=\''http://www.w3.org/1999/XSL/Format\`` column-number=\''2\`` column-width=\''2*\``/>\n<fo:table-column xmlns:fo=\''http://www.w3.org/1999/XSL/Format\`` column-number=\''3\`` column-width=\''1*\``/>\n<fo:table-column xmlns:fo=\''http://www.w3.org/1999/XSL/Format\`` column-number=\''4\`` column-width=\''3*\``/>\n''

HTML input:

``<?xml version=\''1.0\``?>\n<colgroup xmlns=\''http://www.w3.org/1999/xhtml\``><col width=\''1*\``/><col width=\''2*\``/><col width=\''1*\``/><col width=\''3*\``/></colgroup>\n''

Returns: modified input tree which is XHTML or XML:FO

highlight

perl_highlight syntax highlighting

Edit highlight_color template in pdf.xsl and .perl_XXX in CSS to change highlight colours

Returns: Modified input tree, which is DocBook XML.

insertCallouts

XSLT callout function for inserting Callout markup in to verbatim text.

Parameters: areaspec: the DocBook areaspec node set
verbatim: the XHTML/XML:FO tree to place gfx in

Returns: modified $verbatim

BUGBUG: BZ #561618 BUGBUG: The approach taken here does not work for tagged content in the verbatim. BUGBUG: Need to walk the node tree in childnode instead of using it as a string. BUGBUG: make sure class is being set

numberLines

perl_numberLines XSL function for numbering lines.

Returns: Modified input tree, which is DocBook XML.

web_labels

Determine if the labels use in the web navigation are different from the names used for packaging.