Publican::Builder::DocBook5(3pm)

Publican::Builder::DocBook53pm

A module to convert xml to various output formats

Usage

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

Overview

Manipulate DocBook 4 XML and convert to other formats.

Interface

new

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

setup_xml

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

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.

validate_xml

Ensure the XML validates against the DTD.

To debug the XML catalogs

export XML_DEBUG_CATALOG=1

test...

unset XML_DEBUG_CATALOG

get_author_list

Return the author list for the supplied language.

## BUGBUG this should be moved to the DocBook sub classes

Diagnostics

"unknown args %s"

All subs with named parameters will return this error when unexpected named arguments are provided.

"%s is a required argument"

Any sub with a mandatory parameter will return this error if the parameter is undef.

Configuration and environment

Publican requires no configuration files or environment variables.

Dependencies

Carp version Publican Publican::XmlClean Publican::Translate File::Path File::pushd File::Find XML::LibXML Cwd Archive::Tar DateTime DateTime::Format::DateParse Syntax::Highlight::Engine::Kate HTML::TreeBuilder HTML::FormatText Term::ANSIColor POSIX

Incompatibilities

None reported.

Bugs and limitations

No bugs have been reported.

Please report any bugs or feature requests to "[email protected]", or through the web interface at <https://bugzilla.redhat.com/bugzilla/enter_bug.cgi?product=Publican&component=publican>.

Releases

6 releases since Debian 8 (Jessie); the text changed 3 times.

  1. 8
  2. 9
  3. 10–12
  4. 13

Author

Jeff Fearn "<[email protected]>"

From publican 4.3.2-5 in Debian 13 (Trixie). Parsed by carta from the page's man source.