publican (1) - Linux Manuals
publican: a DocBook XML publishing tool.
NAME
publican - a DocBook XML publishing tool.
VERSION
This document describes publican version 1.0SYNOPSIS
publican <command options>publican <action> <action options>
Command Options
--help Display help message
--man Display the man page
--help_actions Display a list of valid actions
-v Display the version of Publican
Valid actions are:
add_revision Add an entry to the revision history
build Transform XML to other formats (pdf, html, html-single, drupal-book, etc)
clean Remove all temporary files and directories
clean_ids Run clean ids for source XML
clean_set Remove local copies of remote set books
create Create a new book, set, or article
create_brand Create a new brand
create_site Create a new WebSite in the supplied location.
help_config Display help text for the configuration file
install_book Install a book in to a WebSite.
install_brand Install a brand to the supplied location
lang_stats report PO statistics
migrate_site Migrate a website DataBase from Publican < 3 to Publican 3.
package Package a language for shipping
print_banned Print a list of banned DocBook tags
print_known Print a list of QA'd DocBook tags
print_tree Print a tree of the xi:includes
print_unused Print a list of unused XML files
print_unused_images Print a list of unused Image files
remove_book Remove a book from a WebSite.
rename Rename a publican book
site_stats Report on the contents of a WebSite
trans_drop Snapshot the source language for use in translation.
update_db Add or remove database entries. Used for processing pre-build books, such as when building packages.
update_po Update the PO files
update_pot Update the POT files
update_site Update an existing sites templates.
Run: 'bin/publican <action> --help' for details on action usage
INTERFACE
add_revision
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--lang=<LANG> The language the XML will be written in
--revnumber=<REVNUMBER> Revision number to use for a revision.
--date=<DATE> Date to use for a revision.
--member=<MEMBER> An entry to be added to the revision. Can be specified multiple times.
--firstname=<FIRSTNAME> firstname to use for a revision.
--surname=<SURNAME> surname to use for a revision.
--email=<EMAIL> email to use for a revision.
build
clean
clean_ids
clean_set
create
create_brand
create_site
help_config
install_book
install_brand
lang_stats
migrate_site
package
print_banned
print_known
print_tree
print_unused
print_unused_images
remove_book
rename
site_stats
trans_drop
update_db
update_po
update_pot
update_site
Please report any bugs or feature requests to
"publican-list [at] redhat.com", or through the web interface at
<https://bugzilla.redhat.com/bugzilla/enter_bug.cgi?product=Publican&component=publican&version=v3.2.0>.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--formats=<FORMATS> Comma-separated list of formats, for example: html,pdf,html-single,html-desktop,txt,epub
--langs=<LANGS> Comma-separated list of languages, for example: en-US,de-DE,all
--publish Set up built content for publishing
--embedtoc Embed the web site TOC object in the generated HTML
--distributed_set This flag tells publican the data being processed is a distributed set. Note: do not use distributed_set on the command line. Publican uses this flag when calling itself to process distributed sets. This is the only safe way this flag can be used.
--novalid Do not run the DTD validation
--src_dir=<SRC_DIR> Directory to source publican files from.
--pdftool=<PDFTOOL> Override the tool to use when creating PDFs. Valid options are wkhtmltopdf and fop.
--pub_dir=<PUB_DIR> Directory to publish files to. Defaults to publish.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--pub_dir=<PUB_DIR> Directory to publish files to. Defaults to publish.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--name=<NAME> The name of the book, article, set, or brand
--version=<VERSION> The version of the product
--edition=<EDITION> The edition of the book, article, or set
--product=<PRODUCT> The name of the product
--brand=<BRAND> The brand to use
--lang=<LANG> The language the XML will be written in
--type=<TYPE> The type (book, article, or set)
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--name=<NAME> The name of the book, article, set, or brand
--lang=<LANG> The language the XML will be written in
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--site_config=<SITE_CONFIG> WebSite configuration file to use or create.
--db_file=<DB_FILE> Override default database file.
--toc_path=<TOC_PATH> Override the default TOC path.
--tmpl_path=<TMPL_PATH> Override the default template path.
--lang=<LANG> The language the XML will be written in
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--site_config=<SITE_CONFIG> WebSite configuration file to use or create.
--lang=<LANG> The language the XML will be written in
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--path=<PATH> /path/to/install/to
--web Install the web content for a brand.
--pub_dir=<PUB_DIR> Directory to publish files to. Defaults to publish.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--lang=<LANG> The language the XML will be written in
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--site_config=<SITE_CONFIG> WebSite configuration file to use or create.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--lang=<LANG> The language the XML will be written in
--desktop Create desktop instead of web package
--brew Push SRPM to brew
--scratch Use scratch instead of tag build
--short_sighted Create package without using version in package name
--binary Build binary rpm when running package
--wait Wait for brew to finish building
--pub_dir=<PUB_DIR> Directory to publish files to. Defaults to publish.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--site_config=<SITE_CONFIG> WebSite configuration file to use or create.
--lang=<LANG> The language the XML will be written in
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--name=<NAME> The name of the book, article, set, or brand
--product=<PRODUCT> The name of the product
--version=<VERSION> The version of the product
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--site_config=<SITE_CONFIG> WebSite configuration file to use or create.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--site_config=<SITE_CONFIG> WebSite configuration file to use or create.
--add Add a database entry
--del Delete a database entry
--lang=<LANG> The language the XML will be written in
--product=<PRODUCT> The name of the product
--version=<VERSION> The version of the product
--name=<NAME> The name of the book, article, set, or brand
--formats=<FORMATS> Comma-separated list of formats, for example: html,pdf,html-single,html-desktop,txt,epub
--subtitle=<SUBTITLE> Sub title for a book
--abstract=<ABSTRACT> Abstract for a book
--product_label=<PRODUCT_LABEL> product label for a book
--version_label=<VERSION_LABEL> version label for a book
--name_label=<NAME_LABEL> name label for a book
--sort_order=<SORT_ORDER> Order to sort a book
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--langs=<LANGS> Comma-separated list of languages, for example: en-US,de-DE,all
--msgmerge Use gettext's msgmerge for POT/PO merging.
--firstname=<FIRSTNAME> firstname to use for a revision.
--surname=<SURNAME> surname to use for a revision.
--email=<EMAIL> email to use for a revision.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
Options:
--help Display help message
--config=s Use a nonstandard config file
--common_config=s Override path to Common_Config directory
--common_content=s Override path to Common_Content directory
--nocolours Disable ANSI colourisation of logging.
--quiet Disable all logging.
--brand_dir=s Directory to source brand files from.
--site_config=<SITE_CONFIG> WebSite configuration file to use or create.
CONFIGURATION AND ENVIRONMENT
Publican requires access to Apache FOP for creating PDF files.
DEPENDENCIES
Archive::Tar
Archive::Zip
Carp
Config::Simple
Cwd
DBI
DateTime
DateTime::Format::DateParse
Devel::Cover
Encode
File::Basename
File::Copy::Recursive
File::Find
File::Find::Rule
File::HomeDir
File::Inplace
File::Path
File::Spec
File::Which
File::pushd
Getopt::Long
HTML::FormatText
HTML::FormatText::WithLinks
HTML::FormatText::WithLinks::AndTables
HTML::TreeBuilder
I18N::LangTags::List
IO::String
List::MoreUtils
List::Util
Locale::Language
Locale::Maketext::Gettext
Locale::PO
Module::Build
Pod::Usage
Sort::Versions
String::Similarity
Syntax::Highlight::Engine::Kate
Template
Template::Constants
Term::ANSIColor
Test::More
Test::Pod
Test::Pod::Coverage
Text::CSV_XS
Text::Wrap
Time::localtime
XML::LibXML
XML::LibXSLT
XML::Simple
XML::TreeBuilder
INCOMPATIBILITIES
None reported.
BUGS AND LIMITATIONS
No bugs have been reported.
AUTHOR
Jeff Fearn "<jfearn [at] redhat.com>"