1ASCIIDOC(1)                                                        ASCIIDOC(1)
2
3
4

NAME

6       asciidoc - converts an AsciiDoc text file to DocBook, HTML or LinuxDoc
7

SYNOPSIS

9       asciidoc [OPTIONS] FILE
10

DESCRIPTION

12       The asciidoc(1) command translates the AsciiDoc text file FILE to a
13       DocBook, HTML or LinuxDoc file. If FILE is - then the standard input is
14       used.
15

OPTIONS

17       -a, --attribute=ATTRIBUTE
18              Define or delete document attribute.  ATTRIBUTE is formatted
19              like NAME=VALUE. Command-line attributes take precedence over
20              document and configuration file attributes. Alternate acceptable
21              forms are NAME (the VALUE defaults to an empty string); NAME!
22              (delete the NAME attribute); NAME@ (do not override document or
23              configuration file attributes). Values containing spaces should
24              be enclosed in double-quote characters. Multiple instances
25              allowed.
26
27       -b, --backend=BACKEND
28              Backend output file format: docbook, xhtml11 or html4. Defaults
29              to xhtml11.
30
31       -f, --conf-file=CONF_FILE
32              Use configuration file CONF_FILE. Multiple instances allowed.
33              Configuration files processed in command-line order (after
34              implicit configuration files).
35
36       -d, --doctype=DOCTYPE
37              Document type: article, manpage or book. The book document type
38              is only supported by the docbook backend. Default document type
39              is article.
40
41       -c, --dump-conf
42              Dump configuration to stdout.
43
44       -h, --help[=TOPIC]
45              Print help TOPIC.  --help topics will print a list of help
46              topics, --help syntax summarises AsciiDoc syntax, --help manpage
47              prints the AsciiDoc manpage.
48
49       -e, --no-conf
50              Exclude implicitly loaded configuration files except for those
51              named like the input file (infile.conf and infile-backend.conf).
52
53       -s, --no-header-footer
54              Suppress document header and footer output.
55
56       -o, --out-file=OUT_FILE
57              Write output to file OUT_FILE. Defaults to the base name of
58              input file with backend extension. If the input is stdin then
59              the outfile defaults to stdout. If OUT_FILE is - then the
60              standard output is used.
61
62       -n, --section-numbers
63              Auto-number HTML article section titles. Synonym for -a
64              numbered.
65
66       --unsafe
67              Disable safe mode. Safe mode is enabled by default, disabling it
68              is potentially dangerous.
69
70       -v, --verbose
71              Verbosely print processing information and configuration file
72              checks to stderr.
73
74       --version
75              Print program version number.
76

BUGS

78       See the AsciiDoc distribution BUGS file.
79

AUTHOR

81       Written by Stuart Rackham, <srackham@methods.co.nz>
82

RESOURCES

84       SourceForge: http://sourceforge.net/projects/asciidoc/
85
86       Main web site: http://www.methods.co.nz/asciidoc/
87

COPYING

89       Copyright (C) 2002-2006 Stuart Rackham. Free use of this software is
90       granted under the terms of the GNU General Public License (GPL).
91
92
93
94
95                                  10/21/2006                       ASCIIDOC(1)
Impressum