mizuho 0.9.6
Sign up to get free protection for your applications and to get access to all the features.
- data/LICENSE.txt +20 -0
- data/README.markdown +61 -0
- data/Rakefile +41 -0
- data/asciidoc/BUGS +39 -0
- data/asciidoc/BUGS.txt +32 -0
- data/asciidoc/CHANGELOG +1796 -0
- data/asciidoc/CHANGELOG.txt +1810 -0
- data/asciidoc/COPYING +339 -0
- data/asciidoc/COPYRIGHT +18 -0
- data/asciidoc/INSTALL +76 -0
- data/asciidoc/INSTALL.txt +71 -0
- data/asciidoc/Makefile.in +161 -0
- data/asciidoc/README +46 -0
- data/asciidoc/README.txt +36 -0
- data/asciidoc/a2x +674 -0
- data/asciidoc/asciidoc.conf +455 -0
- data/asciidoc/asciidoc.py +4998 -0
- data/asciidoc/common.aap +9 -0
- data/asciidoc/configure +2840 -0
- data/asciidoc/configure.ac +11 -0
- data/asciidoc/dblatex/asciidoc-dblatex.sty +20 -0
- data/asciidoc/dblatex/asciidoc-dblatex.xsl +32 -0
- data/asciidoc/dblatex/dblatex-readme.txt +39 -0
- data/asciidoc/doc/a2x.1 +257 -0
- data/asciidoc/doc/a2x.1.txt +204 -0
- data/asciidoc/doc/article.css-embedded.html +602 -0
- data/asciidoc/doc/article.html +46 -0
- data/asciidoc/doc/article.pdf +0 -0
- data/asciidoc/doc/article.txt +122 -0
- data/asciidoc/doc/asciidoc-revhistory.xml +27 -0
- data/asciidoc/doc/asciidoc.1 +155 -0
- data/asciidoc/doc/asciidoc.1.css-embedded.html +598 -0
- data/asciidoc/doc/asciidoc.1.css.html +212 -0
- data/asciidoc/doc/asciidoc.1.html +190 -0
- data/asciidoc/doc/asciidoc.1.txt +118 -0
- data/asciidoc/doc/asciidoc.conf +8 -0
- data/asciidoc/doc/asciidoc.css-embedded.html +7853 -0
- data/asciidoc/doc/asciidoc.css.html +7416 -0
- data/asciidoc/doc/asciidoc.dict +733 -0
- data/asciidoc/doc/asciidoc.html +3339 -0
- data/asciidoc/doc/asciidoc.txt +4979 -0
- data/asciidoc/doc/asciimathml.txt +64 -0
- data/asciidoc/doc/book-multi.css-embedded.html +575 -0
- data/asciidoc/doc/book-multi.html +55 -0
- data/asciidoc/doc/book-multi.txt +155 -0
- data/asciidoc/doc/book.css-embedded.html +607 -0
- data/asciidoc/doc/book.html +43 -0
- data/asciidoc/doc/book.txt +131 -0
- data/asciidoc/doc/customers.csv +18 -0
- data/asciidoc/doc/docbook-xsl.css +272 -0
- data/asciidoc/doc/faq.txt +547 -0
- data/asciidoc/doc/latex-backend.html +117 -0
- data/asciidoc/doc/latex-backend.txt +191 -0
- data/asciidoc/doc/latexmath.txt +244 -0
- data/asciidoc/doc/latexmathml.txt +41 -0
- data/asciidoc/doc/main.aap +297 -0
- data/asciidoc/doc/music-filter.html +566 -0
- data/asciidoc/doc/music-filter.pdf +0 -0
- data/asciidoc/doc/music-filter.txt +158 -0
- data/asciidoc/doc/source-highlight-filter.html +214 -0
- data/asciidoc/doc/source-highlight-filter.pdf +0 -0
- data/asciidoc/doc/source-highlight-filter.txt +203 -0
- data/asciidoc/docbook-xsl/asciidoc-docbook-xsl.txt +43 -0
- data/asciidoc/docbook-xsl/chunked.xsl +19 -0
- data/asciidoc/docbook-xsl/common.xsl +67 -0
- data/asciidoc/docbook-xsl/fo.xsl +149 -0
- data/asciidoc/docbook-xsl/htmlhelp.xsl +17 -0
- data/asciidoc/docbook-xsl/manpage.xsl +31 -0
- data/asciidoc/docbook-xsl/text.xsl +50 -0
- data/asciidoc/docbook-xsl/xhtml.xsl +14 -0
- data/asciidoc/docbook.conf +721 -0
- data/asciidoc/examples/website/ASCIIMathML.js +938 -0
- data/asciidoc/examples/website/CHANGELOG.html +4389 -0
- data/asciidoc/examples/website/CHANGELOG.txt +1810 -0
- data/asciidoc/examples/website/INSTALL.html +161 -0
- data/asciidoc/examples/website/INSTALL.txt +71 -0
- data/asciidoc/examples/website/LaTeXMathML.js +1223 -0
- data/asciidoc/examples/website/README-website.html +118 -0
- data/asciidoc/examples/website/README-website.txt +29 -0
- data/asciidoc/examples/website/README.html +125 -0
- data/asciidoc/examples/website/README.txt +36 -0
- data/asciidoc/examples/website/a2x.1.html +419 -0
- data/asciidoc/examples/website/a2x.1.txt +204 -0
- data/asciidoc/examples/website/asciidoc-docbook-xsl.html +130 -0
- data/asciidoc/examples/website/asciidoc-docbook-xsl.txt +43 -0
- data/asciidoc/examples/website/asciidoc-graphviz-sample.txt +130 -0
- data/asciidoc/examples/website/asciimathml.txt +64 -0
- data/asciidoc/examples/website/build-website.sh +25 -0
- data/asciidoc/examples/website/customers.csv +18 -0
- data/asciidoc/examples/website/downloads.html +257 -0
- data/asciidoc/examples/website/downloads.txt +121 -0
- data/asciidoc/examples/website/faq.html +673 -0
- data/asciidoc/examples/website/faq.txt +547 -0
- data/asciidoc/examples/website/index.html +419 -0
- data/asciidoc/examples/website/index.txt +245 -0
- data/asciidoc/examples/website/latex-backend.html +535 -0
- data/asciidoc/examples/website/latex-backend.txt +191 -0
- data/asciidoc/examples/website/latexmathml.txt +41 -0
- data/asciidoc/examples/website/layout1.conf +161 -0
- data/asciidoc/examples/website/layout1.css +65 -0
- data/asciidoc/examples/website/layout2.conf +158 -0
- data/asciidoc/examples/website/layout2.css +93 -0
- data/asciidoc/examples/website/manpage.html +266 -0
- data/asciidoc/examples/website/manpage.txt +118 -0
- data/asciidoc/examples/website/music-filter.html +242 -0
- data/asciidoc/examples/website/music-filter.txt +158 -0
- data/asciidoc/examples/website/music1.abc +12 -0
- data/asciidoc/examples/website/music1.png +0 -0
- data/asciidoc/examples/website/music2.ly +9 -0
- data/asciidoc/examples/website/music2.png +0 -0
- data/asciidoc/examples/website/newlists.txt +40 -0
- data/asciidoc/examples/website/newtables.txt +397 -0
- data/asciidoc/examples/website/sample1.png +0 -0
- data/asciidoc/examples/website/sample3.png +0 -0
- data/asciidoc/examples/website/sample4.png +0 -0
- data/asciidoc/examples/website/source-highlight-filter.html +286 -0
- data/asciidoc/examples/website/source-highlight-filter.txt +203 -0
- data/asciidoc/examples/website/support.html +78 -0
- data/asciidoc/examples/website/support.txt +5 -0
- data/asciidoc/examples/website/toc.js +69 -0
- data/asciidoc/examples/website/userguide.html +7460 -0
- data/asciidoc/examples/website/userguide.txt +4979 -0
- data/asciidoc/examples/website/version83.txt +37 -0
- data/asciidoc/examples/website/version9.html +143 -0
- data/asciidoc/examples/website/version9.txt +48 -0
- data/asciidoc/examples/website/xhtml11-manpage.css +18 -0
- data/asciidoc/examples/website/xhtml11-quirks.css +41 -0
- data/asciidoc/examples/website/xhtml11.css +328 -0
- data/asciidoc/filters/code/code-filter-readme.txt +37 -0
- data/asciidoc/filters/code/code-filter-test.txt +15 -0
- data/asciidoc/filters/code/code-filter.conf +8 -0
- data/asciidoc/filters/code/code-filter.py +239 -0
- data/asciidoc/filters/graphviz/asciidoc-graphviz-sample.txt +130 -0
- data/asciidoc/filters/graphviz/graphviz-filter.conf +39 -0
- data/asciidoc/filters/graphviz/graphviz2png.py +154 -0
- data/asciidoc/filters/music/music-filter-test.txt +40 -0
- data/asciidoc/filters/music/music-filter.conf +40 -0
- data/asciidoc/filters/music/music2png.py +189 -0
- data/asciidoc/filters/source/source-highlight-filter-test.txt +19 -0
- data/asciidoc/filters/source/source-highlight-filter.conf +108 -0
- data/asciidoc/help.conf +213 -0
- data/asciidoc/html4.conf +460 -0
- data/asciidoc/images/highlighter.png +0 -0
- data/asciidoc/images/icons/README +5 -0
- data/asciidoc/images/icons/callouts/1.png +0 -0
- data/asciidoc/images/icons/callouts/10.png +0 -0
- data/asciidoc/images/icons/callouts/11.png +0 -0
- data/asciidoc/images/icons/callouts/12.png +0 -0
- data/asciidoc/images/icons/callouts/13.png +0 -0
- data/asciidoc/images/icons/callouts/14.png +0 -0
- data/asciidoc/images/icons/callouts/15.png +0 -0
- data/asciidoc/images/icons/callouts/2.png +0 -0
- data/asciidoc/images/icons/callouts/3.png +0 -0
- data/asciidoc/images/icons/callouts/4.png +0 -0
- data/asciidoc/images/icons/callouts/5.png +0 -0
- data/asciidoc/images/icons/callouts/6.png +0 -0
- data/asciidoc/images/icons/callouts/7.png +0 -0
- data/asciidoc/images/icons/callouts/8.png +0 -0
- data/asciidoc/images/icons/callouts/9.png +0 -0
- data/asciidoc/images/icons/caution.png +0 -0
- data/asciidoc/images/icons/example.png +0 -0
- data/asciidoc/images/icons/home.png +0 -0
- data/asciidoc/images/icons/important.png +0 -0
- data/asciidoc/images/icons/next.png +0 -0
- data/asciidoc/images/icons/note.png +0 -0
- data/asciidoc/images/icons/prev.png +0 -0
- data/asciidoc/images/icons/tip.png +0 -0
- data/asciidoc/images/icons/up.png +0 -0
- data/asciidoc/images/icons/warning.png +0 -0
- data/asciidoc/images/smallnew.png +0 -0
- data/asciidoc/images/tiger.png +0 -0
- data/asciidoc/install-sh +201 -0
- data/asciidoc/javascripts/ASCIIMathML.js +938 -0
- data/asciidoc/javascripts/LaTeXMathML.js +1223 -0
- data/asciidoc/javascripts/toc.js +69 -0
- data/asciidoc/lang-es.conf +15 -0
- data/asciidoc/latex.conf +663 -0
- data/asciidoc/stylesheets/docbook-xsl.css +272 -0
- data/asciidoc/stylesheets/xhtml11-manpage.css +18 -0
- data/asciidoc/stylesheets/xhtml11-quirks.css +41 -0
- data/asciidoc/stylesheets/xhtml11.css +328 -0
- data/asciidoc/text.conf +16 -0
- data/asciidoc/vim/ftdetect/asciidoc_filetype.vim +53 -0
- data/asciidoc/vim/syntax/asciidoc.vim +165 -0
- data/asciidoc/wordpress.conf +48 -0
- data/asciidoc/xhtml11-quirks.conf +57 -0
- data/asciidoc/xhtml11.conf +645 -0
- data/bin/mizuho +47 -0
- data/bin/mizuho-asciidoc +4 -0
- data/lib/mizuho.rb +10 -0
- data/lib/mizuho/chapter.rb +54 -0
- data/lib/mizuho/generator.rb +134 -0
- data/lib/mizuho/heading.rb +46 -0
- data/lib/mizuho/parser.rb +103 -0
- data/lib/mizuho/source_highlight.rb +2 -0
- data/lib/mizuho/template.rb +50 -0
- data/source-highlight/ada.lang +38 -0
- data/source-highlight/bib.lang +6 -0
- data/source-highlight/bison.lang +3 -0
- data/source-highlight/c.lang +41 -0
- data/source-highlight/c_comment.lang +27 -0
- data/source-highlight/c_string.lang +9 -0
- data/source-highlight/caml.lang +16 -0
- data/source-highlight/changelog.lang +8 -0
- data/source-highlight/clike_vardeclaration.lang +4 -0
- data/source-highlight/cpp.lang +15 -0
- data/source-highlight/csharp.lang +36 -0
- data/source-highlight/css.lang +14 -0
- data/source-highlight/css_common.outlang +26 -0
- data/source-highlight/darwin/source-highlight +0 -0
- data/source-highlight/default.css +51 -0
- data/source-highlight/default.lang +8 -0
- data/source-highlight/default.style +57 -0
- data/source-highlight/desktop.lang +7 -0
- data/source-highlight/diff.lang +32 -0
- data/source-highlight/docbook.outlang +36 -0
- data/source-highlight/esc.outlang +46 -0
- data/source-highlight/esc.style +35 -0
- data/source-highlight/extreme_comment.lang +5 -0
- data/source-highlight/extreme_comment2.lang +5 -0
- data/source-highlight/extreme_comment3.lang +15 -0
- data/source-highlight/fixed-fortran.lang +5 -0
- data/source-highlight/flex.lang +37 -0
- data/source-highlight/fortran.lang +57 -0
- data/source-highlight/function.lang +2 -0
- data/source-highlight/glsl.lang +86 -0
- data/source-highlight/haxe.lang +7 -0
- data/source-highlight/html.lang +7 -0
- data/source-highlight/html.outlang +25 -0
- data/source-highlight/html_common.outlang +35 -0
- data/source-highlight/html_notfixed.outlang +22 -0
- data/source-highlight/html_ref.outlang +6 -0
- data/source-highlight/htmlcss.outlang +28 -0
- data/source-highlight/htmltable.outlang +14 -0
- data/source-highlight/htmltablelinenum.outlang +26 -0
- data/source-highlight/java.lang +26 -0
- data/source-highlight/javadoc.outlang +24 -0
- data/source-highlight/javascript.lang +27 -0
- data/source-highlight/key_string.lang +4 -0
- data/source-highlight/lang.map +108 -0
- data/source-highlight/langdef.lang +21 -0
- data/source-highlight/latex.lang +52 -0
- data/source-highlight/latex.outlang +59 -0
- data/source-highlight/latexcolor.outlang +44 -0
- data/source-highlight/ldap.lang +10 -0
- data/source-highlight/log.lang +53 -0
- data/source-highlight/logtalk.lang +85 -0
- data/source-highlight/lsm.lang +7 -0
- data/source-highlight/lua.lang +27 -0
- data/source-highlight/m4.lang +27 -0
- data/source-highlight/makefile.lang +42 -0
- data/source-highlight/nohilite.lang +2 -0
- data/source-highlight/number.lang +3 -0
- data/source-highlight/outlang.lang +16 -0
- data/source-highlight/outlang.map +12 -0
- data/source-highlight/pascal.lang +20 -0
- data/source-highlight/perl.lang +134 -0
- data/source-highlight/php.lang +25 -0
- data/source-highlight/postscript.lang +42 -0
- data/source-highlight/prolog.lang +37 -0
- data/source-highlight/properties.lang +7 -0
- data/source-highlight/python.lang +26 -0
- data/source-highlight/ruby.lang +32 -0
- data/source-highlight/scala.lang +31 -0
- data/source-highlight/script_comment.lang +3 -0
- data/source-highlight/sh.lang +38 -0
- data/source-highlight/slang.lang +25 -0
- data/source-highlight/sml.lang +5 -0
- data/source-highlight/source-highlight +24 -0
- data/source-highlight/spec.lang +12 -0
- data/source-highlight/sql.lang +46 -0
- data/source-highlight/style.defaults +15 -0
- data/source-highlight/style.lang +16 -0
- data/source-highlight/style2.style +10 -0
- data/source-highlight/style3.style +10 -0
- data/source-highlight/symbols.lang +2 -0
- data/source-highlight/tcl.lang +35 -0
- data/source-highlight/texinfo.outlang +34 -0
- data/source-highlight/texinfo.style +20 -0
- data/source-highlight/url.lang +3 -0
- data/source-highlight/xhtml.outlang +25 -0
- data/source-highlight/xhtml_common.outlang +8 -0
- data/source-highlight/xhtml_notfixed.outlang +16 -0
- data/source-highlight/xhtmlcss.outlang +19 -0
- data/source-highlight/xhtmltable.outlang +7 -0
- data/source-highlight/xml.lang +17 -0
- data/source-highlight/xorg.lang +10 -0
- data/templates/asciidoc.css +358 -0
- data/templates/asciidoc.html.erb +86 -0
- data/templates/manualsonrails.css +165 -0
- data/templates/manualsonrails.html.erb +97 -0
- data/test/generator_spec.rb +60 -0
- data/test/parser_spec.rb +239 -0
- data/test/spec_helper.rb +51 -0
- metadata +358 -0
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
|
|
2
|
+
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>The Article Title</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.73.2" /></head><body><div class="article" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title"><a id="id2425213"></a>The Article Title</h2></div><div><div class="author"><h3 class="author"><span class="firstname">Author's</span> <span class="surname">Name</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a class="email" href="mailto:authors@email.address">authors@email.address</a>></code></p></div></div></div></div><div><div class="revhistory"><table border="1" width="100%" summary="Revision history"><tr><th align="left" valign="top" colspan="3"><b>Revision History</b></th></tr><tr><td align="left">Revision 1.0</td><td align="left">Dec 2003</td><td align="left">AN</td></tr></table></div></div></div><hr /></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#_the_first_section">1. The First Section</a></span></dt><dd><dl><dt><span class="section"><a href="#X1">1.1. Sub-section with Anchor</a></span></dt></dl></dd><dt><span class="section"><a href="#_the_second_section">2. The Second Section</a></span></dt><dt><span class="appendix"><a href="#_example_appendix">A. Example Appendix</a></span></dt><dd><dl><dt><span class="section"><a href="#_appendix_sub_section">A.1. Appendix Sub-section</a></span></dt></dl></dd><dt><span class="bibliography"><a href="#_bibliography">Bibliography</a></span></dt><dt><span class="glossary"><a href="#_glossary">Glossary</a></span></dt><dt><span class="index"><a href="#_index">Index</a></span></dt></dl></div><p>This is the optional preamble (an untitled section body). Useful for
|
|
3
|
+
writing simple sectionless documents consisting only of a preamble.</p><div class="abstract"><a id="_abstract"></a><p class="title"><b>Abstract</b></p><p>The optional abstract (one or more paragraphs) goes here.</p><p>This document is an <span class="emphasis"><em>AsciiDoc</em></span> article skeleton containing briefly
|
|
4
|
+
annotated element placeholders plus a couple of example index entries
|
|
5
|
+
and footnotes. The preface, appendix, bibliography, glossary and index
|
|
6
|
+
section titles are significant (<span class="emphasis"><em>specialsections</em></span>).</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_the_first_section"></a>1. The First Section</h2></div></div></div><p>Article sections start at level 1 and can be nested up to four levels
|
|
7
|
+
deep.
|
|
8
|
+
<sup>[<a id="id2425488" href="#ftn.id2425488" class="footnote">1</a>]</sup>
|
|
9
|
+
<a id="id2518161" class="indexterm"></a></p><p>And now for something completely different: <a id="id2518171" class="indexterm"></a>monkeys, lions and
|
|
10
|
+
tigers (Bengal and Siberian) using the alternative syntax index
|
|
11
|
+
entries.
|
|
12
|
+
<a id="id2518180" class="indexterm"></a>
|
|
13
|
+
<a id="id2477454" class="indexterm"></a>
|
|
14
|
+
<a id="id2477463" class="indexterm"></a>
|
|
15
|
+
<a id="id2477477" class="indexterm"></a>
|
|
16
|
+
<a id="id2477489" class="indexterm"></a>
|
|
17
|
+
<a id="id2477498" class="indexterm"></a>
|
|
18
|
+
<a id="id2477512" class="indexterm"></a>
|
|
19
|
+
<a id="id2477523" class="indexterm"></a>
|
|
20
|
+
Note that multi-entry terms generate separate index entries.</p><p>Here are a couple of image examples: an <span class="inlinemediaobject"><img src="images/smallnew.png" alt="images/smallnew.png" /></span>
|
|
21
|
+
example inline image followed by an example block image:</p><div class="figure"><a id="id2477554"></a><p class="title"><b>Figure 1. Tiger block image</b></p><div class="figure-contents"><div class="mediaobject"><img src="images/tiger.png" alt="Tiger image" /></div></div></div><br class="figure-break" /><p>Followed by an example table:</p><div class="table"><a id="id2477581"></a><p class="title"><b>Table 1. An example table</b></p><div class="table-contents"><table summary="An example table" cellpadding="4px" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /></colgroup><thead valign="top"><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left" valign="top"> Option </th><th style="border-bottom: 1px solid ; " align="left" valign="top"> Description</th></tr></thead><tbody valign="top"><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left" valign="top"><p>-a <span class="emphasis"><em>USER GROUP</em></span></p></td><td style="border-bottom: 1px solid ; " align="left" valign="top"><p>Add <span class="emphasis"><em>USER</em></span> to <span class="emphasis"><em>GROUP</em></span>.</p></td></tr><tr><td style="border-right: 1px solid ; " align="left" valign="top"><p>-R <span class="emphasis"><em>GROUP</em></span></p></td><td style="" align="left" valign="top"><p>Disables access to <span class="emphasis"><em>GROUP</em></span>.</p></td></tr></tbody></table></div></div><br class="table-break" /><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="X1"></a>1.1. Sub-section with Anchor</h3></div></div></div><p>Sub-section at level 2.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="_a_nested_sub_section"></a>1.1.1. A Nested Sub-section</h4></div></div></div><p>Sub-section at level 3.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h5 class="title"><a id="_yet_another_nested_sub_section"></a>1.1.1.1. Yet another nested Sub-section</h5></div></div></div><p>Sub-section at level 4.</p><p>This is the maximum sub-section depth supported by the distributed
|
|
22
|
+
<span class="emphasis"><em>AsciiDoc</em></span> configuration.
|
|
23
|
+
<sup>[<a id="id2477762" href="#ftn.id2477762" class="footnote">2</a>]</sup></p></div></div></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="_the_second_section"></a>2. The Second Section</h2></div></div></div><p>Article sections are at level 1 and can contain sub-sections nested up
|
|
24
|
+
to four deep.</p><p>An example link to anchor at start of the <a class="link" href="#X1" title="1.1. Sub-section with Anchor">first sub-section</a>.
|
|
25
|
+
<a id="id2477898" class="indexterm"></a></p><p>An example link to a bibliography entry <a class="xref" href="#taoup">[taoup]</a>.</p></div><div class="appendix" lang="en" xml:lang="en"><h2 class="title" style="clear: both"><a id="_example_appendix"></a>A. Example Appendix</h2><p><span class="emphasis"><em>AsciiDoc</em></span> article appendices are just just article sections with
|
|
26
|
+
<span class="emphasis"><em>specialsection</em></span> titles.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="_appendix_sub_section"></a>A.1. Appendix Sub-section</h3></div></div></div><p>Appendix sub-section at level 2.</p></div></div><div class="bibliography"><div class="titlepage"><div><div><h2 class="title"><a id="_bibliography"></a>Bibliography</h2></div></div></div><p>The bibliography list is a style of <span class="emphasis"><em>AsciiDoc</em></span> bulleted list.</p><div class="bibliomixed"><a id="id2478201"></a><p class="bibliomixed">
|
|
27
|
+
<span class="bibliomisc">
|
|
28
|
+
<a id="taoup"></a>[taoup] Eric Steven Raymond. <span class="emphasis"><em>The Art of Unix
|
|
29
|
+
Programming</em></span>. Addison-Wesley. ISBN 0-13-142901-9.
|
|
30
|
+
</span>
|
|
31
|
+
</p></div><div class="bibliomixed"><a id="id2478220"></a><p class="bibliomixed">
|
|
32
|
+
<span class="bibliomisc">
|
|
33
|
+
<a id="walsh-muellner"></a>[walsh-muellner] Norman Walsh & Leonard Muellner.
|
|
34
|
+
<span class="emphasis"><em>DocBook - The Definitive Guide</em></span>. O’Reilly & Associates. 1999.
|
|
35
|
+
ISBN 1-56592-580-7.
|
|
36
|
+
</span>
|
|
37
|
+
</p></div></div><div class="glossary"><div class="titlepage"><div><div><h2 class="title"><a id="_glossary"></a>Glossary</h2></div></div></div><p>Glossaries are optional. Glossaries entries are an example of a style
|
|
38
|
+
of <span class="emphasis"><em>AsciiDoc</em></span> labeled lists.</p><dl><dt>
|
|
39
|
+
A glossary term
|
|
40
|
+
</dt><dd><p>
|
|
41
|
+
The corresponding (indented) definition.
|
|
42
|
+
</p></dd><dt>
|
|
43
|
+
A second glossary term
|
|
44
|
+
</dt><dd><p>
|
|
45
|
+
The corresponding (indented) definition.
|
|
46
|
+
</p></dd></dl></div><div class="index"><div class="titlepage"><div><div><h2 class="title"><a id="_index"></a>Index</h2></div></div></div><div class="index"><div class="indexdiv"><h3>B</h3><dl><dt>Bengal Tiger, <a class="indexterm" href="#_the_first_section">The First Section</a></dt><dt>Big cats</dt><dd><dl><dt>Lions, <a class="indexterm" href="#_the_first_section">The First Section</a></dt><dt>Tigers</dt><dd><dl><dt>Bengal Tiger, <a class="indexterm" href="#_the_first_section">The First Section</a></dt><dt>Siberian Tiger, <a class="indexterm" href="#_the_first_section">The First Section</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>E</h3><dl><dt>Example index entry, <a class="indexterm" href="#_the_first_section">The First Section</a></dt></dl></div><div class="indexdiv"><h3>L</h3><dl><dt>Lions, <a class="indexterm" href="#_the_first_section">The First Section</a></dt></dl></div><div class="indexdiv"><h3>M</h3><dl><dt>monkeys, <a class="indexterm" href="#_the_first_section">The First Section</a></dt></dl></div><div class="indexdiv"><h3>S</h3><dl><dt>Second example index entry, <a class="indexterm" href="#_the_second_section">The Second Section</a></dt><dt>Siberian Tiger, <a class="indexterm" href="#_the_first_section">The First Section</a></dt></dl></div><div class="indexdiv"><h3>T</h3><dl><dt>Tigers</dt><dd><dl><dt>Bengal Tiger, <a class="indexterm" href="#_the_first_section">The First Section</a></dt><dt>Siberian Tiger, <a class="indexterm" href="#_the_first_section">The First Section</a></dt></dl></dd></dl></div></div></div><div class="footnotes"><br /><hr width="100" align="left" /><div class="footnote"><p><sup>[<a id="ftn.id2425488" href="#id2425488" class="simpara">1</a>] </sup>An example footnote.</p></div><div class="footnote"><p><sup>[<a id="ftn.id2477762" href="#id2477762" class="simpara">2</a>] </sup>A second example footnote.</p></div></div></div></body></html>
|
|
Binary file
|
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
The Article Title
|
|
2
|
+
=================
|
|
3
|
+
Author's Name <authors@email.address>
|
|
4
|
+
v1.0, Dec 2003
|
|
5
|
+
|
|
6
|
+
|
|
7
|
+
This is the optional preamble (an untitled section body). Useful for
|
|
8
|
+
writing simple sectionless documents consisting only of a preamble.
|
|
9
|
+
|
|
10
|
+
|
|
11
|
+
Abstract
|
|
12
|
+
--------
|
|
13
|
+
The optional abstract (one or more paragraphs) goes here.
|
|
14
|
+
|
|
15
|
+
This document is an AsciiDoc article skeleton containing briefly
|
|
16
|
+
annotated element placeholders plus a couple of example index entries
|
|
17
|
+
and footnotes. The preface, appendix, bibliography, glossary and index
|
|
18
|
+
section titles are significant ('specialsections').
|
|
19
|
+
|
|
20
|
+
|
|
21
|
+
The First Section
|
|
22
|
+
-----------------
|
|
23
|
+
Article sections start at level 1 and can be nested up to four levels
|
|
24
|
+
deep.
|
|
25
|
+
footnote:[An example footnote.]
|
|
26
|
+
indexterm:[Example index entry]
|
|
27
|
+
|
|
28
|
+
And now for something completely different: ((monkeys)), lions and
|
|
29
|
+
tigers (Bengal and Siberian) using the alternative syntax index
|
|
30
|
+
entries.
|
|
31
|
+
(((Big cats,Lions)))
|
|
32
|
+
(((Big cats,Tigers,Bengal Tiger)))
|
|
33
|
+
(((Big cats,Tigers,Siberian Tiger)))
|
|
34
|
+
Note that multi-entry terms generate separate index entries.
|
|
35
|
+
|
|
36
|
+
Here are a couple of image examples: an image:images/smallnew.png[]
|
|
37
|
+
example inline image followed by an example block image:
|
|
38
|
+
|
|
39
|
+
.Tiger block image
|
|
40
|
+
image::images/tiger.png[Tiger image]
|
|
41
|
+
|
|
42
|
+
Followed by an example table:
|
|
43
|
+
|
|
44
|
+
.An example table
|
|
45
|
+
[width="60%",options="header"]
|
|
46
|
+
|==============================================
|
|
47
|
+
| Option | Description
|
|
48
|
+
| -a 'USER GROUP' | Add 'USER' to 'GROUP'.
|
|
49
|
+
| -R 'GROUP' | Disables access to 'GROUP'.
|
|
50
|
+
|==============================================
|
|
51
|
+
|
|
52
|
+
[[X1]]
|
|
53
|
+
Sub-section with Anchor
|
|
54
|
+
~~~~~~~~~~~~~~~~~~~~~~~
|
|
55
|
+
Sub-section at level 2.
|
|
56
|
+
|
|
57
|
+
A Nested Sub-section
|
|
58
|
+
^^^^^^^^^^^^^^^^^^^^
|
|
59
|
+
Sub-section at level 3.
|
|
60
|
+
|
|
61
|
+
Yet another nested Sub-section
|
|
62
|
+
++++++++++++++++++++++++++++++
|
|
63
|
+
Sub-section at level 4.
|
|
64
|
+
|
|
65
|
+
This is the maximum sub-section depth supported by the distributed
|
|
66
|
+
AsciiDoc configuration.
|
|
67
|
+
footnote:[A second example footnote.]
|
|
68
|
+
|
|
69
|
+
|
|
70
|
+
The Second Section
|
|
71
|
+
------------------
|
|
72
|
+
Article sections are at level 1 and can contain sub-sections nested up
|
|
73
|
+
to four deep.
|
|
74
|
+
|
|
75
|
+
An example link to anchor at start of the <<X1,first sub-section>>.
|
|
76
|
+
indexterm:[Second example index entry]
|
|
77
|
+
|
|
78
|
+
An example link to a bibliography entry <<taoup>>.
|
|
79
|
+
|
|
80
|
+
Appendix A: Example Appendix
|
|
81
|
+
----------------------------
|
|
82
|
+
AsciiDoc article appendices are just just article sections with
|
|
83
|
+
'specialsection' titles.
|
|
84
|
+
|
|
85
|
+
Appendix Sub-section
|
|
86
|
+
~~~~~~~~~~~~~~~~~~~~
|
|
87
|
+
Appendix sub-section at level 2.
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
Bibliography
|
|
91
|
+
------------
|
|
92
|
+
The bibliography list is a style of AsciiDoc bulleted list.
|
|
93
|
+
|
|
94
|
+
[bibliography]
|
|
95
|
+
- [[[taoup]]] Eric Steven Raymond. 'The Art of Unix
|
|
96
|
+
Programming'. Addison-Wesley. ISBN 0-13-142901-9.
|
|
97
|
+
- [[[walsh-muellner]]] Norman Walsh & Leonard Muellner.
|
|
98
|
+
'DocBook - The Definitive Guide'. O'Reilly & Associates. 1999.
|
|
99
|
+
ISBN 1-56592-580-7.
|
|
100
|
+
|
|
101
|
+
|
|
102
|
+
Glossary
|
|
103
|
+
--------
|
|
104
|
+
Glossaries are optional. Glossaries entries are an example of a style
|
|
105
|
+
of AsciiDoc labeled lists.
|
|
106
|
+
|
|
107
|
+
[glossary]
|
|
108
|
+
A glossary term::
|
|
109
|
+
The corresponding (indented) definition.
|
|
110
|
+
|
|
111
|
+
A second glossary term::
|
|
112
|
+
The corresponding (indented) definition.
|
|
113
|
+
|
|
114
|
+
|
|
115
|
+
ifdef::backend-docbook[]
|
|
116
|
+
Index
|
|
117
|
+
-----
|
|
118
|
+
////////////////////////////////////////////////////////////////
|
|
119
|
+
The index is normally left completely empty, it's contents being
|
|
120
|
+
generated automatically by the DocBook toolchain.
|
|
121
|
+
////////////////////////////////////////////////////////////////
|
|
122
|
+
endif::backend-docbook[]
|
|
@@ -0,0 +1,27 @@
|
|
|
1
|
+
<revhistory>
|
|
2
|
+
|
|
3
|
+
<revision>
|
|
4
|
+
<revnumber>6.0.0</revnumber>
|
|
5
|
+
<date>January 2005</date>
|
|
6
|
+
<authorinitials>SJR</authorinitials>
|
|
7
|
+
<revremark>
|
|
8
|
+
AsciiDoc 6.0.0 additions and changes (see the
|
|
9
|
+
<ulink url="http://www.methods.co.nz/asciidoc/CHANGELOG.html">
|
|
10
|
+
AsciiDoc CHANGELOG</ulink>
|
|
11
|
+
for a full list of changes).
|
|
12
|
+
</revremark>
|
|
13
|
+
</revision>
|
|
14
|
+
|
|
15
|
+
<revision>
|
|
16
|
+
<revnumber>5.1.1</revnumber>
|
|
17
|
+
<date>2004-10-10</date>
|
|
18
|
+
<authorinitials>SJR</authorinitials>
|
|
19
|
+
<revremark>
|
|
20
|
+
AsciiDoc 5.1.1 additions and changes (see the
|
|
21
|
+
<ulink url="http://www.methods.co.nz/asciidoc/CHANGELOG.html">
|
|
22
|
+
AsciiDoc CHANGELOG</ulink>
|
|
23
|
+
for a full list of changes).
|
|
24
|
+
</revremark>
|
|
25
|
+
</revision>
|
|
26
|
+
|
|
27
|
+
</revhistory>
|
|
@@ -0,0 +1,155 @@
|
|
|
1
|
+
.\" Title: asciidoc
|
|
2
|
+
.\" Author:
|
|
3
|
+
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
|
|
4
|
+
.\" Date: 01/02/2009
|
|
5
|
+
.\" Manual:
|
|
6
|
+
.\" Source:
|
|
7
|
+
.\"
|
|
8
|
+
.TH "ASCIIDOC" "1" "01/02/2009" "" ""
|
|
9
|
+
.\" disable hyphenation
|
|
10
|
+
.nh
|
|
11
|
+
.\" disable justification (adjust text to left margin only)
|
|
12
|
+
.ad l
|
|
13
|
+
.SH "NAME"
|
|
14
|
+
asciidoc - converts an AsciiDoc text file to DocBook, HTML or LinuxDoc
|
|
15
|
+
.SH "SYNOPSIS"
|
|
16
|
+
\fBasciidoc\fR [\fIOPTIONS\fR] \fIFILE\fR
|
|
17
|
+
.sp
|
|
18
|
+
.SH "DESCRIPTION"
|
|
19
|
+
The asciidoc(1) command translates the AsciiDoc text file \fIFILE\fR to a DocBook, HTML or LinuxDoc file\. If \fIFILE\fR is \fI\-\fR then the standard input is used\.
|
|
20
|
+
.sp
|
|
21
|
+
.SH "OPTIONS"
|
|
22
|
+
.PP
|
|
23
|
+
\fB\-a, \-\-attribute\fR=\fIATTRIBUTE\fR
|
|
24
|
+
.RS 4
|
|
25
|
+
Define or delete document attribute\.
|
|
26
|
+
\fIATTRIBUTE\fR
|
|
27
|
+
is formatted like
|
|
28
|
+
\fINAME=VALUE\fR\. Command\-line attributes take precedence over document and configuration file attributes\. Alternate acceptable forms are
|
|
29
|
+
\fINAME\fR
|
|
30
|
+
(the
|
|
31
|
+
\fIVALUE\fR
|
|
32
|
+
defaults to an empty string);
|
|
33
|
+
\fINAME!\fR
|
|
34
|
+
(delete the
|
|
35
|
+
\fINAME\fR
|
|
36
|
+
attribute);
|
|
37
|
+
\fINAME@\fR
|
|
38
|
+
(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\.
|
|
39
|
+
.RE
|
|
40
|
+
.PP
|
|
41
|
+
\fB\-b, \-\-backend\fR=\fIBACKEND\fR
|
|
42
|
+
.RS 4
|
|
43
|
+
Backend output file format:
|
|
44
|
+
\fIdocbook\fR,
|
|
45
|
+
\fIxhtml11\fR
|
|
46
|
+
or
|
|
47
|
+
\fIhtml4\fR\. Defaults to
|
|
48
|
+
\fIxhtml11\fR\.
|
|
49
|
+
.RE
|
|
50
|
+
.PP
|
|
51
|
+
\fB\-f, \-\-conf\-file\fR=\fICONF_FILE\fR
|
|
52
|
+
.RS 4
|
|
53
|
+
Use configuration file
|
|
54
|
+
\fICONF_FILE\fR\.Configuration files processed in command\-line order (after implicit configuration files)\. This option may be specified more than once\.
|
|
55
|
+
.RE
|
|
56
|
+
.PP
|
|
57
|
+
\fB\-d, \-\-doctype\fR=\fIDOCTYPE\fR
|
|
58
|
+
.RS 4
|
|
59
|
+
Document type:
|
|
60
|
+
\fIarticle\fR,
|
|
61
|
+
\fImanpage\fR
|
|
62
|
+
or
|
|
63
|
+
\fIbook\fR\. The
|
|
64
|
+
\fIbook\fR
|
|
65
|
+
document type is only supported by the
|
|
66
|
+
\fIdocbook\fR
|
|
67
|
+
backend\. Default document type is
|
|
68
|
+
\fIarticle\fR\.
|
|
69
|
+
.RE
|
|
70
|
+
.PP
|
|
71
|
+
\fB\-c, \-\-dump\-conf\fR
|
|
72
|
+
.RS 4
|
|
73
|
+
Dump configuration to stdout\.
|
|
74
|
+
.RE
|
|
75
|
+
.PP
|
|
76
|
+
\fB\-h, \-\-help\fR[=\fITOPIC\fR]
|
|
77
|
+
.RS 4
|
|
78
|
+
Print help TOPIC\.
|
|
79
|
+
\fB\-\-help\fR=\fItopics\fR
|
|
80
|
+
will print a list of help topics,
|
|
81
|
+
\fB\-\-help\fR=\fIsyntax\fR
|
|
82
|
+
summarizes AsciiDoc syntax,
|
|
83
|
+
\fB\-\-help\fR=\fImanpage\fR
|
|
84
|
+
prints the AsciiDoc manpage\.
|
|
85
|
+
.RE
|
|
86
|
+
.PP
|
|
87
|
+
\fB\-e, \-\-no\-conf\fR
|
|
88
|
+
.RS 4
|
|
89
|
+
Exclude implicitly loaded configuration files except for those named like the input file (\fIinfile\.conf\fR
|
|
90
|
+
and
|
|
91
|
+
\fIinfile\-backend\.conf\fR)\.
|
|
92
|
+
.RE
|
|
93
|
+
.PP
|
|
94
|
+
\fB\-s, \-\-no\-header\-footer\fR
|
|
95
|
+
.RS 4
|
|
96
|
+
Suppress document header and footer output\.
|
|
97
|
+
.RE
|
|
98
|
+
.PP
|
|
99
|
+
\fB\-o, \-\-out\-file\fR=\fIOUT_FILE\fR
|
|
100
|
+
.RS 4
|
|
101
|
+
Write output to file
|
|
102
|
+
\fIOUT_FILE\fR\. Defaults to the base name of input file with
|
|
103
|
+
\fIbackend\fR
|
|
104
|
+
extension\. If the input is stdin then the outfile defaults to stdout\. If
|
|
105
|
+
\fIOUT_FILE\fR
|
|
106
|
+
is
|
|
107
|
+
\fI\-\fR
|
|
108
|
+
then the standard output is used\.
|
|
109
|
+
.RE
|
|
110
|
+
.PP
|
|
111
|
+
\fB\-n, \-\-section\-numbers\fR
|
|
112
|
+
.RS 4
|
|
113
|
+
Auto\-number HTML article section titles\. Synonym for
|
|
114
|
+
\fB\-a numbered\fR\.
|
|
115
|
+
.RE
|
|
116
|
+
.PP
|
|
117
|
+
\fB\-\-unsafe\fR
|
|
118
|
+
.RS 4
|
|
119
|
+
Disable safe mode\. Safe mode is enabled by default, disabling it is potentially dangerous\.
|
|
120
|
+
.RE
|
|
121
|
+
.PP
|
|
122
|
+
\fB\-v, \-\-verbose\fR
|
|
123
|
+
.RS 4
|
|
124
|
+
Verbosely print processing information and configuration file checks to stderr\.
|
|
125
|
+
.RE
|
|
126
|
+
.PP
|
|
127
|
+
\fB\-\-version\fR
|
|
128
|
+
.RS 4
|
|
129
|
+
Print program version number\.
|
|
130
|
+
.RE
|
|
131
|
+
.SH "EXIT STATUS"
|
|
132
|
+
.PP
|
|
133
|
+
\fB0\fR
|
|
134
|
+
.RS 4
|
|
135
|
+
Success
|
|
136
|
+
.RE
|
|
137
|
+
.PP
|
|
138
|
+
\fB1\fR
|
|
139
|
+
.RS 4
|
|
140
|
+
Failure (syntax or usage error; configuration error; document processing failure; unexpected error)\.
|
|
141
|
+
.RE
|
|
142
|
+
.SH "BUGS"
|
|
143
|
+
See the AsciiDoc distribution BUGS file\.
|
|
144
|
+
.sp
|
|
145
|
+
.SH "AUTHOR"
|
|
146
|
+
Written by Stuart Rackham, <srackham@gmail\.com>
|
|
147
|
+
.sp
|
|
148
|
+
.SH "RESOURCES"
|
|
149
|
+
SourceForge: http://sourceforge\.net/projects/asciidoc/
|
|
150
|
+
.sp
|
|
151
|
+
Main web site: http://www\.methods\.co\.nz/asciidoc/
|
|
152
|
+
.sp
|
|
153
|
+
.SH "COPYING"
|
|
154
|
+
Copyright (C) 2002\-2008 Stuart Rackham\. Free use of this software is granted under the terms of the GNU General Public License (GPL)\.
|
|
155
|
+
.sp
|
|
@@ -0,0 +1,598 @@
|
|
|
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">
|
|
4
|
+
<head>
|
|
5
|
+
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
|
|
6
|
+
<meta name="generator" content="AsciiDoc 8.3.3" />
|
|
7
|
+
<title>ASCIIDOC(1)</title>
|
|
8
|
+
<style type="text/css">
|
|
9
|
+
/* Debug borders */
|
|
10
|
+
p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
|
|
11
|
+
/*
|
|
12
|
+
border: 1px solid red;
|
|
13
|
+
*/
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
body {
|
|
17
|
+
margin: 1em 5% 1em 5%;
|
|
18
|
+
}
|
|
19
|
+
|
|
20
|
+
a {
|
|
21
|
+
color: blue;
|
|
22
|
+
text-decoration: underline;
|
|
23
|
+
}
|
|
24
|
+
a:visited {
|
|
25
|
+
color: fuchsia;
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
em {
|
|
29
|
+
font-style: italic;
|
|
30
|
+
color: navy;
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
strong {
|
|
34
|
+
font-weight: bold;
|
|
35
|
+
color: #083194;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
tt {
|
|
39
|
+
color: navy;
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
h1, h2, h3, h4, h5, h6 {
|
|
43
|
+
color: #527bbd;
|
|
44
|
+
font-family: sans-serif;
|
|
45
|
+
margin-top: 1.2em;
|
|
46
|
+
margin-bottom: 0.5em;
|
|
47
|
+
line-height: 1.3;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
h1, h2, h3 {
|
|
51
|
+
border-bottom: 2px solid silver;
|
|
52
|
+
}
|
|
53
|
+
h2 {
|
|
54
|
+
padding-top: 0.5em;
|
|
55
|
+
}
|
|
56
|
+
h3 {
|
|
57
|
+
float: left;
|
|
58
|
+
}
|
|
59
|
+
h3 + * {
|
|
60
|
+
clear: left;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
div.sectionbody {
|
|
64
|
+
font-family: serif;
|
|
65
|
+
margin-left: 0;
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
hr {
|
|
69
|
+
border: 1px solid silver;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
p {
|
|
73
|
+
margin-top: 0.5em;
|
|
74
|
+
margin-bottom: 0.5em;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
ul, ol, li > p {
|
|
78
|
+
margin-top: 0;
|
|
79
|
+
}
|
|
80
|
+
|
|
81
|
+
pre {
|
|
82
|
+
padding: 0;
|
|
83
|
+
margin: 0;
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
span#author {
|
|
87
|
+
color: #527bbd;
|
|
88
|
+
font-family: sans-serif;
|
|
89
|
+
font-weight: bold;
|
|
90
|
+
font-size: 1.1em;
|
|
91
|
+
}
|
|
92
|
+
span#email {
|
|
93
|
+
}
|
|
94
|
+
span#revision {
|
|
95
|
+
font-family: sans-serif;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
div#footer {
|
|
99
|
+
font-family: sans-serif;
|
|
100
|
+
font-size: small;
|
|
101
|
+
border-top: 2px solid silver;
|
|
102
|
+
padding-top: 0.5em;
|
|
103
|
+
margin-top: 4.0em;
|
|
104
|
+
}
|
|
105
|
+
div#footer-text {
|
|
106
|
+
float: left;
|
|
107
|
+
padding-bottom: 0.5em;
|
|
108
|
+
}
|
|
109
|
+
div#footer-badges {
|
|
110
|
+
float: right;
|
|
111
|
+
padding-bottom: 0.5em;
|
|
112
|
+
}
|
|
113
|
+
|
|
114
|
+
div#preamble,
|
|
115
|
+
div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
|
|
116
|
+
div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
|
|
117
|
+
div.admonitionblock {
|
|
118
|
+
margin-right: 10%;
|
|
119
|
+
margin-top: 1.5em;
|
|
120
|
+
margin-bottom: 1.5em;
|
|
121
|
+
}
|
|
122
|
+
div.admonitionblock {
|
|
123
|
+
margin-top: 2.5em;
|
|
124
|
+
margin-bottom: 2.5em;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
div.content { /* Block element content. */
|
|
128
|
+
padding: 0;
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
/* Block element titles. */
|
|
132
|
+
div.title, caption.title {
|
|
133
|
+
color: #527bbd;
|
|
134
|
+
font-family: sans-serif;
|
|
135
|
+
font-weight: bold;
|
|
136
|
+
text-align: left;
|
|
137
|
+
margin-top: 1.0em;
|
|
138
|
+
margin-bottom: 0.5em;
|
|
139
|
+
}
|
|
140
|
+
div.title + * {
|
|
141
|
+
margin-top: 0;
|
|
142
|
+
}
|
|
143
|
+
|
|
144
|
+
td div.title:first-child {
|
|
145
|
+
margin-top: 0.0em;
|
|
146
|
+
}
|
|
147
|
+
div.content div.title:first-child {
|
|
148
|
+
margin-top: 0.0em;
|
|
149
|
+
}
|
|
150
|
+
div.content + div.title {
|
|
151
|
+
margin-top: 0.0em;
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
div.sidebarblock > div.content {
|
|
155
|
+
background: #ffffee;
|
|
156
|
+
border: 1px solid silver;
|
|
157
|
+
padding: 0.5em;
|
|
158
|
+
}
|
|
159
|
+
|
|
160
|
+
div.listingblock {
|
|
161
|
+
margin-right: 0%;
|
|
162
|
+
}
|
|
163
|
+
div.listingblock > div.content {
|
|
164
|
+
border: 1px solid silver;
|
|
165
|
+
background: #f4f4f4;
|
|
166
|
+
padding: 0.5em;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
div.quoteblock {
|
|
170
|
+
padding-left: 2.0em;
|
|
171
|
+
}
|
|
172
|
+
div.quoteblock > div.attribution {
|
|
173
|
+
padding-top: 0.5em;
|
|
174
|
+
text-align: right;
|
|
175
|
+
}
|
|
176
|
+
|
|
177
|
+
div.verseblock {
|
|
178
|
+
padding-left: 2.0em;
|
|
179
|
+
}
|
|
180
|
+
div.verseblock > div.content {
|
|
181
|
+
white-space: pre;
|
|
182
|
+
}
|
|
183
|
+
div.verseblock > div.attribution {
|
|
184
|
+
padding-top: 0.75em;
|
|
185
|
+
text-align: left;
|
|
186
|
+
}
|
|
187
|
+
/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
|
|
188
|
+
div.verseblock + div.attribution {
|
|
189
|
+
text-align: left;
|
|
190
|
+
}
|
|
191
|
+
|
|
192
|
+
div.admonitionblock .icon {
|
|
193
|
+
vertical-align: top;
|
|
194
|
+
font-size: 1.1em;
|
|
195
|
+
font-weight: bold;
|
|
196
|
+
text-decoration: underline;
|
|
197
|
+
color: #527bbd;
|
|
198
|
+
padding-right: 0.5em;
|
|
199
|
+
}
|
|
200
|
+
div.admonitionblock td.content {
|
|
201
|
+
padding-left: 0.5em;
|
|
202
|
+
border-left: 2px solid silver;
|
|
203
|
+
}
|
|
204
|
+
|
|
205
|
+
div.exampleblock > div.content {
|
|
206
|
+
border-left: 2px solid silver;
|
|
207
|
+
padding: 0.5em;
|
|
208
|
+
}
|
|
209
|
+
|
|
210
|
+
div.imageblock div.content { padding-left: 0; }
|
|
211
|
+
div.imageblock img { border: 1px solid silver; }
|
|
212
|
+
span.image img { border-style: none; }
|
|
213
|
+
|
|
214
|
+
dl {
|
|
215
|
+
margin-top: 0.8em;
|
|
216
|
+
margin-bottom: 0.8em;
|
|
217
|
+
}
|
|
218
|
+
dt {
|
|
219
|
+
margin-top: 0.5em;
|
|
220
|
+
margin-bottom: 0;
|
|
221
|
+
font-style: normal;
|
|
222
|
+
color: navy;
|
|
223
|
+
}
|
|
224
|
+
dd > *:first-child {
|
|
225
|
+
margin-top: 0.1em;
|
|
226
|
+
}
|
|
227
|
+
|
|
228
|
+
ul, ol {
|
|
229
|
+
list-style-position: outside;
|
|
230
|
+
}
|
|
231
|
+
ol.arabic {
|
|
232
|
+
list-style-type: decimal;
|
|
233
|
+
}
|
|
234
|
+
ol.loweralpha {
|
|
235
|
+
list-style-type: lower-alpha;
|
|
236
|
+
}
|
|
237
|
+
ol.upperalpha {
|
|
238
|
+
list-style-type: upper-alpha;
|
|
239
|
+
}
|
|
240
|
+
ol.lowerroman {
|
|
241
|
+
list-style-type: lower-roman;
|
|
242
|
+
}
|
|
243
|
+
ol.upperroman {
|
|
244
|
+
list-style-type: upper-roman;
|
|
245
|
+
}
|
|
246
|
+
|
|
247
|
+
div.compact ul, div.compact ol,
|
|
248
|
+
div.compact p, div.compact p,
|
|
249
|
+
div.compact div, div.compact div {
|
|
250
|
+
margin-top: 0.1em;
|
|
251
|
+
margin-bottom: 0.1em;
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
div.tableblock > table {
|
|
255
|
+
border: 3px solid #527bbd;
|
|
256
|
+
}
|
|
257
|
+
thead {
|
|
258
|
+
font-family: sans-serif;
|
|
259
|
+
font-weight: bold;
|
|
260
|
+
}
|
|
261
|
+
tfoot {
|
|
262
|
+
font-weight: bold;
|
|
263
|
+
}
|
|
264
|
+
td > div.verse {
|
|
265
|
+
white-space: pre;
|
|
266
|
+
}
|
|
267
|
+
p.table {
|
|
268
|
+
margin-top: 0;
|
|
269
|
+
}
|
|
270
|
+
/* Because the table frame attribute is overriden by CSS in most browsers. */
|
|
271
|
+
div.tableblock > table[frame="void"] {
|
|
272
|
+
border-style: none;
|
|
273
|
+
}
|
|
274
|
+
div.tableblock > table[frame="hsides"] {
|
|
275
|
+
border-left-style: none;
|
|
276
|
+
border-right-style: none;
|
|
277
|
+
}
|
|
278
|
+
div.tableblock > table[frame="vsides"] {
|
|
279
|
+
border-top-style: none;
|
|
280
|
+
border-bottom-style: none;
|
|
281
|
+
}
|
|
282
|
+
|
|
283
|
+
|
|
284
|
+
div.hdlist {
|
|
285
|
+
margin-top: 0.8em;
|
|
286
|
+
margin-bottom: 0.8em;
|
|
287
|
+
}
|
|
288
|
+
div.hdlist tr {
|
|
289
|
+
padding-bottom: 15px;
|
|
290
|
+
}
|
|
291
|
+
dt.hdlist1.strong, td.hdlist1.strong {
|
|
292
|
+
font-weight: bold;
|
|
293
|
+
}
|
|
294
|
+
td.hdlist1 {
|
|
295
|
+
vertical-align: top;
|
|
296
|
+
font-style: normal;
|
|
297
|
+
padding-right: 0.8em;
|
|
298
|
+
color: navy;
|
|
299
|
+
}
|
|
300
|
+
td.hdlist2 {
|
|
301
|
+
vertical-align: top;
|
|
302
|
+
}
|
|
303
|
+
div.hdlist.compact tr {
|
|
304
|
+
margin: 0;
|
|
305
|
+
padding-bottom: 0;
|
|
306
|
+
}
|
|
307
|
+
|
|
308
|
+
@media print {
|
|
309
|
+
div#footer-badges { display: none; }
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
div#toctitle {
|
|
313
|
+
color: #527bbd;
|
|
314
|
+
font-family: sans-serif;
|
|
315
|
+
font-size: 1.1em;
|
|
316
|
+
font-weight: bold;
|
|
317
|
+
margin-top: 1.0em;
|
|
318
|
+
margin-bottom: 0.1em;
|
|
319
|
+
}
|
|
320
|
+
|
|
321
|
+
div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
|
|
322
|
+
margin-top: 0;
|
|
323
|
+
margin-bottom: 0;
|
|
324
|
+
}
|
|
325
|
+
div.toclevel2 {
|
|
326
|
+
margin-left: 2em;
|
|
327
|
+
font-size: 0.9em;
|
|
328
|
+
}
|
|
329
|
+
div.toclevel3 {
|
|
330
|
+
margin-left: 4em;
|
|
331
|
+
font-size: 0.9em;
|
|
332
|
+
}
|
|
333
|
+
div.toclevel4 {
|
|
334
|
+
margin-left: 6em;
|
|
335
|
+
font-size: 0.9em;
|
|
336
|
+
}
|
|
337
|
+
/* Overrides for manpage documents */
|
|
338
|
+
h1 {
|
|
339
|
+
padding-top: 0.5em;
|
|
340
|
+
padding-bottom: 0.5em;
|
|
341
|
+
border-top: 2px solid silver;
|
|
342
|
+
border-bottom: 2px solid silver;
|
|
343
|
+
}
|
|
344
|
+
h2 {
|
|
345
|
+
border-style: none;
|
|
346
|
+
}
|
|
347
|
+
div.sectionbody {
|
|
348
|
+
margin-left: 5%;
|
|
349
|
+
}
|
|
350
|
+
|
|
351
|
+
@media print {
|
|
352
|
+
div#toc { display: none; }
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
/* Workarounds for IE6's broken and incomplete CSS2. */
|
|
356
|
+
|
|
357
|
+
div.sidebar-content {
|
|
358
|
+
background: #ffffee;
|
|
359
|
+
border: 1px solid silver;
|
|
360
|
+
padding: 0.5em;
|
|
361
|
+
}
|
|
362
|
+
div.sidebar-title, div.image-title {
|
|
363
|
+
color: #527bbd;
|
|
364
|
+
font-family: sans-serif;
|
|
365
|
+
font-weight: bold;
|
|
366
|
+
margin-top: 0.0em;
|
|
367
|
+
margin-bottom: 0.5em;
|
|
368
|
+
}
|
|
369
|
+
|
|
370
|
+
div.listingblock div.content {
|
|
371
|
+
border: 1px solid silver;
|
|
372
|
+
background: #f4f4f4;
|
|
373
|
+
padding: 0.5em;
|
|
374
|
+
}
|
|
375
|
+
|
|
376
|
+
div.quoteblock-attribution {
|
|
377
|
+
padding-top: 0.5em;
|
|
378
|
+
text-align: right;
|
|
379
|
+
}
|
|
380
|
+
|
|
381
|
+
div.verseblock-content {
|
|
382
|
+
white-space: pre;
|
|
383
|
+
}
|
|
384
|
+
div.verseblock-attribution {
|
|
385
|
+
padding-top: 0.75em;
|
|
386
|
+
text-align: left;
|
|
387
|
+
}
|
|
388
|
+
|
|
389
|
+
div.exampleblock-content {
|
|
390
|
+
border-left: 2px solid silver;
|
|
391
|
+
padding-left: 0.5em;
|
|
392
|
+
}
|
|
393
|
+
|
|
394
|
+
/* IE6 sets dynamically generated links as visited. */
|
|
395
|
+
div#toc a:visited { color: blue; }
|
|
396
|
+
</style>
|
|
397
|
+
</head>
|
|
398
|
+
<body>
|
|
399
|
+
<div id="header">
|
|
400
|
+
<h1>
|
|
401
|
+
ASCIIDOC(1) Manual Page
|
|
402
|
+
</h1>
|
|
403
|
+
<h2>NAME</h2>
|
|
404
|
+
<div class="sectionbody">
|
|
405
|
+
<p>asciidoc -
|
|
406
|
+
converts an AsciiDoc text file to DocBook, HTML or LinuxDoc
|
|
407
|
+
</p>
|
|
408
|
+
</div>
|
|
409
|
+
</div>
|
|
410
|
+
<h2>SYNOPSIS</h2>
|
|
411
|
+
<div class="sectionbody">
|
|
412
|
+
<div class="paragraph"><p><strong>asciidoc</strong> [<em>OPTIONS</em>] <em>FILE</em></p></div>
|
|
413
|
+
</div>
|
|
414
|
+
<h2 id="_description">DESCRIPTION</h2>
|
|
415
|
+
<div class="sectionbody">
|
|
416
|
+
<div class="paragraph"><p>The asciidoc(1) command translates the AsciiDoc text file <em>FILE</em> to a
|
|
417
|
+
DocBook, HTML or LinuxDoc file. If <em>FILE</em> is <em>-</em> then the standard
|
|
418
|
+
input is used.</p></div>
|
|
419
|
+
</div>
|
|
420
|
+
<h2 id="_options">OPTIONS</h2>
|
|
421
|
+
<div class="sectionbody">
|
|
422
|
+
<div class="dlist"><dl>
|
|
423
|
+
<dt class="hdlist1">
|
|
424
|
+
<strong>-a, --attribute</strong>=<em>ATTRIBUTE</em>
|
|
425
|
+
</dt>
|
|
426
|
+
<dd>
|
|
427
|
+
<p>
|
|
428
|
+
Define or delete document attribute. <em>ATTRIBUTE</em> is formatted like
|
|
429
|
+
<em>NAME=VALUE</em>. Command-line attributes take precedence over
|
|
430
|
+
document and configuration file attributes. Alternate acceptable
|
|
431
|
+
forms are <em>NAME</em> (the <em>VALUE</em> defaults to an empty string);
|
|
432
|
+
<em>NAME!</em> (delete the <em>NAME</em> attribute); <em>NAME@</em> (do not override
|
|
433
|
+
document or configuration file attributes). Values containing
|
|
434
|
+
spaces should be enclosed in double-quote characters. This option
|
|
435
|
+
may be specified more than once.
|
|
436
|
+
</p>
|
|
437
|
+
</dd>
|
|
438
|
+
<dt class="hdlist1">
|
|
439
|
+
<strong>-b, --backend</strong>=<em>BACKEND</em>
|
|
440
|
+
</dt>
|
|
441
|
+
<dd>
|
|
442
|
+
<p>
|
|
443
|
+
Backend output file format: <em>docbook</em>, <em>xhtml11</em> or <em>html4</em>.
|
|
444
|
+
Defaults to <em>xhtml11</em>.
|
|
445
|
+
</p>
|
|
446
|
+
</dd>
|
|
447
|
+
<dt class="hdlist1">
|
|
448
|
+
<strong>-f, --conf-file</strong>=<em>CONF_FILE</em>
|
|
449
|
+
</dt>
|
|
450
|
+
<dd>
|
|
451
|
+
<p>
|
|
452
|
+
Use configuration file <em>CONF_FILE</em>.Configuration files processed
|
|
453
|
+
in command-line order (after implicit configuration files). This
|
|
454
|
+
option may be specified more than once.
|
|
455
|
+
</p>
|
|
456
|
+
</dd>
|
|
457
|
+
<dt class="hdlist1">
|
|
458
|
+
<strong>-d, --doctype</strong>=<em>DOCTYPE</em>
|
|
459
|
+
</dt>
|
|
460
|
+
<dd>
|
|
461
|
+
<p>
|
|
462
|
+
Document type: <em>article</em>, <em>manpage</em> or <em>book</em>. The <em>book</em> document
|
|
463
|
+
type is only supported by the <em>docbook</em> backend. Default document
|
|
464
|
+
type is <em>article</em>.
|
|
465
|
+
</p>
|
|
466
|
+
</dd>
|
|
467
|
+
<dt class="hdlist1">
|
|
468
|
+
<strong>-c, --dump-conf</strong>
|
|
469
|
+
</dt>
|
|
470
|
+
<dd>
|
|
471
|
+
<p>
|
|
472
|
+
Dump configuration to stdout.
|
|
473
|
+
</p>
|
|
474
|
+
</dd>
|
|
475
|
+
<dt class="hdlist1">
|
|
476
|
+
<strong>-h, --help</strong>[=<em>TOPIC</em>]
|
|
477
|
+
</dt>
|
|
478
|
+
<dd>
|
|
479
|
+
<p>
|
|
480
|
+
Print help TOPIC. <strong>--help</strong>=<em>topics</em> will print a list of help
|
|
481
|
+
topics, <strong>--help</strong>=<em>syntax</em> summarizes AsciiDoc syntax,
|
|
482
|
+
<strong>--help</strong>=<em>manpage</em> prints the AsciiDoc manpage.
|
|
483
|
+
</p>
|
|
484
|
+
</dd>
|
|
485
|
+
<dt class="hdlist1">
|
|
486
|
+
<strong>-e, --no-conf</strong>
|
|
487
|
+
</dt>
|
|
488
|
+
<dd>
|
|
489
|
+
<p>
|
|
490
|
+
Exclude implicitly loaded configuration files except for those
|
|
491
|
+
named like the input file (<em>infile.conf</em> and
|
|
492
|
+
<em>infile-backend.conf</em>).
|
|
493
|
+
</p>
|
|
494
|
+
</dd>
|
|
495
|
+
<dt class="hdlist1">
|
|
496
|
+
<strong>-s, --no-header-footer</strong>
|
|
497
|
+
</dt>
|
|
498
|
+
<dd>
|
|
499
|
+
<p>
|
|
500
|
+
Suppress document header and footer output.
|
|
501
|
+
</p>
|
|
502
|
+
</dd>
|
|
503
|
+
<dt class="hdlist1">
|
|
504
|
+
<strong>-o, --out-file</strong>=<em>OUT_FILE</em>
|
|
505
|
+
</dt>
|
|
506
|
+
<dd>
|
|
507
|
+
<p>
|
|
508
|
+
Write output to file <em>OUT_FILE</em>. Defaults to the base name of
|
|
509
|
+
input file with <em>backend</em> extension. If the input is stdin then
|
|
510
|
+
the outfile defaults to stdout. If <em>OUT_FILE</em> is <em>-</em> then the
|
|
511
|
+
standard output is used.
|
|
512
|
+
</p>
|
|
513
|
+
</dd>
|
|
514
|
+
<dt class="hdlist1">
|
|
515
|
+
<strong>-n, --section-numbers</strong>
|
|
516
|
+
</dt>
|
|
517
|
+
<dd>
|
|
518
|
+
<p>
|
|
519
|
+
Auto-number HTML article section titles. Synonym for <strong>-a
|
|
520
|
+
numbered</strong>.
|
|
521
|
+
</p>
|
|
522
|
+
</dd>
|
|
523
|
+
<dt class="hdlist1">
|
|
524
|
+
<strong>--unsafe</strong>
|
|
525
|
+
</dt>
|
|
526
|
+
<dd>
|
|
527
|
+
<p>
|
|
528
|
+
Disable safe mode. Safe mode is enabled by default, disabling
|
|
529
|
+
it is potentially dangerous.
|
|
530
|
+
</p>
|
|
531
|
+
</dd>
|
|
532
|
+
<dt class="hdlist1">
|
|
533
|
+
<strong>-v, --verbose</strong>
|
|
534
|
+
</dt>
|
|
535
|
+
<dd>
|
|
536
|
+
<p>
|
|
537
|
+
Verbosely print processing information and configuration file
|
|
538
|
+
checks to stderr.
|
|
539
|
+
</p>
|
|
540
|
+
</dd>
|
|
541
|
+
<dt class="hdlist1">
|
|
542
|
+
<strong>--version</strong>
|
|
543
|
+
</dt>
|
|
544
|
+
<dd>
|
|
545
|
+
<p>
|
|
546
|
+
Print program version number.
|
|
547
|
+
</p>
|
|
548
|
+
</dd>
|
|
549
|
+
</dl></div>
|
|
550
|
+
</div>
|
|
551
|
+
<h2 id="_exit_status">EXIT STATUS</h2>
|
|
552
|
+
<div class="sectionbody">
|
|
553
|
+
<div class="dlist"><dl>
|
|
554
|
+
<dt class="hdlist1">
|
|
555
|
+
<strong>0</strong>
|
|
556
|
+
</dt>
|
|
557
|
+
<dd>
|
|
558
|
+
<p>
|
|
559
|
+
Success
|
|
560
|
+
</p>
|
|
561
|
+
</dd>
|
|
562
|
+
<dt class="hdlist1">
|
|
563
|
+
<strong>1</strong>
|
|
564
|
+
</dt>
|
|
565
|
+
<dd>
|
|
566
|
+
<p>
|
|
567
|
+
Failure (syntax or usage error; configuration error; document
|
|
568
|
+
processing failure; unexpected error).
|
|
569
|
+
</p>
|
|
570
|
+
</dd>
|
|
571
|
+
</dl></div>
|
|
572
|
+
</div>
|
|
573
|
+
<h2 id="_bugs">BUGS</h2>
|
|
574
|
+
<div class="sectionbody">
|
|
575
|
+
<div class="paragraph"><p>See the AsciiDoc distribution BUGS file.</p></div>
|
|
576
|
+
</div>
|
|
577
|
+
<h2 id="_author">AUTHOR</h2>
|
|
578
|
+
<div class="sectionbody">
|
|
579
|
+
<div class="paragraph"><p>Written by Stuart Rackham, <<a href="mailto:srackham@gmail.com">srackham@gmail.com</a>></p></div>
|
|
580
|
+
</div>
|
|
581
|
+
<h2 id="_resources">RESOURCES</h2>
|
|
582
|
+
<div class="sectionbody">
|
|
583
|
+
<div class="paragraph"><p>SourceForge: <a href="http://sourceforge.net/projects/asciidoc/">http://sourceforge.net/projects/asciidoc/</a></p></div>
|
|
584
|
+
<div class="paragraph"><p>Main web site: <a href="http://www.methods.co.nz/asciidoc/">http://www.methods.co.nz/asciidoc/</a></p></div>
|
|
585
|
+
</div>
|
|
586
|
+
<h2 id="_copying">COPYING</h2>
|
|
587
|
+
<div class="sectionbody">
|
|
588
|
+
<div class="paragraph"><p>Copyright (C) 2002-2008 Stuart Rackham. Free use of this software is
|
|
589
|
+
granted under the terms of the GNU General Public License (GPL).</p></div>
|
|
590
|
+
</div>
|
|
591
|
+
<div id="footer">
|
|
592
|
+
<div id="footer-text">
|
|
593
|
+
Version 8.3.3<br />
|
|
594
|
+
Last updated 2009-01-02 12:45:00 NZDT
|
|
595
|
+
</div>
|
|
596
|
+
</div>
|
|
597
|
+
</body>
|
|
598
|
+
</html>
|