RubyGems - git-scribe - Versions diffs - 0.0.4 → 0.0.5 - Mend

git-scribe 0.0.4 → 0.0.5

Files changed (151) hide show

data/.gitignore +1 -0
data/Rakefile +31 -0
data/SPEC.asciidoc +126 -0
data/TODO.txt +29 -0
data/bin/git-scribe +2 -1
data/docbook-xsl/.CatalogManager.properties.example +61 -0
data/docbook-xsl/.urilist +1 -0
data/git-scribe.gemspec +32 -0
data/lib/git-scribe.rb +21 -315
data/lib/git-scribe/check.rb +60 -0
data/lib/git-scribe/cli.rb +84 -0
data/lib/git-scribe/generate.rb +222 -0
data/lib/git-scribe/init.rb +16 -0
data/lib/git-scribe/version.rb +3 -0
data/template/.gitignore +1 -0
data/template/.gitscribe +5 -0
data/test/check_test.rb +12 -0
data/test/gen_test.rb +78 -0
data/test/init_test.rb +36 -0
data/test/test_helper.rb +44 -0
metadata +49 -161
data/example/book/big.asc +0 -5604
data/example/book/holmes.asc +0 -12983
data/example/output/META-INF/container.xml +0 -6
data/example/output/OEBPS/ar01s02.html +0 -15
data/example/output/OEBPS/ar01s03.html +0 -3
data/example/output/OEBPS/content.opf +0 -21
data/example/output/OEBPS/index.html +0 -5
data/example/output/OEBPS/toc.ncx +0 -37
data/example/output/a_case_of_identity.html +0 -725
data/example/output/a_example_appendix.html +0 -63
data/example/output/a_migration_notes.html +0 -95
data/example/output/apa.html +0 -20
data/example/output/apb.html +0 -6
data/example/output/apc.html +0 -24
data/example/output/apd.html +0 -30
data/example/output/ape.html +0 -26
data/example/output/apf.html +0 -9
data/example/output/apg.html +0 -42
data/example/output/aph.html +0 -89
data/example/output/ar01s02.html +0 -12
data/example/output/ar01s03.html +0 -34
data/example/output/ar01s04.html +0 -77
data/example/output/ar01s05.html +0 -272
data/example/output/ar01s06.html +0 -35
data/example/output/ar01s07.html +0 -105
data/example/output/ar01s08.html +0 -33
data/example/output/ar01s09.html +0 -12
data/example/output/ar01s10.html +0 -14
data/example/output/ar01s11.html +0 -34
data/example/output/ar01s12.html +0 -63
data/example/output/ar01s13.html +0 -156
data/example/output/ar01s14.html +0 -330
data/example/output/ar01s15.html +0 -22
data/example/output/ar01s16.html +0 -27
data/example/output/ar01s17.html +0 -94
data/example/output/ar01s18.html +0 -359
data/example/output/ar01s19.html +0 -373
data/example/output/ar01s20.html +0 -27
data/example/output/ar01s21.html +0 -33
data/example/output/ar01s22.html +0 -351
data/example/output/ar01s23.html +0 -21
data/example/output/ar01s24.html +0 -69
data/example/output/ar01s25.html +0 -60
data/example/output/ar01s26.html +0 -217
data/example/output/ar01s27.html +0 -88
data/example/output/ar01s28.html +0 -237
data/example/output/ar01s29.html +0 -68
data/example/output/ar01s30.html +0 -154
data/example/output/ar01s31.html +0 -6
data/example/output/ar01s32.html +0 -22
data/example/output/ar01s33.html +0 -209
data/example/output/asciidoc_backends.html +0 -190
data/example/output/asciidoc_document_types.html +0 -131
data/example/output/attribute_entries.html +0 -185
data/example/output/attribute_lists.html +0 -157
data/example/output/attribute_references.html +0 -414
data/example/output/attributelist_element.html +0 -143
data/example/output/b_packager_notes.html +0 -68
data/example/output/bi01.html +0 -18
data/example/output/big.asc +0 -5604
data/example/output/block_element_definitions.html +0 -448
data/example/output/block_titles.html +0 -83
data/example/output/blockid_element.html +0 -80
data/example/output/book.asc +0 -5604
data/example/output/book.epub +0 -0
data/example/output/book.fo +0 -3788
data/example/output/book.html +0 -8793
data/example/output/book.xml +0 -8265
data/example/output/c_asciidoc_safe_mode.html +0 -105
data/example/output/callouts.html +0 -214
data/example/output/catalog +0 -10
data/example/output/colophon.html +0 -397
data/example/output/configuration_files.html +0 -672
data/example/output/converting_docbook_to_other_file_formats.html +0 -324
data/example/output/d_using_asciidoc_with_non-english_languages.html +0 -107
data/example/output/delimited_blocks.html +0 -455
data/example/output/document_attributes.html +0 -95
data/example/output/document_processing.html +0 -116
data/example/output/document_structure.html +0 -493
data/example/output/e_vim_syntax_highlighter.html +0 -111
data/example/output/example_bibliography.html +0 -82
data/example/output/example_colophon.html +0 -58
data/example/output/example_glossary.html +0 -73
data/example/output/example_index.html +0 -108
data/example/output/f_attribute_options.html +0 -129
data/example/output/filters.html +0 -179
data/example/output/footnotes.html +0 -103
data/example/output/g_diagnostics.html +0 -148
data/example/output/generating_plain_text_files.html +0 -68
data/example/output/getting_started.html +0 -87
data/example/output/glossary.html +0 -95
data/example/output/go01.html +0 -24
data/example/output/h_backend_attributes.html +0 -308
data/example/output/help_commands.html +0 -96
data/example/output/holmes.asc +0 -12983
data/example/output/image/octocat_professor.png +0 -0
data/example/output/include/hello.c +0 -10
data/example/output/index.html +0 -656
data/example/output/indexes.html +0 -104
data/example/output/intrinsic_attributes.html +0 -165
data/example/output/ix01.html +0 -3
data/example/output/lists.html +0 -666
data/example/output/macros.html +0 -737
data/example/output/manpage_documents.html +0 -124
data/example/output/master.css +0 -281
data/example/output/mathematical_formulas.html +0 -125
data/example/output/page.html +0 -60
data/example/output/paragraphs.html +0 -192
data/example/output/pr01.html +0 -3
data/example/output/source_code_highlighting.html +0 -59
data/example/output/stylesheets/handbookish-quirks.css +0 -0
data/example/output/stylesheets/handbookish.css +0 -233
data/example/output/tables.html +0 -797
data/example/output/text_formatting.html +0 -273
data/example/output/the_adventure_of_the_beryl_coronet.html +0 -968
data/example/output/the_adventure_of_the_blue_carbuncle.html +0 -825
data/example/output/the_adventure_of_the_copper_beeches.html +0 -998
data/example/output/the_adventure_of_the_engineer_s_thumb.html +0 -851
data/example/output/the_adventure_of_the_noble_bachelor.html +0 -861
data/example/output/the_adventure_of_the_speckled_band.html +0 -1015
data/example/output/the_boscombe_valley_mystery.html +0 -974
data/example/output/the_first_chapter.html +0 -110
data/example/output/the_five_orange_pips.html +0 -776
data/example/output/the_man_with_the_twisted_lip.html +0 -946
data/example/output/the_red-headed_league.html +0 -950
data/example/output/the_second_chapter.html +0 -95
data/example/output/the_third_chapter.html +0 -58
data/example/output/tips_and_tricks.html +0 -452
data/example/output/title.html +0 -120
data/example/output/titles.html +0 -126

