1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
5
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6
<meta name="generator" content="AsciiDoc 8.5.2" />
7
<link rel="stylesheet" href="./xhtml11.css" type="text/css" />
8
<link rel="stylesheet" href="./xhtml11-manpage.css" type="text/css" />
9
<link rel="stylesheet" href="./xhtml11-quirks.css" type="text/css" />
10
<link rel="stylesheet" href="./layout1.css" type="text/css" />
11
<script type="text/javascript">
13
window.onload = function(){asciidoc.footnotes();}
16
<script type="text/javascript" src="./asciidoc-xhtml11.js"></script>
17
<title>ASCIIDOC(1)</title>
19
<body style="max-width:70em">
20
<div id="layout-banner">
21
<div id="layout-title">AsciiDoc</div>
22
<div id="layout-description">Text based document generation</div>
27
<div>»<a href="index.html">Home</a></div>
28
<div>»<a href="manpage.html">Man Page</a></div>
29
<div>»<a href="userguide.html">User Guide</a></div>
30
<div>»<a href="INSTALL.html">Installation</a></div>
31
<div>»<a href="faq.html">FAQ</a></div>
32
<div>»<a href="a2x.1.html">a2x</a></div>
33
<div>»<a href="asciidocapi.html">API</a></div>
34
<div>»<a href="http://powerman.name/doc/asciidoc">Cheatsheet</a></div>
35
<div>»<a href="testasciidoc.html">Tests</a></div>
36
<div>»<a href="CHANGELOG.html">ChangeLog</a></div>
37
<div>»<a href="support.html">Support</a></div>
38
<div id="page-source">»<a href="manpage.txt">Page Source</a></div>
41
<div id="layout-content">
44
ASCIIDOC(1) Manual Page
47
<div class="sectionbody">
49
converts an AsciiDoc text file to HTML or DocBook
54
<h2 id="_synopsis">SYNOPSIS</h2>
55
<div class="sectionbody">
56
<div class="paragraph"><p><strong>asciidoc</strong> [<em>OPTIONS</em>] <em>FILE</em></p></div>
58
<h2 id="_description">DESCRIPTION</h2>
59
<div class="sectionbody">
60
<div class="paragraph"><p>The <tt>asciidoc(1)</tt> command translates the AsciiDoc text file <em>FILE</em> to a
61
DocBook, HTML or LinuxDoc file. If <em>FILE</em> is <em>-</em> then the standard
62
input is used.</p></div>
64
<h2 id="_options">OPTIONS</h2>
65
<div class="sectionbody">
66
<div class="dlist"><dl>
68
<strong>-a, --attribute</strong>=<em>ATTRIBUTE</em>
72
Define or delete document attribute. <em>ATTRIBUTE</em> is formatted like
73
<em>NAME=VALUE</em>. Command-line attributes take precedence over
74
document and configuration file attributes. Alternate acceptable
75
forms are <em>NAME</em> (the <em>VALUE</em> defaults to an empty string);
76
<em>NAME!</em> (delete the <em>NAME</em> attribute); <em>NAME@</em> (do not override
77
document or configuration file attributes). Values containing
78
spaces should be enclosed in double-quote characters. This option
79
may be specified more than once. A special attribute named
80
<em>trace</em> controls the output of diagnostic information.
84
<strong>-b, --backend</strong>=<em>BACKEND</em>
88
Backend output file format: <em>docbook</em>, <em>xhtml11</em> or <em>html4</em>.
89
Defaults to <em>xhtml11</em>.
93
<strong>-f, --conf-file</strong>=<em>CONF_FILE</em>
97
Use configuration file <em>CONF_FILE</em>.Configuration files processed
98
in command-line order (after implicit configuration files). This
99
option may be specified more than once.
103
<strong>--doctest</strong>
107
Run Python doctests in <em>asciidoc</em> module.
111
<strong>-d, --doctype</strong>=<em>DOCTYPE</em>
115
Document type: <em>article</em>, <em>manpage</em> or <em>book</em>. The <em>book</em> document
116
type is only supported by the <em>docbook</em> backend. Default document
117
type is <em>article</em>.
121
<strong>-c, --dump-conf</strong>
125
Dump configuration to stdout.
129
<strong>-h, --help</strong>[=<em>TOPIC</em>]
133
Print help TOPIC. <strong>--help</strong>=<em>topics</em> will print a list of help
134
topics, <strong>--help</strong>=<em>syntax</em> summarizes AsciiDoc syntax,
135
<strong>--help</strong>=<em>manpage</em> prints the AsciiDoc manpage.
139
<strong>-e, --no-conf</strong>
143
Exclude implicitly loaded configuration files except for those
144
named like the input file (<em>infile.conf</em> and
145
<em>infile-backend.conf</em>).
149
<strong>-s, --no-header-footer</strong>
153
Suppress document header and footer output.
157
<strong>-o, --out-file</strong>=<em>OUT_FILE</em>
161
Write output to file <em>OUT_FILE</em>. Defaults to the base name of
162
input file with <em>backend</em> extension. If the input is stdin then
163
the outfile defaults to stdout. If <em>OUT_FILE</em> is <em>-</em> then the
164
standard output is used.
168
<strong>-n, --section-numbers</strong>
172
Auto-number HTML article section titles. Synonym for <strong>-a
177
<strong>--safe</strong>
181
Enable safe mode. Safe mode is disabled by default. AsciiDoc
182
<em>safe mode</em> skips potentially dangerous scripted sections in
183
AsciiDoc source files.
187
<strong>-v, --verbose</strong>
191
Verbosely print processing information and configuration file
196
<strong>--version</strong>
200
Print program version number.
205
<h2 id="_exit_status">EXIT STATUS</h2>
206
<div class="sectionbody">
207
<div class="dlist"><dl>
221
Failure (syntax or usage error; configuration error; document
222
processing failure; unexpected error).
227
<h2 id="_bugs">BUGS</h2>
228
<div class="sectionbody">
229
<div class="paragraph"><p>See the AsciiDoc distribution BUGS file.</p></div>
231
<h2 id="_author">AUTHOR</h2>
232
<div class="sectionbody">
233
<div class="paragraph"><p>Written by Stuart Rackham, <<a href="mailto:srackham@gmail.com">srackham@gmail.com</a>></p></div>
235
<h2 id="_resources">RESOURCES</h2>
236
<div class="sectionbody">
237
<div class="paragraph"><p>SourceForge: <a href="http://sourceforge.net/projects/asciidoc/">http://sourceforge.net/projects/asciidoc/</a></p></div>
238
<div class="paragraph"><p>Main web site: <a href="http://www.methods.co.nz/asciidoc/">http://www.methods.co.nz/asciidoc/</a></p></div>
240
<h2 id="_copying">COPYING</h2>
241
<div class="sectionbody">
242
<div class="paragraph"><p>Copyright (C) 2002-2009 Stuart Rackham. Free use of this software is
243
granted under the terms of the GNU General Public License (GPL).</p></div>
246
<div id="footnotes"><hr /></div>
248
<div id="footer-text">
250
Last updated 2009-12-07 17:24:57 NZDT
252
<div id="footer-badges">
253
<a href="http://validator.w3.org/check?uri=referer">
254
<img style="border:0;width:88px;height:31px"
255
src="http://www.w3.org/Icons/valid-xhtml11-blue"
256
alt="Valid XHTML 1.1" height="31" width="88" />
258
<a href="http://jigsaw.w3.org/css-validator/">
259
<img style="border:0;width:88px;height:31px"
260
src="http://jigsaw.w3.org/css-validator/images/vcss-blue"
263
<a href="http://www.mozilla.org/products/firefox/">
264
<img style="border:none; width:110px; height:32px;"
265
src="http://www.spreadfirefox.com/community/images/affiliates/Buttons/110x32/safer.gif"
266
alt="Get Firefox!" />