NAME

Publican::Builder::DocBook - 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
                                    );

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.