asciidoc - converts an AsciiDoc text file to HTML or DocBook
asciidoc [OPTIONS] FILE
The asciidoc(1) command translates the AsciiDoc text file FILE to a DocBook, HTML or LinuxDoc file. If FILE is - then the standard input is used.
Define or delete document attribute. ATTRIBUTE is formatted like NAME=VALUE. Command-line attributes take precedence over document and configuration file attributes. Alternate acceptable forms are NAME (the VALUE defaults to an empty string); NAME! (delete the NAME attribute); NAME@ (do not override document or configuration file attributes). Values containing spaces should be enclosed in double-quote characters. This option may be specified more than once. A special attribute named trace controls the output of diagnostic information.
Backend output file format: docbook, xhtml11 or html4. Defaults to xhtml11.
Use configuration file CONF_FILE.Configuration files processed in command-line order (after implicit configuration files). This option may be specified more than once.
Run Python doctests in asciidoc module.
Document type: article, manpage or book. The book document type is only supported by the docbook backend. Default document type is article.
Dump configuration to stdout.
Print help TOPIC. --help=topics will print a list of help topics, --help=syntax summarizes AsciiDoc syntax, --help=manpage prints the AsciiDoc manpage.
Exclude implicitly loaded configuration files except for those named like the input file (infile.conf and infile-backend.conf).
Suppress document header and footer output.
Write output to file OUT_FILE. Defaults to the base name of input file with backend extension. If the input is stdin then the outfile defaults to stdout. If OUT_FILE is - then the standard output is used.
Auto-number HTML article section titles. Synonym for -a numbered.
Enable safe mode. Safe mode is disabled by default. AsciiDoc safe mode skips potentially dangerous scripted sections in AsciiDoc source files.
Verbosely print processing information and configuration file checks to stderr.
Print program version number.
Success
Failure (syntax or usage error; configuration error; document processing failure; unexpected error).
See the AsciiDoc distribution BUGS file.
Written by Stuart Rackham, <srackham@gmail.com>
SourceForge: http://sourceforge.net/projects/asciidoc/
Main web site: http://www.methods.co.nz/asciidoc/
Copyright (C) 2002-2009 Stuart Rackham. Free use of this software is granted under the terms of the GNU General Public License (GPL).