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
<title>ASCIIDOC(1)</title>
8
<style type="text/css">
10
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
12
border: 1px solid red;
17
margin: 1em 5% 1em 5%;
22
text-decoration: underline;
42
h1, h2, h3, h4, h5, h6 {
44
font-family: sans-serif;
51
border-bottom: 2px solid silver;
69
border: 1px solid silver;
88
font-family: sans-serif;
94
span#revnumber, span#revdate, span#revremark {
95
font-family: sans-serif;
99
font-family: sans-serif;
101
border-top: 2px solid silver;
107
padding-bottom: 0.5em;
111
padding-bottom: 0.5em;
116
margin-bottom: 1.5em;
118
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
119
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
120
div.admonitionblock {
122
margin-bottom: 1.5em;
124
div.admonitionblock {
126
margin-bottom: 2.0em;
131
div.content { /* Block element content. */
135
/* Block element titles. */
136
div.title, caption.title {
138
font-family: sans-serif;
142
margin-bottom: 0.5em;
148
td div.title:first-child {
151
div.content div.title:first-child {
154
div.content + div.title {
158
div.sidebarblock > div.content {
160
border: 1px solid silver;
164
div.listingblock > div.content {
165
border: 1px solid silver;
170
div.quoteblock, div.verseblock {
174
border-left: 5px solid #dddddd;
178
div.quoteblock > div.attribution {
183
div.verseblock > div.content {
186
div.verseblock > div.attribution {
190
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
191
div.verseblock + div.attribution {
195
div.admonitionblock .icon {
199
text-decoration: underline;
201
padding-right: 0.5em;
203
div.admonitionblock td.content {
205
border-left: 3px solid #dddddd;
208
div.exampleblock > div.content {
209
border-left: 3px solid #dddddd;
213
div.imageblock div.content { padding-left: 0; }
214
span.image img { border-style: none; }
215
a.image:visited { color: white; }
219
margin-bottom: 0.8em;
232
list-style-position: outside;
235
list-style-type: decimal;
238
list-style-type: lower-alpha;
241
list-style-type: upper-alpha;
244
list-style-type: lower-roman;
247
list-style-type: upper-roman;
250
div.compact ul, div.compact ol,
251
div.compact p, div.compact p,
252
div.compact div, div.compact div {
254
margin-bottom: 0.1em;
257
div.tableblock > table {
258
border: 3px solid #527bbd;
260
thead, p.table.header {
261
font-family: sans-serif;
273
/* Because the table frame attribute is overriden by CSS in most browsers. */
274
div.tableblock > table[frame="void"] {
277
div.tableblock > table[frame="hsides"] {
278
border-left-style: none;
279
border-right-style: none;
281
div.tableblock > table[frame="vsides"] {
282
border-top-style: none;
283
border-bottom-style: none;
289
margin-bottom: 0.8em;
292
padding-bottom: 15px;
294
dt.hdlist1.strong, td.hdlist1.strong {
300
padding-right: 0.8em;
306
div.hdlist.compact tr {
315
.footnote, .footnoteref {
319
span.footnote, span.footnoteref {
320
vertical-align: super;
324
margin: 20px 0 20px 0;
328
#footnotes div.footnote {
334
border-top: 1px solid silver;
344
div#footer-badges { display: none; }
348
margin-bottom: 2.5em;
353
font-family: sans-serif;
357
margin-bottom: 0.1em;
360
div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
376
/* Overrides for manpage documents */
379
padding-bottom: 0.5em;
380
border-top: 2px solid silver;
381
border-bottom: 2px solid silver;
391
div#toc { display: none; }
394
/* Workarounds for IE6's broken and incomplete CSS2. */
396
div.sidebar-content {
398
border: 1px solid silver;
401
div.sidebar-title, div.image-title {
403
font-family: sans-serif;
406
margin-bottom: 0.5em;
409
div.listingblock div.content {
410
border: 1px solid silver;
415
div.quoteblock-attribution {
420
div.verseblock-content {
423
div.verseblock-attribution {
428
div.exampleblock-content {
429
border-left: 3px solid #dddddd;
433
/* IE6 sets dynamically generated links as visited. */
434
div#toc a:visited { color: blue; }
436
<script type="text/javascript">
438
window.onload = function(){asciidoc.footnotes();}
439
var asciidoc = { // Namespace.
441
/////////////////////////////////////////////////////////////////////
442
// Table Of Contents generator
443
/////////////////////////////////////////////////////////////////////
445
/* Author: Mihai Bazon, September 2002
446
* http://students.infoiasi.ro/~mishoo
448
* Table Of Content generator
451
* Feel free to use this script under the terms of the GNU General Public
452
* License, as long as you do not remove or alter this notice.
455
/* modified by Troy D. Hanson, September 2006. License: GPL */
456
/* modified by Stuart Rackham, 2006, 2009. License: GPL */
459
toc: function (toclevels) {
461
function getText(el) {
463
for (var i = el.firstChild; i != null; i = i.nextSibling) {
464
if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
466
else if (i.firstChild != null)
472
function TocEntry(el, text, toclevel) {
475
this.toclevel = toclevel;
478
function tocEntries(el, toclevels) {
479
var result = new Array;
480
var re = new RegExp('[hH]([2-'+(toclevels+1)+'])');
481
// Function that scans the DOM tree for header elements (the DOM2
482
// nodeIterator API would be a better technique but not supported by all
484
var iterate = function (el) {
485
for (var i = el.firstChild; i != null; i = i.nextSibling) {
486
if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
487
var mo = re.exec(i.tagName);
488
if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
489
result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
499
var toc = document.getElementById("toc");
500
var entries = tocEntries(document.getElementById("content"), toclevels);
501
for (var i = 0; i < entries.length; ++i) {
502
var entry = entries[i];
503
if (entry.element.id == "")
504
entry.element.id = "_toc_" + i;
505
var a = document.createElement("a");
506
a.href = "#" + entry.element.id;
507
a.appendChild(document.createTextNode(entry.text));
508
var div = document.createElement("div");
510
div.className = "toclevel" + entry.toclevel;
511
toc.appendChild(div);
513
if (entries.length == 0)
514
toc.parentNode.removeChild(toc);
518
/////////////////////////////////////////////////////////////////////
519
// Footnotes generator
520
/////////////////////////////////////////////////////////////////////
522
/* Based on footnote generation code from:
523
* http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
526
footnotes: function () {
527
var cont = document.getElementById("content");
528
var noteholder = document.getElementById("footnotes");
529
var spans = cont.getElementsByTagName("span");
532
for (i=0; i<spans.length; i++) {
533
if (spans[i].className == "footnote") {
535
// Use [\s\S] in place of . so multi-line matches work.
536
// Because JavaScript has no s (dotall) regex flag.
537
note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
538
noteholder.innerHTML +=
539
"<div class='footnote' id='_footnote_" + n + "'>" +
540
"<a href='#_footnoteref_" + n + "' title='Return to text'>" +
541
n + "</a>. " + note + "</div>";
543
"[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
544
"' title='View footnote' class='footnote'>" + n + "</a>]";
545
var id =spans[i].getAttribute("id");
546
if (id != null) refs["#"+id] = n;
550
noteholder.parentNode.removeChild(noteholder);
552
// Process footnoterefs.
553
for (i=0; i<spans.length; i++) {
554
if (spans[i].className == "footnoteref") {
555
var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
556
href = href.match(/#.*/)[0]; // Because IE return full URL.
559
"[<a href='#_footnote_" + n +
560
"' title='View footnote' class='footnote'>" + n + "</a>]";
573
ASCIIDOC(1) Manual Page
576
<div class="sectionbody">
578
converts an AsciiDoc text file to HTML or DocBook
583
<h2 id="_synopsis">SYNOPSIS</h2>
584
<div class="sectionbody">
585
<div class="paragraph"><p><strong>asciidoc</strong> [<em>OPTIONS</em>] <em>FILE</em></p></div>
587
<h2 id="_description">DESCRIPTION</h2>
588
<div class="sectionbody">
589
<div class="paragraph"><p>The asciidoc(1) command translates the AsciiDoc text file <em>FILE</em> to a
590
DocBook, HTML or LinuxDoc file. If <em>FILE</em> is <em>-</em> then the standard
591
input is used.</p></div>
593
<h2 id="_options">OPTIONS</h2>
594
<div class="sectionbody">
595
<div class="dlist"><dl>
597
<strong>-a, --attribute</strong>=<em>ATTRIBUTE</em>
601
Define or delete document attribute. <em>ATTRIBUTE</em> is formatted like
602
<em>NAME=VALUE</em>. Command-line attributes take precedence over
603
document and configuration file attributes. Alternate acceptable
604
forms are <em>NAME</em> (the <em>VALUE</em> defaults to an empty string);
605
<em>NAME!</em> (delete the <em>NAME</em> attribute); <em>NAME@</em> (do not override
606
document or configuration file attributes). Values containing
607
spaces should be enclosed in double-quote characters. This option
608
may be specified more than once. A special attribute named
609
<em>trace</em> controls the output of diagnostic information.
613
<strong>-b, --backend</strong>=<em>BACKEND</em>
617
Backend output file format: <em>docbook</em>, <em>xhtml11</em> or <em>html4</em>.
618
Defaults to <em>xhtml11</em>.
622
<strong>-f, --conf-file</strong>=<em>CONF_FILE</em>
626
Use configuration file <em>CONF_FILE</em>.Configuration files processed
627
in command-line order (after implicit configuration files). This
628
option may be specified more than once.
632
<strong>--doctest</strong>
636
Run Python doctests in <em>asciidoc</em> module.
640
<strong>-d, --doctype</strong>=<em>DOCTYPE</em>
644
Document type: <em>article</em>, <em>manpage</em> or <em>book</em>. The <em>book</em> document
645
type is only supported by the <em>docbook</em> backend. Default document
646
type is <em>article</em>.
650
<strong>-c, --dump-conf</strong>
654
Dump configuration to stdout.
658
<strong>-h, --help</strong>[=<em>TOPIC</em>]
662
Print help TOPIC. <strong>--help</strong>=<em>topics</em> will print a list of help
663
topics, <strong>--help</strong>=<em>syntax</em> summarizes AsciiDoc syntax,
664
<strong>--help</strong>=<em>manpage</em> prints the AsciiDoc manpage.
668
<strong>-e, --no-conf</strong>
672
Exclude implicitly loaded configuration files except for those
673
named like the input file (<em>infile.conf</em> and
674
<em>infile-backend.conf</em>).
678
<strong>-s, --no-header-footer</strong>
682
Suppress document header and footer output.
686
<strong>-o, --out-file</strong>=<em>OUT_FILE</em>
690
Write output to file <em>OUT_FILE</em>. Defaults to the base name of
691
input file with <em>backend</em> extension. If the input is stdin then
692
the outfile defaults to stdout. If <em>OUT_FILE</em> is <em>-</em> then the
693
standard output is used.
697
<strong>-n, --section-numbers</strong>
701
Auto-number HTML article section titles. Synonym for <strong>-a
706
<strong>--safe</strong>
710
Enable safe mode. Safe mode is disabled by default. AsciiDoc
711
<em>safe mode</em> skips potentially dangerous scripted sections in
712
AsciiDoc source files.
716
<strong>-v, --verbose</strong>
720
Verbosely print processing information and configuration file
725
<strong>--version</strong>
729
Print program version number.
734
<h2 id="_exit_status">EXIT STATUS</h2>
735
<div class="sectionbody">
736
<div class="dlist"><dl>
750
Failure (syntax or usage error; configuration error; document
751
processing failure; unexpected error).
756
<h2 id="_bugs">BUGS</h2>
757
<div class="sectionbody">
758
<div class="paragraph"><p>See the AsciiDoc distribution BUGS file.</p></div>
760
<h2 id="_author">AUTHOR</h2>
761
<div class="sectionbody">
762
<div class="paragraph"><p>Written by Stuart Rackham, <<a href="mailto:srackham@gmail.com">srackham@gmail.com</a>></p></div>
764
<h2 id="_resources">RESOURCES</h2>
765
<div class="sectionbody">
766
<div class="paragraph"><p>SourceForge: <a href="http://sourceforge.net/projects/asciidoc/">http://sourceforge.net/projects/asciidoc/</a></p></div>
767
<div class="paragraph"><p>Main web site: <a href="http://www.methods.co.nz/asciidoc/">http://www.methods.co.nz/asciidoc/</a></p></div>
769
<h2 id="_copying">COPYING</h2>
770
<div class="sectionbody">
771
<div class="paragraph"><p>Copyright (C) 2002-2009 Stuart Rackham. Free use of this software is
772
granted under the terms of the GNU General Public License (GPL).</p></div>
775
<div id="footnotes"><hr /></div>
777
<div id="footer-text">
779
Last updated 2009-11-18 13:43:26 NZDT