Common files and scripts for building Red Hat documentation.

Assumptions: DocBook xml, *nix, en-US source language.

Q: What actions are their?

A: publican --help

Q: How do I add a language?

A: publican update_po --langs=<xx-YY>

This will create the language directory and the language specific po files.

Q: How do I update all po files?

A: publican update_po --lANGS=ALLall

Q: What Book specific options can I use?

A: publican --help_config


Q: Where are the common files located?

A: By default they are in /usr/share/publican

Q: How do I build publican from source?

A: It depends on your platform.

Get the source: svn co http://svn.fedorahosted.org/svn/publican/trunk/publican

Perl
    cd publican
    TODO: deps
    perl Build.PL
    ./Build
    ./Build test
    ./Build install

RHEL/Fedora
    cd publican
    TODO: deps
    perl Build.PL
    ./Build rpm

Debian
    cd publican
    TODO: deps
    debuild

Windows
    Install Perl http://www.activestate.com/activeperl/
    TODO: deps
    Install NSIS http://nsis.sourceforge.net/Download
    Install http://nsis.sourceforge.net/Environmental_Variables:_append,_prepend,_and_remove_entries
    TODO: Detail where that goes
    Download the DocBook DTD and expand it to the same dir publican is in
    Download the DocBook XSL and expand it to the same dir publican is in
    cd publican\windows
    pp @pp-opts ..\bin\publican -vv 1>2> pp.log
    compile publican.nsi in NSIS