data/example/output/indexes.html DELETED Viewed

@@ -1,104 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-    <link rel="stylesheet" href="master.css" type="text/css" />
-    <title>Indexes</title>
-  </head>
-  <body>
-    <div class="nav" id="navheader">
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="footnotes.html">Prev</a><br/>
-         Footnotes
-      </td><td width="33%" align="center">
-         <a href="index.html">Home</a><br/>
-         <strong>AsciiDoc User Guide</strong>
-      </td><td width="33%" align="right">
-          <a href="callouts.html">Next</a><br/>
-          Callouts
-      </td></tr>
-    </table>
-    </div>
-    <hr/>
-    <div class="content">
-      <div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a id="_indexes"></a>Indexes</h2></div></div></div>
-<p>The shipped AsciiDoc configuration includes the inline macros for
-generating DocBook index entries.</p>
-<div class="variablelist"><dl>
-<dt>
-<span class="term">
-<code class="literal">indexterm:[&lt;primary&gt;,&lt;secondary&gt;,&lt;tertiary&gt;]</code>
-, </span><span class="term">
-<code class="literal">(((&lt;primary&gt;,&lt;secondary&gt;,&lt;tertiary&gt;)))</code>
-</span>
-</dt>
-<dd>
-    This inline macro generates an index term (the <code class="literal">&lt;secondary&gt;</code> and
-    <code class="literal">&lt;tertiary&gt;</code> positional attributes are optional). Example:
-    <code class="literal">indexterm:[Tigers,Big cats]</code> (or, using the alternative syntax
-    <code class="literal">(((Tigers,Big cats)))</code>.  Index terms that have secondary and
-    tertiary entries also generate separate index terms for the
-    secondary and tertiary entries. The index terms appear in the
-    index, not the primary text flow.
-</dd>
-<dt>
-<span class="term">
-<code class="literal">indexterm2:[&lt;primary&gt;]</code>
-, </span><span class="term">
-<code class="literal">((&lt;primary&gt;))</code>
-</span>
-</dt>
-<dd>
-    This inline macro generates an index term that appears in both the
-    index and the primary text flow.  The <code class="literal">&lt;primary&gt;</code> should not be
-    padded to the left or right with white space characters.
-</dd>
-</dl></div>
-<p>For working examples see the <code class="literal">article.txt</code> and <code class="literal">book.txt</code> documents in
-the AsciiDoc <code class="literal">./doc</code> distribution directory.</p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Note</h3>
-<p>Index entries only really make sense if you are generating
-DocBook markup — DocBook conversion programs automatically generate
-an index at the point an <span class="emphasis"><em>Index</em></span> section appears in source document.</p>
-</div>
-</div>
-    </div>
-    <hr/>
-    <div class="nav" id="navfooter">
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="footnotes.html">Prev</a><br/>
-         Footnotes
-      </td><td width="33%" align="center">
-         <a href="index.html">Home</a><br/>
-         AsciiDoc User Guide
-      </td><td width="33%" align="right">
-          <a href="callouts.html">Next</a><br/>
-          Callouts
-      </td></tr>
-    </table>
-    </div>
-  </body>
-</html>

data/example/output/intrinsic_attributes.html DELETED Viewed

@@ -1,165 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-    <link rel="stylesheet" href="master.css" type="text/css" />
-    <title>Intrinsic Attributes</title>
-  </head>
-  <body>
-    <div class="nav" id="navheader">
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="attribute_references.html">Prev</a><br/>
-         Attribute References
-      </td><td width="33%" align="center">
-         <a href="index.html">Home</a><br/>
-         <strong>AsciiDoc User Guide</strong>
-      </td><td width="33%" align="right">
-          <a href="block_element_definitions.html">Next</a><br/>
-          Block Element Definitions
-      </td></tr>
-    </table>
-    </div>
-    <hr/>
-    <div class="content">
-      <div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a id="X60"></a>Intrinsic Attributes</h2></div></div></div>
-<p>Intrinsic attributes are simple attributes that are created
-automatically from: AsciiDoc document header parameters; asciidoc(1)
-command-line arguments; attributes defined in the default
-configuration files; the execution context.  Here’s the list of
-predefined intrinsic attributes:</p>
-<pre class="literallayout">{amp}                 ampersand (&amp;) character entity
-{asciidoc-dir}        the asciidoc(1) application directory
-{asciidoc-file}       the full path name of the asciidoc(1) script
-{asciidoc-version}    the version of asciidoc(1)
-{author}              author's full name
-{authored}            empty string '' if {author} or {email} defined,
-{authorinitials}      author initials (from document header)
-{backend-&lt;backend&gt;}   empty string ''
-{&lt;backend&gt;-&lt;doctype&gt;} empty string ''
-{backend}             document backend specified by `-b` option
-{backslash}           backslash character
-{basebackend-&lt;base&gt;}  empty string ''
-{basebackend}         html or docbook
-{brvbar}              broken vertical bar (|) character
-{revdate}             document revision date (from document header)
-{docdate}             document last modified date
-{doctime}             document last modified time
-{docname}             document file name without extension
-{docfile}             document file name  (note 5)
-{docdir}              document input directory name  (note 5)
-{doctitle}            document title (from document header)
-{doctype-&lt;doctype&gt;}   empty string ''
-{doctype}             document type specified by `-d` option
-{email}               author's email address (from document header)
-{empty}               empty string ''
-{encoding}            specifies input and output encoding
-{filetype-&lt;fileext&gt;}  empty string ''
-{filetype}            output file name file extension
-{firstname}           author first name (from document header)
-{gt}                  greater than (&gt;) character entity
-{id}                  running block id generated by BlockId elements
-{indir}               input file directory name (note 2,5)
-{infile}              input file name (note 2,5)
-{lastname}            author last name (from document header)
-{level}               title level 1..4 (in section titles)
-{listindex}           the list index (1..) of the most recent list item
-{localdate}           the current date
-{localtime}           the current time
-{lt}                  less than (&lt;) character entity
-{manname}             manpage name (defined in NAME section)
-{manpurpose}          manpage (defined in NAME section)
-{mantitle}            document title minus the manpage volume number
-{manvolnum}           manpage volume number (1..8) (from document header)
-{middlename}          author middle name (from document header)
-{nbsp}                non-breaking space character entity
-{notitle}             do not display the document title
-{outdir}              document output directory name (note 2)
-{outfile}             output file name (note 2)
-{reftext}             running block xreflabel generated by BlockId elements
-{revnumber}           document revision number (from document header)
-{sectnum}             formatted section number (in section titles)
-{showcomments}        send comment lines to the output
-{title}               section title (in titled elements)
-{two-colons}          Two colon characters
-{two-semicolons}      Two semicolon characters
-{user-dir}            the ~/.asciidoc directory (if it exists)
-{verbose}             defined as '' if --verbose command option specified
-{zwsp}                Zero-width space character entity</pre>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Note</h3>
-<div class="orderedlist"><ol type="1">
-<li>
-Intrinsic attributes are global so avoid defining custom attributes
-   with the same names.
-</li>
-<li>
-<code class="literal">{outfile}</code>, <code class="literal">{outdir}</code>, <code class="literal">{infile}</code>, <code class="literal">{indir}</code> attributes are
-   effectively read-only (you can set them but it won’t affect the
-   input or output file paths).
-</li>
-<li>
-See also the <a class="link" href="h_backend_attributes.html" title="H. Backend Attributes">Backend Attributes</a> section for attributes
-    that relate to AsciiDoc XHTML file generation.
-</li>
-<li>
-The entries that translate to blank strings are designed to be used
-   for conditional text inclusion. You can also use the <code class="literal">ifdef</code>,
-   <code class="literal">ifndef</code> and <code class="literal">endif</code> System macros for conditional inclusion.
-   <sup>[<a id="id36128467" href="#ftn.id36128467" class="footnote">4</a>]</sup>
-</li>
-<li>
-<code class="literal">{docfile}</code> and <code class="literal">{docdir}</code> refer to root document specified on
-   the asciidoc(1) command-line; <code class="literal">{infile}</code> and <code class="literal">{indir}</code> refer to
-   the current input file which may be the root document or an
-   included file. When the input is being read from the standard
-   input (<code class="literal">stdin</code>) these attributes are undefined.
-</li>
-</ol></div>
-</div>
-<div class="footnotes">
-<br><hr width="100" align="left">
-<div class="footnote"><p><sup>[<a id="ftn.id36128467" href="#id36128467" class="simpara">4</a>] </sup>Conditional inclusion using <code class="literal">ifdef</code> and <code class="literal">ifndef</code> macros
-   differs from attribute conditional inclusion in that the former
-   occurs when the file is read while the latter occurs when the
-   contents are written.</p></div>
-</div>
-</div>
-    </div>
-    <hr/>
-    <div class="nav" id="navfooter">
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="attribute_references.html">Prev</a><br/>
-         Attribute References
-      </td><td width="33%" align="center">
-         <a href="index.html">Home</a><br/>
-         AsciiDoc User Guide
-      </td><td width="33%" align="right">
-          <a href="block_element_definitions.html">Next</a><br/>
-          Block Element Definitions
-      </td></tr>
-    </table>
-    </div>
-  </body>
-</html>

data/example/output/ix01.html DELETED Viewed

@@ -1,3 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>Example Index</title><link rel="stylesheet" href="stylesheets/handbookish.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.74.1" /><link rel="home" href="index.html" title="Book Title Goes Here" /><link rel="up" href="index.html" title="Book Title Goes Here" /><link rel="prev" href="ar01s05.html" title="Example Colophon" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Example Index</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ar01s05.html">Prev</a> </td><th width="60%" align="center"> </th><td width="20%" align="right"> </td></tr></table><hr /></div><div class="index"><div class="titlepage"><div><div><h2 class="title"><a id="_example_index"></a>Example Index</h2></div></div></div><div class="index"><div class="indexdiv"><h3>B</h3><dl><dt>Bengal Tiger, <a class="indexterm" href="ar01s02.html">The First Chapter</a></dt><dt>Big cats</dt><dd><dl><dt>Lions, <a class="indexterm" href="ar01s02.html">The First Chapter</a></dt><dt>Tigers</dt><dd><dl><dt>Bengal Tiger, <a class="indexterm" href="ar01s02.html">The First Chapter</a></dt><dt>Siberian Tiger, <a class="indexterm" href="ar01s02.html">The First Chapter</a></dt></dl></dd></dl></dd></dl></div><div class="indexdiv"><h3>E</h3><dl><dt>Example index entry, <a class="indexterm" href="ar01s02.html">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>L</h3><dl><dt>Lions, <a class="indexterm" href="ar01s02.html">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>M</h3><dl><dt>monkeys, <a class="indexterm" href="ar01s02.html">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>S</h3><dl><dt>Second example index entry, <a class="indexterm" href="ar01s03.html">The Second Chapter</a></dt><dt>Siberian Tiger, <a class="indexterm" href="ar01s02.html">The First Chapter</a></dt></dl></div><div class="indexdiv"><h3>T</h3><dl><dt>Tigers</dt><dd><dl><dt>Bengal Tiger, <a class="indexterm" href="ar01s02.html">The First Chapter</a></dt><dt>Siberian Tiger, <a class="indexterm" href="ar01s02.html">The First Chapter</a></dt></dl></dd></dl></div></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ar01s05.html">Prev</a> </td><td width="20%" align="center"> </td><td width="40%" align="right"> </td></tr><tr><td width="40%" align="left" valign="top">Example Colophon </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> </td></tr></table></div></body></html>

data/example/output/lists.html DELETED Viewed

@@ -1,666 +0,0 @@
-<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-<html xmlns="http://www.w3.org/1999/xhtml">
-  <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
-    <link rel="stylesheet" href="master.css" type="text/css" />
-    <title>Lists</title>
-  </head>
-  <body>
-    <div class="nav" id="navheader">
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="delimited_blocks.html">Prev</a><br/>
-         Delimited Blocks
-      </td><td width="33%" align="center">
-         <a href="index.html">Home</a><br/>
-         <strong>AsciiDoc User Guide</strong>
-      </td><td width="33%" align="right">
-          <a href="footnotes.html">Next</a><br/>
-          Footnotes
-      </td></tr>
-    </table>
-    </div>
-    <hr/>
-    <div class="content">
-      <div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a id="X64"></a>Lists</h2></div></div></div>
-<div class="itemizedlist">
-<p class="title"><b>List types</b></p>
-<ul type="disc">
-<li>
-Bulleted lists. Also known as itemized or unordered lists.
-</li>
-<li>
-Numbered lists. Also called ordered lists.
-</li>
-<li>
-Labeled lists. Sometimes called variable or definition lists.
-</li>
-<li>
-Callout lists (a list of callout annotations).
-</li>
-</ul>
-</div>
-<div class="itemizedlist">
-<p class="title"><b>List behavior</b></p>
-<ul type="disc">
-<li>
-List item indentation is optional and does not determine nesting,
-  indentation does however make the source more readable.
-</li>
-<li>
-Another list or a literal paragraph immediately following a list
-  item will be implicitly included in the list item; use <a class="link" href="lists.html#X15" title="List Item Continuation">list   item continuation</a> to explicitly append other block elements to a
-  list item.
-</li>
-<li>
-A comment block or a comment line block macro element will terminate
-  a list — use inline comment lines to put comments inside lists.
-</li>
-<li>
-The <code class="literal">listindex</code> <a class="link" href="intrinsic_attributes.html" title="Intrinsic Attributes">intrinsic attribute</a> is the current list item
-  index (1..). If this attribute is used outside a list then it’s value
-  is the number of items in the most recently closed list. Useful for
-  displaying the number of items in a list.
-</li>
-</ul>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_bulleted_lists"></a>Bulleted Lists</h3></div></div></div>
-<p>Bulleted list items start with a single dash or one to five asterisks
-followed by some white space then some text. Bulleted list syntaxes
-are:</p>
-<pre class="literallayout">- List item.
-* List item.
-** List item.
-*** List item.
-**** List item.
-***** List item.</pre>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_numbered_lists"></a>Numbered Lists</h3></div></div></div>
-<p>List item numbers are explicit or implicit.</p>
-<p><b>Explicit numbering. </b>List items begin with a number followed by some white space then the
-item text. The numbers can be decimal (arabic), roman (upper or lower
-case) or alpha (upper or lower case). Decimal and alpha numbers are
-terminated with a period, roman numbers are terminated with a closing
-parenthesis. The different terminators are necessary to ensure <span class="emphasis"><em>i</em></span>,
-<span class="emphasis"><em>v</em></span> and <span class="emphasis"><em>x</em></span> roman numbers are are distinguishable from <span class="emphasis"><em>x</em></span>, <span class="emphasis"><em>v</em></span> and
-<span class="emphasis"><em>x</em></span> alpha numbers. Examples:</p>
-<pre class="literallayout">1.   Arabic (decimal) numbered list item.
-a.   Lower case alpha (letter) numbered list item.
-F.   Upper case alpha (letter) numbered list item.
-iii) Lower case roman numbered list item.
-IX)  Upper case roman numbered list item.</pre>
-<p><b>Implicit numbering. </b>List items begin one to five period characters, followed by some white
-space then the item text. Examples:</p>
-<pre class="literallayout">. Arabic (decimal) numbered list item.
-.. Lower case alpha (letter) numbered list item.
-... Lower case roman numbered list item.
-.... Upper case alpha (letter) numbered list item.
-..... Upper case roman numbered list item.</pre>
-<p>You can use the <span class="emphasis"><em>style</em></span> attribute (also the first positional
-attribute) to specify an alternative numbering style.  The numbered
-list style can be one of the following values: <span class="emphasis"><em>arabic</em></span>, <span class="emphasis"><em>loweralpha</em></span>,
-<span class="emphasis"><em>upperalpha</em></span>, <span class="emphasis"><em>lowerroman</em></span>, <span class="emphasis"><em>upperroman</em></span>.</p>
-<p>Here are some examples of bulleted and numbered lists:</p>
-<pre class="screen">- Praesent eget purus quis magna eleifend eleifend.
-  1. Fusce euismod commodo velit.
-    a. Fusce euismod commodo velit.
-    b. Vivamus fringilla mi eu lacus.
-    c. Donec eget arcu bibendum nunc consequat lobortis.
-  2. Vivamus fringilla mi eu lacus.
-    i)  Fusce euismod commodo velit.
-    ii) Vivamus fringilla mi eu lacus.
-  3. Donec eget arcu bibendum nunc consequat lobortis.
-  4. Nam fermentum mattis ante.
-- Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
-  * Fusce euismod commodo velit.
-  ** Qui in magna commodo, est labitur dolorum an. Est ne magna primis
-     adolescens. Sit munere ponderum dignissim et. Minim luptatum et
-     vel.
-  ** Vivamus fringilla mi eu lacus.
-  * Donec eget arcu bibendum nunc consequat lobortis.
-- Nulla porttitor vulputate libero.
-  . Fusce euismod commodo velit.
-  . Vivamus fringilla mi eu lacus.
-[upperroman]
-    .. Fusce euismod commodo velit.
-    .. Vivamus fringilla mi eu lacus.
-  . Donec eget arcu bibendum nunc consequat lobortis.</pre>
-<p>Which render as:</p>
-<div class="itemizedlist"><ul type="disc">
-<li>
-<p>
-Praesent eget purus quis magna eleifend eleifend.
-</p>
-<div class="orderedlist"><ol type="1">
-<li>
-<p>
-Fusce euismod commodo velit.
-</p>
-<div class="orderedlist"><ol type="a">
-<li>
-Fusce euismod commodo velit.
-</li>
-<li>
-Vivamus fringilla mi eu lacus.
-</li>
-<li>
-Donec eget arcu bibendum nunc consequat lobortis.
-</li>
-</ol></div>
-</li>
-<li>
-<p>
-Vivamus fringilla mi eu lacus.
-</p>
-<div class="orderedlist"><ol type="i">
-<li>
-Fusce euismod commodo velit.
-</li>
-<li>
-Vivamus fringilla mi eu lacus.
-</li>
-</ol></div>
-</li>
-<li>
-Donec eget arcu bibendum nunc consequat lobortis.
-</li>
-<li>
-Nam fermentum mattis ante.
-</li>
-</ol></div>
-</li>
-<li>
-<p>
-Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
-</p>
-<div class="itemizedlist"><ul type="circle">
-<li>
-<p>
-Fusce euismod commodo velit.
-</p>
-<div class="itemizedlist"><ul type="square">
-<li>
-Qui in magna commodo, est labitur dolorum an. Est ne magna primis
-     adolescens. Sit munere ponderum dignissim et. Minim luptatum et
-     vel.
-</li>
-<li>
-Vivamus fringilla mi eu lacus.
-</li>
-</ul></div>
-</li>
-<li>
-Donec eget arcu bibendum nunc consequat lobortis.
-</li>
-</ul></div>
-</li>
-<li>
-<p>
-Nulla porttitor vulputate libero.
-</p>
-<div class="orderedlist"><ol type="1">
-<li>
-Fusce euismod commodo velit.
-</li>
-<li>
-<p>
-Vivamus fringilla mi eu lacus.
-</p>
-<div class="orderedlist"><ol type="I">
-<li>
-Fusce euismod commodo velit.
-</li>
-<li>
-Vivamus fringilla mi eu lacus.
-</li>
-</ol></div>
-</li>
-<li>
-Donec eget arcu bibendum nunc consequat lobortis.
-</li>
-</ol></div>
-</li>
-</ul></div>
-<p>A predefined <span class="emphasis"><em>compact</em></span> option is available to bulleted and numbered
-lists — this translates to the DocBook <span class="emphasis"><em>spacing="compact"</em></span> lists
-attribute which may or may not be processed by the DocBook toolchain.
-Example:</p>
-<pre class="literallayout">[options="compact"]
-- Compact list item.
-- Another compact list item.</pre>
-<div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Tip</h3>
-<p>To apply the <span class="emphasis"><em>compact</em></span> option globally define a document-wide
-<span class="emphasis"><em>compact-option</em></span> attribute, e.g. using the <code class="literal">-a compact-option</code>
-command-line option.</p>
-</div>
-<p>You can set the list start number using the <span class="emphasis"><em>start</em></span> attribute (works
-for HTML outputs and DocBook outputs processed by DocBook XSL
-Stylesheets). Example:</p>
-<pre class="literallayout">[start=7]
-. List item 7.
-. List item 8.</pre>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_labeled_lists"></a>Labeled Lists</h3></div></div></div>
-<p>Labeled list items consist of one or more text labels followed by the
-text of the list item.</p>
-<p>An item label begins a line with an alphanumeric character hard
-against the left margin and ends with two, three or four colons or two
-semi-colons. A list item can have multiple labels, one per line.</p>
-<p>The list item text consists of one or more lines of text starting
-after the last label (either on the same line or a new line) and can
-be followed by nested List or ListParagraph elements. Item text can be
-optionally indented.</p>
-<p>Here are some examples:</p>
-<pre class="screen">In::
-Lorem::
-  Fusce euismod commodo velit.
-  Fusce euismod commodo velit.
-Ipsum:: Vivamus fringilla mi eu lacus.
-  * Vivamus fringilla mi eu lacus.
-  * Donec eget arcu bibendum nunc consequat lobortis.
-Dolor::
-  Donec eget arcu bibendum nunc consequat lobortis.
-  Suspendisse;;
-    A massa id sem aliquam auctor.
-  Morbi;;
-    Pretium nulla vel lorem.
-  In;;
-    Dictum mauris in urna.
-    Vivamus::: Fringilla mi eu lacus.
-    Donec:::   Eget arcu bibendum nunc consequat lobortis.</pre>
-<p>Which render as:</p>
-<div class="variablelist"><dl>
-<dt>
-<span class="term">
-In
-, </span><span class="term">
-Lorem
-</span>
-</dt>
-<dd>
-<p>
-  Fusce euismod commodo velit.
-</p>
-<pre class="literallayout">Fusce euismod commodo velit.</pre>
-</dd>
-<dt><span class="term">
-Ipsum
-</span></dt>
-<dd>
-<p>
-Vivamus fringilla mi eu lacus.
-</p>
-<div class="itemizedlist"><ul type="disc">
-<li>
-Vivamus fringilla mi eu lacus.
-</li>
-<li>
-Donec eget arcu bibendum nunc consequat lobortis.
-</li>
-</ul></div>
-</dd>
-<dt><span class="term">
-Dolor
-</span></dt>
-<dd>
-<p>
-  Donec eget arcu bibendum nunc consequat lobortis.
-</p>
-<div class="variablelist"><dl>
-<dt><span class="term">
-Suspendisse
-</span></dt>
-<dd>
-    A massa id sem aliquam auctor.
-</dd>
-<dt><span class="term">
-Morbi
-</span></dt>
-<dd>
-    Pretium nulla vel lorem.
-</dd>
-<dt><span class="term">
-In
-</span></dt>
-<dd>
-<p>
-    Dictum mauris in urna.
-</p>
-<div class="variablelist"><dl>
-<dt><span class="term">
-Vivamus
-</span></dt>
-<dd>
-Fringilla mi eu lacus.
-</dd>
-<dt><span class="term">
-Donec
-</span></dt>
-<dd>
-Eget arcu bibendum nunc consequat lobortis.
-</dd>
-</dl></div>
-</dd>
-</dl></div>
-</dd>
-</dl></div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h4 class="title">
-<a id="_horizontal_labeled_list_style"></a>Horizontal labeled list style</h4></div></div></div>
-<p>The <span class="emphasis"><em>horizontal</em></span> labeled list style (also the first positional
-attribute) places the list text side-by-side with the label instead of
-under the label. Here is an example:</p>
-<pre class="screen">[horizontal]
-*Lorem*:: Fusce euismod commodo velit.  Qui in magna commodo, est
-labitur dolorum an. Est ne magna primis adolescens.
-  Fusce euismod commodo velit.
-*Ipsum*:: Vivamus fringilla mi eu lacus.
-- Vivamus fringilla mi eu lacus.
-- Donec eget arcu bibendum nunc consequat lobortis.
-*Dolor*::
-  - Vivamus fringilla mi eu lacus.
-  - Donec eget arcu bibendum nunc consequat lobortis.</pre>
-<p>Which render as:</p>
-<div class="horizontal"><table border="0">
-<colgroup>
-<col>
-<col>
-</colgroup>
-<tbody valign="top">
-<tr>
-<td valign="top">
-<p>
-<span class="strong"><strong>Lorem</strong></span>
-</p>
-</td>
-<td valign="top">
-<p>
-Fusce euismod commodo velit.  Qui in magna commodo, est
-labitur dolorum an. Est ne magna primis adolescens.
-</p>
-<pre class="literallayout">Fusce euismod commodo velit.</pre>
-</td>
-</tr>
-<tr>
-<td valign="top">
-<p>
-<span class="strong"><strong>Ipsum</strong></span>
-</p>
-</td>
-<td valign="top">
-<p>
-Vivamus fringilla mi eu lacus.
-</p>
-<div class="itemizedlist"><ul type="disc">
-<li>
-Vivamus fringilla mi eu lacus.
-</li>
-<li>
-Donec eget arcu bibendum nunc consequat lobortis.
-</li>
-</ul></div>
-</td>
-</tr>
-<tr>
-<td valign="top">
-<p>
-<span class="strong"><strong>Dolor</strong></span>
-</p>
-</td>
-<td valign="top">
-<div class="itemizedlist"><ul type="disc">
-<li>
-Vivamus fringilla mi eu lacus.
-</li>
-<li>
-Donec eget arcu bibendum nunc consequat lobortis.
-</li>
-</ul></div>
-</td>
-</tr>
-</tbody>
-</table></div>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Note</h3>
-<div class="itemizedlist"><ul type="disc">
-<li>
-Current PDF toolchains do not make a good job of determining
-  the relative column widths for horizontal labeled lists.
-</li>
-<li>
-Nested horizontal labeled lists will generate DocBook validation
-  errors because the <span class="emphasis"><em>DocBook XML V4.2</em></span> DTD does not permit nested
-  informal tables (although <a class="link" href="converting_docbook_to_other_file_formats.html#X13">DocBook XSL Stylesheets</a> and
-  <a class="link" href="converting_docbook_to_other_file_formats.html#X31">dblatex</a> process them correctly).
-</li>
-<li>
-The label width can be set as a percentage of the total width by
-  setting the <span class="emphasis"><em>width</em></span> attribute e.g. <code class="literal">width="10%"</code>
-</li>
-</ul></div>
-</div>
-</div>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_question_and_answer_lists"></a>Question and Answer Lists</h3></div></div></div>
-<p>AsciiDoc comes pre-configured with a <span class="emphasis"><em>qanda</em></span> style labeled list for generating
-DocBook question and answer (Q&amp;A) lists. Example:</p>
-<pre class="screen">[qanda]
-Question one::
-        Answer one.
-Question two::
-        Answer two.</pre>
-<p>Renders:</p>
-<div class="qandaset">
-<dl>
-<dt>1. <a href="lists.html#id36118638">
-Question one
-</a>
-</dt>
-<dt>2. <a href="lists.html#id36118654">
-Question two
-</a>
-</dt>
-</dl>
-<table border="0" summary="Q and A Set">
-<col align="left" width="1%">
-<tbody>
-<tr class="question">
-<td align="left" valign="top">
-<a id="id36118638"></a><a id="id36118640"></a><p><b>1.</b></p>
-</td>
-<td align="left" valign="top"><p>
-Question one
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-        Answer one.
-</p></td>
-</tr>
-<tr class="question">
-<td align="left" valign="top">
-<a id="id36118654"></a><a id="id36118656"></a><p><b>2.</b></p>
-</td>
-<td align="left" valign="top"><p>
-Question two
-</p></td>
-</tr>
-<tr class="answer">
-<td align="left" valign="top"></td>
-<td align="left" valign="top"><p>
-        Answer two.
-</p></td>
-</tr>
-</tbody>
-</table>
-</div>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_glossary_lists"></a>Glossary Lists</h3></div></div></div>
-<p>AsciiDoc comes pre-configured with a <span class="emphasis"><em>glossary</em></span> style labeled list for
-generating DocBook glossary lists. Example:</p>
-<pre class="screen">[glossary]
-A glossary term::
-    The corresponding definition.
-A second glossary term::
-    The corresponding definition.</pre>
-<p>For working examples see the <code class="literal">article.txt</code> and <code class="literal">book.txt</code> documents in
-the AsciiDoc <code class="literal">./doc</code> distribution directory.</p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Note</h3>
-<p>To generate valid DocBook output glossary lists must be located
-in a section that uses the <span class="emphasis"><em>glossary</em></span> <a class="link" href="document_structure.html#X93" title="Section markup templates">section markup template</a>.</p>
-</div>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_bibliography_lists"></a>Bibliography Lists</h3></div></div></div>
-<p>AsciiDoc comes with a predefined <span class="emphasis"><em>bibliography</em></span> bulleted list style
-generating DocBook bibliography entries. Example:</p>
-<pre class="screen">[bibliography]
-.Optional list title
-- [[[taoup]]] Eric Steven Raymond. 'The Art of UNIX
-  Programming'. Addison-Wesley. ISBN 0-13-142901-9.
-- [[[walsh-muellner]]] Norman Walsh &amp; Leonard Muellner.
-  'DocBook - The Definitive Guide'. O'Reilly &amp; Associates.
-  1999. ISBN 1-56592-580-7.</pre>
-<p>The <code class="literal">[[[&lt;reference&gt;]]]</code> syntax is a bibliography entry anchor, it
-generates an anchor named <code class="literal">&lt;reference&gt;</code> and additionally displays
-<code class="literal">[&lt;reference&gt;]</code> at the anchor position. For example <code class="literal">[[[taoup]]]</code>
-generates an anchor named <code class="literal">taoup</code> that displays <code class="literal">[taoup]</code> at the
-anchor position. Cite the reference from elsewhere your document using
-<code class="literal">&lt;&lt;taoup&gt;&gt;</code>, this displays a hyperlink (<code class="literal">[taoup]</code>) to the
-corresponding bibliography entry anchor.</p>
-<p>For working examples see the <code class="literal">article.txt</code> and <code class="literal">book.txt</code> documents in
-the AsciiDoc <code class="literal">./doc</code> distribution directory.</p>
-<div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Note</h3>
-<p>To generate valid DocBook output bibliography lists must be
-located in a <a class="link" href="document_structure.html#X93" title="Section markup templates">bibliography section</a>.</p>
-</div>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="X15"></a>List Item Continuation</h3></div></div></div>
-<p>Another list or a literal paragraph immediately following a list item
-is implicitly appended to the list item; to append other block
-elements to a list item you need to explicitly join them to the list
-item with a <span class="emphasis"><em>list continuation</em></span> (a separator line containing a single
-plus character). Multiple block elements can be appended to a list
-item using list continuations (provided they are legal list item
-children in the backend markup).</p>
-<p>Here are some examples of list item continuations: list item one
-contains multiple continuations; list item two is continued with an
-<a class="link" href="delimited_blocks.html#X29" title="Open Blocks">OpenBlock</a> containing multiple elements:</p>
-<pre class="screen">1. List item one.
-+
-List item one continued with a second paragraph followed by an
-Indented block.
-+
-.................
-$ ls *.sh
-$ mv *.sh ~/tmp
-.................
-+
-List item continued with a third paragraph.
-2. List item two continued with an open block.
-+
---
-This paragraph is part of the preceding list item.
-a. This list is nested and does not require explicit item continuation.
-+
-This paragraph is part of the preceding list item.
-b. List item b.
-This paragraph belongs to item two of the outer list.
---</pre>
-<p>Renders:</p>
-<div class="orderedlist"><ol type="1">
-<li>
-<p>
-List item one.
-</p>
-<p>List item one continued with a second paragraph followed by an
-Indented block.</p>
-<pre class="literallayout">$ ls *.sh
-$ mv *.sh ~/tmp</pre>
-<p>List item continued with a third paragraph.</p>
-</li>
-<li>
-<p>
-List item two continued with an open block.
-</p>
-<p>This paragraph is part of the preceding list item.</p>
-<div class="orderedlist"><ol type="a">
-<li>
-<p>
-This list is nested and does not require explicit item continuation.
-</p>
-<p>This paragraph is part of the preceding list item.</p>
-</li>
-<li>
-List item b.
-</li>
-</ol></div>
-<p>This paragraph belongs to item two of the outer list.</p>
-</li>
-</ol></div>
-</div>
-</div>
-    </div>
-    <hr/>
-    <div class="nav" id="navfooter">
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="delimited_blocks.html">Prev</a><br/>
-         Delimited Blocks
-      </td><td width="33%" align="center">
-         <a href="index.html">Home</a><br/>
-         AsciiDoc User Guide
-      </td><td width="33%" align="right">
-          <a href="footnotes.html">Next</a><br/>
-          Footnotes
-      </td></tr>
-    </table>
-    </div>
-  </body>
-</html>