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/the_second_chapter.html DELETED Viewed

@@ -1,95 +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>The second chapter</title>
-  </head>
-  <body>
-    <div class="nav" id="navheader">
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="the_first_chapter.html">Prev</a><br/>
-         The first chapter
-      </td><td width="33%" align="center">
-         <a href="index.html">Home</a><br/>
-         <strong>Book Title</strong>
-      </td><td width="33%" align="right">
-          <a href="source_code_highlighting.html">Next</a><br/>
-          Source Code Highlighting
-      </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="_the_second_chapter"></a>The second chapter</h2></div></div></div>
-<p>Ut suspendisse nulla. Auctor felis facilisis. Rutrum vivamus nec
-lectus porttitor dui dapibus eu ridiculus tempor sodales et. Sit a
-cras. Id tellus cubilia erat.</p>
-<p>Quisque nullam et. Blandit dui tempor. Posuere in elit diam egestas
-sem vivamus vel ac.</p>
-<div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Tip</h3>
-<p>Tip.</p>
-</div>
-<div class="important" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Important</h3>
-<p>This is important.</p>
-</div>
-<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Warning</h3>
-<p>This is a warning.</p>
-</div>
-<div class="caution" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Caution</h3>
-<p>Tread lightly.</p>
-</div>
-<pre class="programlisting">#include &lt;stdio.h&gt;
-main()
-{
-  char hex[] = "599955586da1c3ad514f3e65f1081d2012ec862d";
-  git_oid oid;
-  git_oid_mkstr(&amp;oid, hex);
-  printf("Raw 20 bytes: [%s]\n", (&amp;oid)-&gt;id);
-}</pre>
-</div>
-    </div>
-    <hr/>
-    <div class="nav" id="navfooter">
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="the_first_chapter.html">Prev</a><br/>
-         The first chapter
-      </td><td width="33%" align="center">
-         <a href="index.html">Home</a><br/>
-         Book Title
-      </td><td width="33%" align="right">
-          <a href="source_code_highlighting.html">Next</a><br/>
-          Source Code Highlighting
-      </td></tr>
-    </table>
-    </div>
-  </body>
-</html>

data/example/output/the_third_chapter.html DELETED Viewed

@@ -1,58 +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="stylesheets/handbookish.css" type="text/css" />
-    <title>Page The Third Chapter</title>
-  </head>
-  <body>
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="the_second_chapter.html">Prev</a><br/>
-         The Second Chapter
-      </td><td width="33%" align="center">
-         <a href="index.html">Home</a><br/>
-      </td><td width="33%" align="right">
-          <a href="a_example_appendix.html">Next</a><br/>
-          A. Example Appendix
-      </td></tr>
-    </table>
-    <hr/>
-    <div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h2 class="title" style="clear: both">
-<a id="_the_third_chapter"></a>The Third Chapter</h2></div></div></div>
-<p>Book chapters are at level 1 and can contain sub-sections.</p>
-</div>
-    <hr/>
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="the_second_chapter.html">Prev</a><br/>
-         The Second Chapter
-      </td><td width="33%" align="center">
-         <a href="index.html">Home</a><br/>
-      </td><td width="33%" align="right">
-          <a href="a_example_appendix.html">Next</a><br/>
-          A. Example Appendix
-      </td></tr>
-    </table>
-  </body>
-</html>

data/example/output/tips_and_tricks.html DELETED Viewed

