new¶

Create a new Publican::XmlBuilder object.

build¶

Transform the source in to another format.

Valid formats: eclipse epub html html-single html-desktop man pdf txt

setup_xml¶

Create the proper directory structure for the XML, including copying in Brand files.

del_unwanted_dirs¶

Callback that deletes all unwanted directories from the given directory tree. Used to delete CVS and SVN files from the working directories.

del_unwanted_xml¶

Callback that deletes all unwanted xml from the given directory tree.

validate_xml¶

Ensure the XML validates against the DTD.

To debug the XML catalogs

export XML_DEBUG_CATALOG=1

test...

unset XML_DEBUG_CATALOG

transform¶

Run XSLT over XML

drupal_transform¶

Write csv file for drupal node import

get_nodes_order¶

Get all nodes with id from xml files in order

build_drupal_book¶

Convert each html file into csv a row for drupal.

clean_ids¶

Travers over the source XML and update the id's to match the standard format.

Updates all existing PO files with the new xref links.

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.

package_brand¶

Create the structure for the distributed files and save it as a tar.gz file

package_home¶

Package a book for use as a Publican Website home page.

build_rpm¶

Build an srpm for books and brands.

package¶

Create the structure for the distributed files and save it as a tar.gz file

Creates RPM Specfile and build SRPM.

TODO: Consider handling other package formats, deb etc.

web_labels¶

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

change_log¶

Generate an RPM style change log from $xml_lang/Revision_History.xml

get_books¶

Fetch all the books for a set from a repo.

Supported Repos: SVN

build_set_books¶

Prepare XML from sub books for Remote Sets

NAME¶

Description

# my $lang = delete( $args->{lang} ) || croak(maketext("lang is a mandatory argument")); # # if ( %{$args} ) { # croak( maketext("unknown arguments: [_1]", join( ", ", keys %{$arg}) )); # }

    return;
}