@@ -1,452 +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>Tips and Tricks</title>
-  </head>
-  <body>
-    <div class="nav" id="navheader">
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="help_commands.html">Prev</a><br/>
-         Help Commands
-      </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="glossary.html">Next</a><br/>
-          Glossary
-      </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="_tips_and_tricks"></a>Tips and Tricks</h2></div></div></div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_know_your_editor"></a>Know Your Editor</h3></div></div></div>
-<p>Writing AsciiDoc documents will be a whole lot more pleasant if you
-know your favorite text editor. Learn how to indent and reformat text
-blocks, paragraphs, lists and sentences. <a class="link" href="tips_and_tricks.html#X20" title="Vim Commands for Formatting AsciiDoc">Tips for <span class="emphasis"><em>vim</em></span> users</a>
-follow.</p>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="X20"></a>Vim Commands for Formatting AsciiDoc</h3></div></div></div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h4 class="title">
-<a id="_text_wrap_paragraphs"></a>Text Wrap Paragraphs</h4></div></div></div>
-<p>Use the vim <code class="literal">:gq</code> command to reformat paragraphs. Setting the
-<span class="emphasis"><em>textwidth</em></span> sets the right text wrap margin; for example:</p>
-<pre class="literallayout">:set textwidth=70</pre>
-<p>To reformat a paragraph:</p>
-<div class="orderedlist"><ol type="1">
-<li>
-Position the cursor at the start of the paragraph.
-</li>
-<li>
-Type <code class="literal">gq}</code>.
-</li>
-</ol></div>
-<p>Execute <code class="literal">:help gq</code> command to read about the vim gq command.</p>
-<div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;">
-<h3 class="title">Tip</h3>
-<div class="itemizedlist"><ul type="disc">
-<li>
-Assign the <code class="literal">gq}</code> command to the Q key with the <code class="literal">nnoremap Q gq}</code>
-  command or put it in your <code class="literal">~/.vimrc</code> file to so it’s always
-  available (see the <a class="link" href="tips_and_tricks.html#X61" title="Example ~/.vimrc File">Example <code class="literal">~/.vimrc</code> file</a>).
-</li>
-<li>
-Put <code class="literal">set</code> commands in your <code class="literal">~/.vimrc</code> file so you don’t have to
-  enter them manually.
-</li>
-<li>
-The Vim website (<a class="ulink" href="http://www.vim.org" target="_top">http://www.vim.org</a>) has a wealth of resources,
-  including scripts for automated spell checking and ASCII Art
-  drawing.
-</li>
-</ul></div>
-</div>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h4 class="title">
-<a id="_format_lists"></a>Format Lists</h4></div></div></div>
-<p>The <code class="literal">gq</code> command can also be used to format bulleted, numbered and
-callout lists. First you need to set the <code class="literal">comments</code>, <code class="literal">formatoptions</code>
-and <code class="literal">formatlistpat</code> (see the <a class="link" href="tips_and_tricks.html#X61" title="Example ~/.vimrc File">Example <code class="literal">~/.vimrc</code> file</a>).</p>
-<p>Now you can format simple lists that use dash, asterisk, period and
-plus bullets along with numbered ordered lists:</p>
-<div class="orderedlist"><ol type="1">
-<li>
-Position the cursor at the start of the list.
-</li>
-<li>
-Type <code class="literal">gq}</code>.
-</li>
-</ol></div>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h4 class="title">
-<a id="_indent_paragraphs"></a>Indent Paragraphs</h4></div></div></div>
-<p>Indent whole paragraphs by indenting the fist line with the desired
-indent and then executing the <code class="literal">gq}</code> command.</p>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h4 class="title">
-<a id="X61"></a>Example <code class="literal">~/.vimrc</code> File</h4></div></div></div>
-<pre class="screen">" Use bold bright fonts.
-set background=dark
-" Show tabs and trailing characters.
-set listchars=tab:»·,trail:·
-set list
-" Don't highlight searched text.
-highlight clear Search
-" Don't move to matched text while search pattern is being entered.
-set noincsearch
-" Reformat paragraphs and list.
-nnoremap R gq}
-" Delete trailing white space and Dos-returns and to expand tabs to spaces.
-nnoremap S :set et&lt;CR&gt;:retab!&lt;CR&gt;:%s/[\r \t]\+$//&lt;CR&gt;
-autocmd BufRead,BufNewFile *.txt,README,TODO,CHANGELOG,NOTES
-        \ setlocal autoindent expandtab tabstop=8 softtabstop=2 shiftwidth=2 filetype=asciidoc
-        \ textwidth=70 wrap formatoptions=tcqn
-        \ formatlistpat=^\\s*\\d\\+\\.\\s\\+\\\\|^\\s*&lt;\\d\\+&gt;\\s\\+\\\\|^\\s*[a-zA-Z.]\\.\\s\\+\\\\|^\\s*[ivxIVX]\\+\\.\\s\\+
-        \ comments=s1:/*,ex:*/,://,b:#,:%,:XCOMM,fb:-,fb:*,fb:+,fb:.,fb:&gt;</pre>
-</div>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_troubleshooting"></a>Troubleshooting</h3></div></div></div>
-<p>AsciiDoc diagnostic features are detailed in the <a class="link" href="g_diagnostics.html" title="G. Diagnostics">Diagnostics appendix</a>.</p>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_gotchas"></a>Gotchas</h3></div></div></div>
-<div class="variablelist"><dl>
-<dt><span class="term">
-Incorrect character encoding
-</span></dt>
-<dd>
-    If you get an error message like <code class="literal">'UTF-8' codec can't decode ...</code>
-    then you source file contains invalid UTF-8 characters — set the
-    AsciiDoc <a class="link" href="h_backend_attributes.html#X54">encoding attribute</a> for the correct character set
-    (typically ISO-8859-1 (Latin-1) for European languages).
-</dd>
-<dt><span class="term">
-Invalid output
-</span></dt>
-<dd>
-<p>
-    AsciiDoc attempts to validate the input AsciiDoc source but makes
-    no attempt to validate the output markup, it leaves that to
-    external tools such as <code class="literal">xmllint(1)</code> (integrated into <code class="literal">a2x(1)</code>).
-    Backend validation cannot be hardcoded into AsciiDoc because
-    backends are dynamically configured. The following example
-    generates valid HTML but invalid DocBook (the DocBook <code class="literal">literal</code>
-    element cannot contain an <code class="literal">emphasis</code> element):
-</p>
-<pre class="literallayout">+monospaced text with an _emphasized_ word+</pre>
-</dd>
-<dt><span class="term">
-Misinterpreted text formatting
-</span></dt>
-<dd>
-<p>
-    You can suppress markup expansion by placing a backslash character
-    immediately in front of the element. The following example
-    suppresses inline monospaced formatting:
-</p>
-<pre class="literallayout">\+1 for C++.</pre>
-</dd>
-<dt><span class="term">
-Overlapping text formatting
-</span></dt>
-<dd>
-<p>
-    Overlapping text formatting will generate illegal overlapping
-    markup tags which will result in downstream XML parsing errors.
-    Here’s an example:
-</p>
-<pre class="literallayout">Some *strong markup _that overlaps* emphasized markup_.</pre>
-</dd>
-<dt><span class="term">
-Ambiguous underlines
-</span></dt>
-<dd>
-    A DelimitedBlock can immediately follow a paragraph without an
-    intervening blank line, but be careful, a single line paragraph
-    underline may be misinterpreted as a section title underline
-    resulting in a “closing block delimiter expected” error.
-</dd>
-<dt><span class="term">
-Ambiguous ordered list items
-</span></dt>
-<dd>
-<p>
-    Lines beginning with numbers at the end of sentences will be
-    interpreted as ordered list items.  The following example
-    (incorrectly) begins a new list with item number 1999:
-</p>
-<pre class="literallayout">He was last sighted in
-1999. Since then things have moved on.</pre>
-<p>The <span class="emphasis"><em>list item out of sequence</em></span> warning makes it unlikely that this
-problem will go unnoticed.</p>
-</dd>
-<dt><span class="term">
-Special characters in attribute values
-</span></dt>
-<dd>
-<p>
-    Special character substitution precedes attribute substitution so
-    if attribute values contain special characters you may, depending
-    on the substitution context, need to escape the special characters
-    yourself. For example:
-</p>
-<pre class="literallayout">$ asciidoc -a 'orgname=Bill &amp;amp; Ben Inc.' mydoc.txt</pre>
-</dd>
-<dt><span class="term">
-Attribute lists
-</span></dt>
-<dd>
-<p>
-    If any named attribute entries are present then all string
-    attribute values must be quoted.  For example:
-</p>
-<pre class="literallayout">["Desktop screenshot",width=32]</pre>
-</dd>
-</dl></div>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="X90"></a>Combining separate documents</h3></div></div></div>
-<p>You have a number of stand-alone AsciiDoc documents that you want to
-process as a single document. Simply processing them with a series of
-<code class="literal">include</code> macros won’t work because the documents contain (level 0)
-document titles.  The solution is to create a top level wrapper
-document and use the <code class="literal">leveloffset</code> attribute to push them all down one
-level. For example:</p>
-<pre class="screen">Combined Document Title
-_______________________
-:leveloffset: 1
-include::document1.txt[]
-include::document2.txt[]
-include::document3.txt[]</pre>
-<p>The document titles in the included documents will now be processed as
-level 1 section titles, level 1 sections as level 2 sections and so
-on.</p>
-<div class="itemizedlist"><ul type="disc">
-<li>
-Put a blank line between the <code class="literal">include</code> macro lines to ensure the
-  title of the included document is not seen as part of the last
-  paragraph of the previous document.
-</li>
-<li>
-You won’t want non-title document header lines (for example, Author
-  and Revision lines) in the included files — conditionally exclude
-  them if they are necessary for stand-alone processing.
-</li>
-</ul></div>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_processing_document_sections_separately"></a>Processing document sections separately</h3></div></div></div>
-<p>You have divided your AsciiDoc document into separate files (one per
-top level section) which are combined and processed with the following
-top level document:</p>
-<pre class="screen">Combined Document Title
-=======================
-Joe Bloggs
-v1.0, 12-Aug-03
-include::section1.txt[]
-include::section2.txt[]
-include::section3.txt[]</pre>
-<p>You also want to process the section files as separate documents.
-This is easy because asciidoc(1) will quite happily process
-<code class="literal">section1.txt</code>, <code class="literal">section2.txt</code> and <code class="literal">section3.txt</code> separately — the
-resulting output documents contain the section but have no document
-title.</p>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_processing_document_snippets"></a>Processing document snippets</h3></div></div></div>
-<p>Use the <code class="literal">-s</code> (<code class="literal">--no-header-footer</code>) command-line option to suppress
-header and footer output, this is useful if the processed output is to
-be included in another file. For example:</p>
-<pre class="literallayout">$ asciidoc -sb docbook section1.txt</pre>
-<p>asciidoc(1) can be used as a filter, so you can pipe chunks of text
-through it. For example:</p>
-<pre class="literallayout">$ echo 'Hello *World!*' | asciidoc -s -
-&lt;div class="paragraph"&gt;&lt;p&gt;Hello &lt;strong&gt;World!&lt;/strong&gt;&lt;/p&gt;&lt;/div&gt;</pre>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_badges_in_html_page_footers"></a>Badges in HTML page footers</h3></div></div></div>
-<p>See the <code class="literal">[footer]</code> section in the AsciiDoc distribution <code class="literal">xhtml11.conf</code>
-configuration file.</p>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_pretty_printing_asciidoc_output"></a>Pretty printing AsciiDoc output</h3></div></div></div>
-<p>If the indentation and layout of the asciidoc(1) output is not to your
-liking you can:</p>
-<div class="orderedlist"><ol type="1">
-<li>
-Change the indentation and layout of configuration file markup
-   template sections. The <code class="literal">{empty}</code> attribute is useful for outputting
-   trailing blank lines in markup templates.
-</li>
-<li>
-<p>
-Use Dave Raggett’s <a class="ulink" href="http://tidy.sourceforge.net/" target="_top">HTML Tidy</a> program
-   to tidy asciidoc(1) output. Example:
-</p>
-<pre class="literallayout">$ asciidoc -b docbook -o - mydoc.txt | tidy -indent -xml &gt;mydoc.xml</pre>
-</li>
-<li>
-<p>
-Use the <code class="literal">xmllint(1)</code> format option. Example:
-</p>
-<pre class="literallayout">$ xmllint --format mydoc.xml</pre>
-</li>
-</ol></div>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_supporting_minor_docbook_dtd_variations"></a>Supporting minor DocBook DTD variations</h3></div></div></div>
-<p>The conditional inclusion of DocBook SGML markup at the end of the
-distribution <code class="literal">docbook45.conf</code> file illustrates how to support minor
-DTD variations. The included sections override corresponding entries
-from preceding sections.</p>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_creating_stand_alone_html_documents"></a>Creating stand-alone HTML documents</h3></div></div></div>
-<p>If you’ve ever tried to send someone an HTML document that includes
-stylesheets and images you’ll know that it’s not as straight-forward
-as exchanging a single file.  AsciiDoc has options to create
-stand-alone documents containing embedded images, stylesheets and
-scripts.  The following AsciiDoc command creates a single file
-containing <a class="link" href="macros.html#X66" title="Embedding images in XHTML documents">embedded images</a>, CSS stylesheets, and JavaScript
-(for table of contents and footnotes):</p>
-<pre class="literallayout">$ asciidoc -a data-uri -a icons -a toc -a max-width=55em article.txt</pre>
-<p>You can view the HTML file here: <a class="ulink" href="http://www.methods.co.nz/asciidoc/article-standalone.html" target="_top">http://www.methods.co.nz/asciidoc/article-standalone.html</a></p>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_shipping_stand_alone_asciidoc_source"></a>Shipping stand-alone AsciiDoc source</h3></div></div></div>
-<p>Reproducing presentation documents from someone else’s source has one
-major problem: unless your configuration files are the same as the
-creator’s you won’t get the same output.</p>
-<p>The solution is to create a single backend specific configuration file
-using the asciidoc(1) <code class="literal">-c</code> (<code class="literal">--dump-conf</code>) command-line option. You
-then ship this file along with the AsciiDoc source document plus the
-<code class="literal">asciidoc.py</code> script. The only end user requirement is that they have
-Python installed (and that they consider you a trusted source). This
-example creates a composite HTML configuration file for <code class="literal">mydoc.txt</code>:</p>
-<pre class="literallayout">$ asciidoc -cb xhtml11 mydoc.txt &gt; mydoc-xhtml11.conf</pre>
-<p>Ship <code class="literal">mydoc.txt</code>, <code class="literal">mydoc-html.conf</code>, and <code class="literal">asciidoc.py</code>. With
-these three files (and a Python interpreter) the recipient can
-regenerate the HMTL output:</p>
-<pre class="literallayout">$ ./asciidoc.py -eb xhtml11 mydoc.txt</pre>
-<p>The <code class="literal">-e</code> (<code class="literal">--no-conf</code>) option excludes the use of implicit
-configuration files, ensuring that only entries from the
-<code class="literal">mydoc-html.conf</code> configuration are used.</p>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_inserting_blank_space"></a>Inserting blank space</h3></div></div></div>
-<p>Adjust your style sheets to add the correct separation between block
-elements. Inserting blank paragraphs containing a single non-breaking
-space character <code class="literal">{nbsp}</code> works but is an ad hoc solution compared
-to using style sheets.</p>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_closing_open_sections"></a>Closing open sections</h3></div></div></div>
-<p>You can close off section tags up to level <code class="literal">N</code> by calling the
-<code class="literal">eval::[Section.setlevel(N)]</code> system macro. This is useful if you
-want to include a section composed of raw markup. The following
-example includes a DocBook glossary division at the top section level
-(level 0):</p>
-<pre class="screen">ifdef::basebackend-docbook[]
-eval::[Section.setlevel(0)]
-+++++++++++++++++++++++++++++++
-&lt;glossary&gt;
-  &lt;title&gt;Glossary&lt;/title&gt;
-  &lt;glossdiv&gt;
-  ...
-  &lt;/glossdiv&gt;
-&lt;/glossary&gt;
-+++++++++++++++++++++++++++++++
-endif::basebackend-docbook[]</pre>
-</div>
-<div class="section" lang="en" xml:lang="en">
-<div class="titlepage"><div><div><h3 class="title">
-<a id="_validating_output_files"></a>Validating output files</h3></div></div></div>
-<p>Use <code class="literal">xmllint(1)</code> to check the AsciiDoc generated markup is both well
-formed and valid. Here are some examples:</p>
-<pre class="literallayout">$ xmllint --nonet --noout --valid docbook-file.xml
-$ xmllint --nonet --noout --valid xhtml11-file.html
-$ xmllint --nonet --noout --valid --html html4-file.html</pre>
-<p>The <code class="literal">--valid</code> option checks the file is valid against the document
-type’s DTD, if the DTD is not installed in your system’s catalog then
-it will be fetched from its Internet location. If you omit the
-<code class="literal">--valid</code> option the document will only be checked that it is well
-formed.</p>
-</div>
-</div>
-    </div>
-    <hr/>
-    <div class="nav" id="navfooter">
-    <table width="100%">
-      <tr><td width="33%" align="left">
-         <a href="help_commands.html">Prev</a><br/>
-         Help Commands
-      </td><td width="33%" align="center">
-         <a href="index.html">Home</a><br/>
-         AsciiDoc User Guide
-      </td><td width="33%" align="right">
-          <a href="glossary.html">Next</a><br/>
-          Glossary
-      </td></tr>
-    </table>
-    </div>
-  </body>
-</html>