erbook 4.0.0 → 5.0.0

data/doc/api/classes/String.html

@@ -55,8 +55,8 @@
         <tr class="top-aligned-row">
             <td><strong>In:</strong></td>
             <td>
-                <a href="../files/lib/erbook/html_rb.html">
-                lib/erbook/html.rb
+                <a href="../files/lib/erbook/to_xhtml_rb.html">
+                lib/erbook/to_xhtml.rb
                 </a>
         <br />
             </td>
@@ -86,10 +86,8 @@
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000004">thru_coderay</a>&nbsp;&nbsp;
-      <a href="#M000003">thru_maruku</a>&nbsp;&nbsp;
-      <a href="#M000002">to_html</a>&nbsp;&nbsp;
-      <a href="#M000001">to_inline_html</a>&nbsp;&nbsp;
+      <a href="#M000001">to_inline_xhtml</a>&nbsp;&nbsp;
+      <a href="#M000002">to_xhtml</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -112,7 +110,7 @@
           <td class="context-item-value">%w[tt code pre]</td>
           <td width="3em">&nbsp;</td>
           <td class="context-item-desc">
-The content of these HTML tags will be preserved while they are being
+The content of these XHTML tags will be preserved while they are being
 processed by Textile. By doing this, we avoid unwanted Textile
 transformations, such as quotation marks becoming curly (&amp;8192;), in
 source code.
@@ -125,8 +123,8 @@ source code.
           <td class="context-item-value">%w[noformat]</td>
           <td width="3em">&nbsp;</td>
           <td class="context-item-desc">
-The content of these HTML tags will be preserved <b>verbatim</b> throughout
-the text-to-HTML conversion process.
+The content of these XHTML tags will be preserved <b>verbatim</b>
+throughout the text-to-XHTML conversion process.
 
 </td>
         </tr>
@@ -134,27 +132,6 @@ the text-to-HTML conversion process.
       </div>
     </div>
 
-    <div id="aliases-list">
-      <h3 class="section-bar">External Aliases</h3>
-
-      <div class="name-list">
-                        <table summary="aliases">
-        <tr class="top-aligned-row context-row">
-          <td class="context-item-name">to_html</td>
-          <td>-&gt;</td>
-          <td class="context-item-value">to_html_maruku</td>
-        </tr>
-      <tr class="top-aligned-row context-row">
-        <td>&nbsp;</td>
-        <td colspan="2" class="context-item-desc">
-XXX: Maruku also defines <a href="String.html#M000002">String#to_html</a>
-so we have to hack around it :-(
-
-</td>
-      </tr>
-                        </table>
-      </div>
-    </div>
 
 
       
@@ -164,44 +141,20 @@ so we have to hack around it :-(
     <div id="methods">
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000004" class="method-detail">
-        <a name="M000004"></a>
-
-        <div class="method-heading">
-          <a href="String.src/M000004.html" target="Code" class="method-signature"
-            onclick="popupCode('String.src/M000004.html');return false;">
-          <span class="method-name">thru_coderay</span><span class="method-args">()</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-Adds syntax coloring to &lt;code&gt; elements in the given text. If the
-&lt;code&gt; tag has an attribute lang=&quot;&#8230;&quot;, then that is
-considered the programming language for which appropriate syntax coloring
-should be applied. Otherwise, the programming language is assumed to be
-ruby.
-</p>
-        </div>
-      </div>
-
-      <div id="method-M000003" class="method-detail">
-        <a name="M000003"></a>
+      <div id="method-M000001" class="method-detail">
+        <a name="M000001"></a>
 
         <div class="method-heading">
-          <a href="String.src/M000003.html" target="Code" class="method-signature"
-            onclick="popupCode('String.src/M000003.html');return false;">
-          <span class="method-name">thru_maruku</span><span class="method-args">(aInline = false)</span>
+          <a href="String.src/M000001.html" target="Code" class="method-signature"
+            onclick="popupCode('String.src/M000001.html');return false;">
+          <span class="method-name">to_inline_xhtml</span><span class="method-args">()</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Returns the result of running this string through Maruku.
-</p>
-<p>
-If aInline is true, then the resulting HTML will <b>not</b> be wrapped in a
-HTML paragraph element.
+Transforms this string into an <b>inline</b> XHTML string (one that does
+not contain any block-level XHTML elements at the root).
 </p>
         </div>
       </div>
@@ -212,40 +165,22 @@ HTML paragraph element.
         <div class="method-heading">
           <a href="String.src/M000002.html" target="Code" class="method-signature"
             onclick="popupCode('String.src/M000002.html');return false;">
-          <span class="method-name">to_html</span><span class="method-args">(aInline = false)</span>
+          <span class="method-name">to_xhtml</span><span class="method-args">(aInline = false)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p>
-Transforms this string into HTML while ensuring that the result contains
+Transforms this string into XHTML while ensuring that the result contains
 one or more block-level elements at the root.
 </p>
 <p>
-If aInline is true, then the resulting HTML will be an <b>inline</b>
+If aInline is true, then the resulting XHTML will be an <b>inline</b>
 string.
 </p>
         </div>
       </div>
 
-      <div id="method-M000001" class="method-detail">
-        <a name="M000001"></a>
-
-        <div class="method-heading">
-          <a href="String.src/M000001.html" target="Code" class="method-signature"
-            onclick="popupCode('String.src/M000001.html');return false;">
-          <span class="method-name">to_inline_html</span><span class="method-args">()</span>
-          </a>
-        </div>
-      
-        <div class="method-description">
-          <p>
-Transforms this string into an <b>inline</b> HTML string (one that does not
-contain any block-level HTML elements at the root).
-</p>
-        </div>
-      </div>
-
 
     </div>
 

data/doc/api/classes/String.src/M000001.html

@@ -5,14 +5,14 @@
 
 <html>
 <head>
-  <title>to_inline_html (String)</title>
+  <title>to_inline_xhtml (String)</title>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
   <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre><span class="ruby-comment cmt"># File lib/erbook/html.rb, line 33</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_inline_html</span>
-    <span class="ruby-identifier">to_html</span> <span class="ruby-keyword kw">true</span>
+  <pre><span class="ruby-comment cmt"># File lib/erbook/to_xhtml.rb, line 33</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_inline_xhtml</span>
+    <span class="ruby-identifier">to_xhtml</span> <span class="ruby-keyword kw">true</span>
   <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/doc/api/classes/String.src/M000002.html

@@ -5,16 +5,13 @@
 
 <html>
 <head>
-  <title>to_html (String)</title>
+  <title>to_xhtml (String)</title>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
   <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre><span class="ruby-comment cmt"># File lib/erbook/html.rb, line 45</span>
-  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_html</span> <span class="ruby-identifier">aInline</span> = <span class="ruby-keyword kw">false</span>
-    <span class="ruby-comment cmt"># XXX: Maruku also defines String#to_html so we have to hack around it :-(</span>
-    <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">to_html_maruku</span> <span class="ruby-keyword kw">if</span> <span class="ruby-identifier">caller</span>.<span class="ruby-identifier">detect</span> {<span class="ruby-operator">|</span><span class="ruby-identifier">c</span><span class="ruby-operator">|</span> <span class="ruby-identifier">c</span> <span class="ruby-operator">=~</span> <span class="ruby-regexp re">%r'/lib/maruku/output/'</span> }
-
+  <pre><span class="ruby-comment cmt"># File lib/erbook/to_xhtml.rb, line 42</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">to_xhtml</span> <span class="ruby-identifier">aInline</span> = <span class="ruby-keyword kw">false</span>
     <span class="ruby-identifier">protect</span>(<span class="ruby-keyword kw">self</span>, <span class="ruby-constant">VERBATIM_TAGS</span>, <span class="ruby-keyword kw">true</span>) <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">text</span><span class="ruby-operator">|</span>
       <span class="ruby-identifier">html</span> = <span class="ruby-identifier">protect</span>(<span class="ruby-identifier">text</span>, <span class="ruby-constant">PROTECTED_TAGS</span>, <span class="ruby-keyword kw">false</span>) {<span class="ruby-operator">|</span><span class="ruby-identifier">s</span><span class="ruby-operator">|</span> <span class="ruby-identifier">s</span>.<span class="ruby-identifier">thru_maruku</span> <span class="ruby-identifier">aInline</span> }
 

data/doc/api/created.rid

@@ -1 +1 @@
-Sat, 15 Nov 2008 18:25:12 -0800
+Sat, 22 Nov 2008 23:17:15 -0800

data/doc/api/files/lib/erbook/rdoc_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Sat Nov 15 17:16:15 -0800 2008</td>
+      <td>Sat Nov 22 16:53:55 -0800 2008</td>
     </tr>
     </table>
   </div>

data/doc/api/files/lib/erbook/{html_rb.html → to_xhtml_rb.html}

@@ -5,7 +5,7 @@
 
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 <head>
-  <title>File: html.rb</title>
+  <title>File: to_xhtml.rb</title>
   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
   <meta http-equiv="Content-Script-Type" content="text/javascript" />
   <link rel="stylesheet" href="../../.././rdoc-style.css" type="text/css" media="screen" />
@@ -47,16 +47,16 @@
 
 
   <div id="fileHeader">
-    <h1>html.rb</h1>
+    <h1>to_xhtml.rb</h1>
     <table class="header-table">
     <tr class="top-aligned-row">
       <td><strong>Path:</strong></td>
-      <td>lib/erbook/html.rb
+      <td>lib/erbook/to_xhtml.rb
       </td>
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Sat Nov 15 17:16:15 -0800 2008</td>
+      <td>Sat Nov 22 22:05:20 -0800 2008</td>
     </tr>
     </table>
   </div>
@@ -71,9 +71,9 @@
     <div id="description">
       <p>
 This file defines the <a
-href="../../../classes/String.html#M000002">String#to_html</a> and <a
-href="../../../classes/String.html#M000001">String#to_inline_html</a>
-methods, which are invoked to transform plain text into HTML.
+href="../../../classes/String.html#M000002">String#to_xhtml</a> and <a
+href="../../../classes/String.html#M000001">String#to_inline_xhtml</a>
+methods, which are invoked to transform plain text into XHTML.
 </p>
 <p>
 This particular implementation features the Markdown formatting system via

data/doc/api/files/lib/erbook_rb.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Sat Nov 15 17:16:15 -0800 2008</td>
+      <td>Sat Nov 22 22:05:20 -0800 2008</td>
     </tr>
     </table>
   </div>

data/doc/api/fr_file_index.html

@@ -21,8 +21,8 @@
   <h1 class="section-bar">Files</h1>
   <div id="index-entries">
     <a href="files/lib/erbook_rb.html">lib/erbook.rb</a><br />
-    <a href="files/lib/erbook/html_rb.html">lib/erbook/html.rb</a><br />
     <a href="files/lib/erbook/rdoc_rb.html">lib/erbook/rdoc.rb</a><br />
+    <a href="files/lib/erbook/to_xhtml_rb.html">lib/erbook/to_xhtml.rb</a><br />
   </div>
 </div>
 </body>

data/doc/api/fr_method_index.html

@@ -20,20 +20,18 @@
 <div id="index">
   <h1 class="section-bar">Methods</h1>
   <div id="index-entries">
-    <a href="classes/RDoc/TopLevel.html#M000009">all_classes (RDoc::TopLevel)</a><br />
-    <a href="classes/RDoc/TopLevel.html#M000011">all_methods (RDoc::TopLevel)</a><br />
-    <a href="classes/RDoc/TopLevel.html#M000010">all_modules (RDoc::TopLevel)</a><br />
-    <a href="classes/RDoc/AnyMethod.html#M000007">comment_html (RDoc::AnyMethod)</a><br />
-    <a href="classes/RDoc/AnyMethod.html#M000006">decl (RDoc::AnyMethod)</a><br />
-    <a href="classes/RDoc/AnyMethod.html#M000005">full_name (RDoc::AnyMethod)</a><br />
-    <a href="classes/RDoc/TopLevel.html#M000013">parse (RDoc::TopLevel)</a><br />
-    <a href="classes/RDoc/TopLevel.html#M000014">parse_file (RDoc::TopLevel)</a><br />
-    <a href="classes/RDoc/TopLevel.html#M000012">refresh_all_classes_and_modules (RDoc::TopLevel)</a><br />
-    <a href="classes/String.html#M000004">thru_coderay (String)</a><br />
-    <a href="classes/String.html#M000003">thru_maruku (String)</a><br />
-    <a href="classes/String.html#M000002">to_html (String)</a><br />
-    <a href="classes/String.html#M000001">to_inline_html (String)</a><br />
-    <a href="classes/RDoc/AnyMethod.html#M000008">top_level (RDoc::AnyMethod)</a><br />
+    <a href="classes/RDoc/TopLevel.html#M000007">all_classes (RDoc::TopLevel)</a><br />
+    <a href="classes/RDoc/TopLevel.html#M000009">all_methods (RDoc::TopLevel)</a><br />
+    <a href="classes/RDoc/TopLevel.html#M000008">all_modules (RDoc::TopLevel)</a><br />
+    <a href="classes/RDoc/AnyMethod.html#M000005">comment_html (RDoc::AnyMethod)</a><br />
+    <a href="classes/RDoc/AnyMethod.html#M000004">decl (RDoc::AnyMethod)</a><br />
+    <a href="classes/RDoc/AnyMethod.html#M000003">full_name (RDoc::AnyMethod)</a><br />
+    <a href="classes/RDoc/TopLevel.html#M000011">parse (RDoc::TopLevel)</a><br />
+    <a href="classes/RDoc/TopLevel.html#M000012">parse_file (RDoc::TopLevel)</a><br />
+    <a href="classes/RDoc/TopLevel.html#M000010">refresh_all_classes_and_modules (RDoc::TopLevel)</a><br />
+    <a href="classes/String.html#M000001">to_inline_xhtml (String)</a><br />
+    <a href="classes/String.html#M000002">to_xhtml (String)</a><br />
+    <a href="classes/RDoc/AnyMethod.html#M000006">top_level (RDoc::AnyMethod)</a><br />
   </div>
 </div>
 </body>

data/doc/api/index.html

@@ -19,6 +19,6 @@
         <frame src="fr_class_index.html"  name="Classes" />
         <frame src="fr_method_index.html" name="Methods" />
     </frameset>
-    <frame src="files/lib/erbook/html_rb.html" name="docwin" />
+    <frame src="files/lib/erbook/to_xhtml_rb.html" name="docwin" />
 </frameset>
 </html>

data/doc/index.xhtml

@@ -0,0 +1,2277 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd" [
+    <!ENTITY icon_caution "data:image/png;base64,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">
+    <!ENTITY icon_tip "data:image/png;base64,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">
+    <!ENTITY icon_important "data:image/png;base64,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">
+    <!ENTITY icon_note "data:image/png;base64,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">
+    <!ENTITY icon_warning "data:image/png;base64,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">
+    <!ENTITY icon_quote "data:image/png;base64,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">
+    <!ENTITY icon_link "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAMAAAC67D+PAAAAFVBMVEVmmcwzmcyZzP8AZswAZv////////9E6giVAAAAB3RSTlP///////8AGksDRgAAADhJREFUGFcly0ESAEAEA0Ei6/9P3sEcVB8kmrwFyni0bOeyyDpy9JTLEaOhQq7Ongf5FeMhHS/4AVnsAZubxDVmAAAAAElFTkSuQmCC">
+]>
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta http-equiv="content-type" content="text/html; charset=utf-8"/>
+    <meta name="date" content="22 November 2008"/>
+    <meta name="author" content="Suraj N. Kurapati"/>
+    <meta name="generator" content="erbook 5.0.0"/>
+    <title>erbook 5.0.0 user manual</title>
+
+        <link rel="alternate" type="application/rss+xml" href="http://snk.tuxfamily.org/lib/erbook/ann"/>
+
+      <style type="text/css" media="screen">
+      <![CDATA[body
+{
+      margin            : auto;
+      max-width         : 36em;
+      padding           : 0.5em;
+}
+
+/* source code */
+
+  tt
+  {
+      background-color  : #F0F8FF;
+  }
+
+  pre
+  {
+      cursor            : text;
+      line-height       : normal;
+      border            : 1px solid #b1d827;
+      background-color  : #F5FFDF;
+      padding           : 1em;
+      overflow          : auto;
+  }
+
+  /* output of the syntax coloring library */
+  pre.code
+  {
+      background-color  : #FFFFE8;
+      border-color      : #EEDD88;
+  }
+
+/* hyperlinks */
+
+  a
+  {
+      text-decoration   : none;
+  }
+
+  a:hover
+  {
+      text-decoration   : underline;
+  }
+
+  a:link
+  {
+      color             : #002BB8;
+  }
+
+  a:visited
+  {
+      color             : #5A3696;
+  }
+
+  a.here,
+  a.list
+  {
+      color             : #000000;
+  }
+
+  a:target,
+  a:target *,
+  *:target a.list
+  {
+      background-color  : #FF4500 !important;
+      color             : #FFFFFF !important;
+  }
+
+  a:target,
+  *:target a.list
+  {
+      padding           : 0.1em;
+      font-weight       : bolder;
+      text-decoration   : none;
+  }
+]]>
+      </style>
+      <style type="text/css" media="all">
+      <![CDATA[body
+{
+    color               : #000000;
+    background-color    : #FFFFFF;
+    line-height         : 1.5em;
+    font-family         : Calibri, Verdana, sans-serif;
+}
+
+/* emphasis */
+
+  blockquote
+  {
+      color             : #333;
+      font-style        : italic;
+  }
+
+  em
+  {
+  }
+
+  hr
+  {
+      height            : 0;
+      border            : 0;
+      border-top        : 2px solid #FF0000;
+  }
+
+/* source code */
+
+  tt,
+  code,
+  pre
+  {
+      font-family       : Monaco, Consolas, "Lucida Console", monospace;
+      font-size         : 100%; /* appears like "size: small" otherwise */
+  }
+
+/* hyperlinks */
+
+  a > img
+  {
+      border            : none;
+  }
+
+  a img
+  {
+      _border           : none; /* for IE6 */
+  }
+
+/* lists */
+
+  #content li:first-child
+  {
+      margin-top        : 1em;
+  }
+
+  #content li
+  {
+      margin-bottom     : 1em;
+  }
+
+/* headings */
+
+  h1,
+  h2,
+  h3,
+  h4,
+  h5,
+  h6,
+  .title
+  {
+      font-weight       : lighter;
+      font-family       : Constantia, "Book Antiqua", "URW Bookman L", serif;
+  }
+
+  #lof h1,
+  #lof h2,
+  #lof h3,
+  #lof h4,
+  #lof h5,
+  #lof h6
+  {
+      margin-top        : 1.25em;
+  }
+
+  #content h1,
+  #content h2,
+  #content h3,
+  #content h4,
+  #content h5,
+  #content h6
+  {
+      margin-top        : 2.5em;
+      line-height       : 1.25em;
+  }
+
+  #content h1
+  {
+      font-size         : 2.0em;
+  }
+
+  #content h2
+  {
+      font-size         : 1.8em;
+  }
+
+  #content h3
+  {
+      font-size         : 1.6em;
+  }
+
+  #content h4
+  {
+      font-size         : 1.4em;
+  }
+
+  #content h5
+  {
+      font-size         : 1.2em;
+  }
+
+  #content h6
+  {
+      font-size         : 1.0em;
+  }
+
+/* tables */
+
+  table
+  {
+      border-collapse   : collapse; /* no spacing between cell borders */
+      margin            : auto; /* center horizontally */
+      margin-top        : 1em;
+  }
+
+  th,
+  td
+  {
+      padding           : 1em;
+      border            : 1px solid #bbb;
+      vertical-align    : top;
+      background-color  : inherit;
+      _background-color : #FFFFFF; /* for IE6 */
+  }
+
+  th
+  {
+      background-color  : #F5F5F5;
+  }
+
+/* document structure */
+
+  #nav
+  {
+      text-align        : center;
+      margin-bottom     : 4em;
+  }
+
+  #header
+  {
+      text-align        : center;
+  }
+
+  .header_outside_above,
+  #header,
+  .header_outside_below
+  {
+      margin-bottom     : 5em;
+  }
+
+  .footer_outside_above,
+  #footer,
+  .footer_outside_below
+  {
+      margin-top        : 5em;
+  }
+
+  #header .header_inside_above,
+  #footer .footer_inside_above
+  {
+      margin-bottom     : 4em;
+  }
+
+  #header .header_inside_below,
+  #footer .footer_inside_below
+  {
+      margin-top        : 4em;
+  }
+
+  #Abstract
+  {
+      margin-bottom     : 5em;
+  }
+
+  #toc li
+  {
+      list-style-type   : none;
+  }
+
+  #toc li ul
+  {
+      padding-bottom    : 1em;
+      border-left       : thick solid #F5F5F5;
+      _border-left      : none; /* for IE6 */
+  }
+
+  #toc li ul:hover
+  {
+      border-color      : #DCDCDC;
+  }
+
+  #toc > ul
+  {
+      padding-left      : 1em;
+  }
+
+  #bib
+  {
+      margin-top        : 5em;
+  }
+
+  #footer
+  {
+      border-top        : thick dotted #DCDCDC;
+      padding-top       : 1em;
+      text-align        : center;
+  }
+
+  #footer-credits
+  {
+      margin-top        : 2em;
+      margin-bottom     : 2em;
+  }
+
+/* document nodes */
+
+  .part    > .title,
+  .chapter > .title
+  {
+      padding-bottom    : 0.5em;
+  }
+
+  .part    > .title > big,
+  .chapter > .title > big
+  {
+      display           : block;
+      margin-top        : 0.25em;
+  }
+
+  .part    .title big,
+  .chapter .title big
+  {
+      _display          : block; /* for IE6 */
+      _margin-top       : 0.25em; /* for IE6 */
+      _margin-bottom    : 0.75em; /* for IE6 */
+  }
+
+  .paragraph > .title,
+  .tip       > .title,
+  .note      > .title,
+  .caution   > .title,
+  .warning   > .title,
+  .important > .title,
+  .figure    > .title,
+  .table     > .title,
+  .example   > .title,
+  .equation  > .title,
+  .procedure > .title
+  {
+      font-size         : large;
+      margin-top        : 2em;
+  }
+
+  .paragraph .title,
+  .tip       .title,
+  .note      .title,
+  .caution   .title,
+  .warning   .title,
+  .important .title,
+  .figure    .title,
+  .table     .title,
+  .example   .title,
+  .equation  .title,
+  .procedure .title
+  {
+      _font-size        : large; /* for IE6 */
+      _font-weight      : bold; /* large is not bold in IE6 */
+      _margin-top       : 2em; /* for IE6 */
+  }
+
+  .tip      ,
+  .note     ,
+  .caution  ,
+  .warning  ,
+  .important,
+  .figure   ,
+  .table    ,
+  .example  ,
+  .equation ,
+  .procedure
+  {
+      margin            : 3em;
+  }
+
+  .tip       > .content,
+  .note      > .content,
+  .caution   > .content,
+  .warning   > .content,
+  .important > .content,
+  .figure    > .content,
+  .table     > .content,
+  .example   > .content,
+  .equation  > .content,
+  .procedure > .content
+  {
+      min-height        : 48px; /* 48px is height of icon */
+  }
+
+  .tip       > .content > .icon,
+  .note      > .content > .icon,
+  .caution   > .content > .icon,
+  .warning   > .content > .icon,
+  .important > .content > .icon
+  {
+      float             : left;
+      margin            : 0 1em 1em 0; /* top right bottom left */
+  }
+
+  .tip       .content .icon,
+  .note      .content .icon,
+  .caution   .content .icon,
+  .warning   .content .icon,
+  .important .content .icon
+  {
+      _display          : none; /* IE6 cannot display embedded images */
+  }
+
+  .figure > .title
+  {
+      text-align        : center;
+  }
+
+  .figure .title
+  {
+      _text-align       : center; /* for IE6 */
+  }
+
+  .figure > .content img
+  {
+      display           : block;
+      margin            : auto;
+  }
+
+  .figure .content img
+  {
+      _display          : block; /* for IE6 */
+      _margin           : auto; /* for IE6 */
+  }
+]]>
+      </style>
+      <style type="text/css" media="print">
+      <![CDATA[/* source code */
+
+  tt
+  {
+      font-weight       : normal;
+  }
+
+  pre
+  {
+      border            : none;
+  }
+
+/* headings */
+
+  h1,
+  h2,
+  h3,
+  h4,
+  h5,
+  h6
+  {
+      font-weight       : normal;
+      clear             : both;
+  }
+
+/* hyperlinks */
+
+  /* blend all hyperlinks with normal text */
+  a:link,
+  a:visited
+  {
+      color             : #000000;
+      text-decoration   : none;
+  }
+
+  /* emphasize external and cross-reference hyperlinks */
+  a:not([href^="#"]):link,
+  a:not([href^="#"]):visited,
+  a.xref[title]:link,
+  a.xref[title]:visited
+  {
+      color             : #0000FF;
+      text-decoration   : underline;
+      font-weight       : bolder;
+  }
+
+  /* show URL of destination for external hyperlinks */
+  a:not([href^="#"]):after
+  {
+      content           : " " attr(href);
+      font-family       : Monaco, Consolas, "Lucida Console", monospace;
+  }
+
+  /* show name of destination for cross-references */
+  a.xref[title]:after
+  {
+      content           : " " attr(title);
+  }
+
+  a:after
+  {
+      font-weight       : normal;
+      font-size         : smaller;
+  }
+
+/* document structure */
+
+  #nav,
+  #lof
+  {
+      display           : none;
+  }
+
+  #toc,
+  .part,
+  .chapter,
+  #bib
+  {
+      page-break-before : always;
+  }
+
+/* document nodes */
+
+  .part    > .title > big,
+  .chapter > .title > big
+  {
+      padding-bottom    : 0.5em;
+  }
+
+  .part    .title big,
+  .chapter .title big
+  {
+      _padding-bottom   : 0.5em; /* for IE6 */
+  }
+]]>
+      </style>
+
+    <style type="text/css" media="screen">
+    <![CDATA[
+      /* decorate external hyperlinks with a visual indicator */
+      a:not([href^="#"])
+      {
+          color               : #3366BB;
+          background          : url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAoAAAAKCAMAAAC67D+PAAAAFVBMVEVmmcwzmcyZzP8AZswAZv////////9E6giVAAAAB3RSTlP///////8AGksDRgAAADhJREFUGFcly0ESAEAEA0Ei6/9P3sEcVB8kmrwFyni0bOeyyDpy9JTLEaOhQq7Ongf5FeMhHS/4AVnsAZubxDVmAAAAAElFTkSuQmCC");
+          background-position : center right;
+          background-repeat   : no-repeat;
+          padding-right       : 13px;
+      }
+
+      /* display icon for blockquote elements */
+      blockquote
+      {
+          background-image    : url("data:image/png;base64,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");
+          background-repeat   : no-repeat;
+          margin-left         : 0;
+          padding-left        : 65px;
+          min-height          : 50px;
+      }
+    ]]>
+    </style>
+  </head>
+  <body>
+    <div id="nav">
+      <a href="#Abstract">Abstract</a> &middot; <a href="#Contents">Contents</a> &middot; <a href="#Cautions">Cautions</a> &middot; <a href="#Equations">Equations</a> &middot; <a href="#Examples">Examples</a> &middot; <a href="#Figures">Figures</a> &middot; <a href="#Importants">Importants</a> &middot; <a href="#Notes">Notes</a> &middot; <a href="#Procedures">Procedures</a> &middot; <a href="#Tables">Tables</a> &middot; <a href="#Tips">Tips</a> &middot; <a href="#Warnings">Warnings</a> &middot; <a href="#References">References</a>
+    </div>
+
+    <br style="display: none"/>
+    <hr style="display: none"/>
+    <br style="display: none"/>
+
+    
+    <div id="header">
+    
+      <p><img src='erbook.png' alt='erbook logo' /></p>
+      <h1 class="title">erbook 5.0.0 user manual</h1>
+      <h2 class="authors"><a href="http://snk.tuxfamily.org">Suraj N. Kurapati</a></h2>
+      <h3 class="date">22 November 2008</h3>
+    
+    </div>
+    
+
+    <div id="Abstract">
+  <h1 class="title"><a class="here" title="Permanent link to this section" href="#Abstract">Abstract</a></h1>
+  <div class="content"><p>erbook is an extensible document processor that emits <a class="xref" href="#xhtml" title="Chapter 5.1. XHTML (web page)">XHTML (web page)</a>, <a class="xref" href="#latex" title="Chapter 5.3. LaTeX (PDF)">LaTeX (PDF)</a>, <a class="xref" href="#man" title="Chapter 5.4. man (UNIX manual page)">man (UNIX manual page)</a>, <a class="xref" href="#text" title="Chapter 5.2. Plain text">plain text</a>, and <a class="xref" href="#HelloWorld" title="Section 3.2.3. Creating your own document format">any document format you can imagine</a> from <a href='http://en.wikipedia.org/wiki/ERuby'>eRuby templates</a> that allow scripting and dynamic content generation. <span style='float: right; font-size: larger'><a class="xref" href="#Introduction" title="Chapter 1. Introduction">Read more&#8230;</a></span></p>
+
+<p><div class="paragraph">
+  <p class="title"><a class="here" title="Permanent link to this section" href="#Resources">Resources</a></p>
+  <div class="content"><ul>
+<li><a href='http://snk.tuxfamily.org/lib/erbook/log'>Release notes</a> &#8212; news of project releases. <a href='http://snk.tuxfamily.org/lib/erbook/ann'><img src='feed-icon-28x28.png' alt='RSS feed' /></a></li>
+
+<li><a href='http://snk.tuxfamily.org/lib/erbook/pkg'>Downloads</a> &#8212; obtain the newest release package.</li>
+
+<li><a href='http://snk.tuxfamily.org/lib/erbook/src'>Source code</a> &#8212; obtain via <a href='http://git.or.cz'>Git</a> or browse online. <a href='http://snk.tuxfamily.org/lib/erbook/dev'><img src='feed-icon-28x28.png' alt='RSS feed' /></a></li>
+
+<li><a href='api/index.html'>API reference</a> &#8212; documentation for source code.</li>
+</ul>
+
+<p>To get help or provide feedback, simply <a class="xref" href="#License" title="Section 1.2.2. License">contact the author</a>.</p></div>
+</div></p></div>
+</div>
+
+    <br style="display: none"/>
+    <hr style="display: none"/>
+    <br style="display: none"/>
+
+      <div id="toc">
+        <h1 class="title" id="Contents"><a class="here" href="#Contents">Contents</a></h1>
+        <ul>
+          <li>1&nbsp;&nbsp;<a id="rev:Introduction" href="#Introduction">Introduction</a><ul><li>1.1&nbsp;&nbsp;<a id="rev:Relevance" href="#Relevance">Relevance</a><ul><li>1.1.1&nbsp;&nbsp;<a id="rev:Reviews" href="#Reviews">Reviews</a></li></ul></li><li>1.2&nbsp;&nbsp;<a id="rev:Logistics" href="#Logistics">Logistics</a><ul><li>1.2.1&nbsp;&nbsp;<a id="rev:Credits" href="#Credits">Credits</a></li><li>1.2.2&nbsp;&nbsp;<a id="rev:License" href="#License">License</a></li><li>1.2.3&nbsp;&nbsp;<a id="rev:Version-numbers" href="#Version-numbers">Version numbers</a></li></ul></li></ul></li><li>2&nbsp;&nbsp;<a id="rev:Setup" href="#Setup">Setup</a><ul><li>2.1&nbsp;&nbsp;<a id="rev:Requirements" href="#Requirements">Requirements</a></li><li>2.2&nbsp;&nbsp;<a id="rev:Installation" href="#Installation">Installation</a></li><li>2.3&nbsp;&nbsp;<a id="rev:Manifest" href="#Manifest">Manifest</a></li></ul></li><li>3&nbsp;&nbsp;<a id="rev:Theory-of-operation" href="#Theory-of-operation">Theory of operation</a><ul><li>3.1&nbsp;&nbsp;<a id="rev:Nodes" href="#Nodes">Nodes</a><ul><li>3.1.1&nbsp;&nbsp;<a id="rev:Node.class" href="#Node.class">The <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code> class</a></li></ul></li><li>3.2&nbsp;&nbsp;<a id="rev:SpecFile" href="#SpecFile">Format specification file</a><ul><li>3.2.1&nbsp;&nbsp;<a id="rev:SpecFile.nodes" href="#SpecFile.nodes">Node definition</a><ul><li>3.2.1.1&nbsp;&nbsp;<a id="rev:SpecFile.nodes.output" href="#SpecFile.nodes.output">Node output template</a></li></ul></li><li>3.2.2&nbsp;&nbsp;<a id="rev:SpecFile.output" href="#SpecFile.output">Document output template</a></li><li>3.2.3&nbsp;&nbsp;<a id="rev:HelloWorld" href="#HelloWorld">Creating your own document format</a></li></ul></li></ul></li><li>4&nbsp;&nbsp;<a id="rev:Usage" href="#Usage">Usage</a><ul><li>4.1&nbsp;&nbsp;<a id="rev:Command-line-invocation" href="#Command-line-invocation">Command-line invocation</a></li><li>4.2&nbsp;&nbsp;<a id="rev:include" href="#include">Including external documents</a></li><li>4.3&nbsp;&nbsp;<a id="rev:Unindenting-nodes-hierarchically" href="#Unindenting-nodes-hierarchically">Unindenting nodes hierarchically</a></li></ul></li><li>5&nbsp;&nbsp;<a id="rev:Formats" href="#Formats">Formats</a><ul><li>5.1&nbsp;&nbsp;<a id="rev:xhtml" href="#xhtml">XHTML (web page)</a><ul><li>5.1.1&nbsp;&nbsp;<a id="rev:Text-to-XHTML-conversion" href="#Text-to-XHTML-conversion">Text to XHTML conversion</a><ul><li>5.1.1.1&nbsp;&nbsp;<a id="rev:Syntax-coloring-for-source-code" href="#Syntax-coloring-for-source-code">Syntax coloring for source code</a><ul><li>5.1.1.1.1&nbsp;&nbsp;<a id="rev:Specifying-the-programming-language" href="#Specifying-the-programming-language">Specifying the programming language</a></li></ul></li><li>5.1.1.2&nbsp;&nbsp;<a id="rev:Smart-sizing-of-source-code" href="#Smart-sizing-of-source-code">Smart sizing of source code</a></li><li>5.1.1.3&nbsp;&nbsp;<a id="rev:Protecting-verbatim-text" href="#Protecting-verbatim-text">Protecting verbatim text</a></li></ul></li><li>5.1.2&nbsp;&nbsp;<a id="rev:Parameters" href="#Parameters">Parameters</a></li><li>5.1.3&nbsp;&nbsp;<a id="rev:Methods" href="#Methods">Methods</a><ul><li>5.1.3.1&nbsp;&nbsp;<a id="rev:a-ERBook::Node-title" href="#a-ERBook::Node-title"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#title()</span></code></a></li><li>5.1.3.2&nbsp;&nbsp;<a id="rev:a-ERBook::Node-id" href="#a-ERBook::Node-id"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#id()</span></code></a></li><li>5.1.3.3&nbsp;&nbsp;<a id="rev:a-ERBook::Node-title_xhtml" href="#a-ERBook::Node-title_xhtml"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#title_xhtml()</span></code></a></li><li>5.1.3.4&nbsp;&nbsp;<a id="rev:a-ERBook::Node-content_xhtml" href="#a-ERBook::Node-content_xhtml"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#content_xhtml()</span></code></a></li><li>5.1.3.5&nbsp;&nbsp;<a id="rev:a-ERBook::Node-title_link-aTitle-nil" href="#a-ERBook::Node-title_link-aTitle-nil"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#title_link(aTitle = nil)</span></code></a></li><li>5.1.3.6&nbsp;&nbsp;<a id="rev:a-ERBook::Node-index_link" href="#a-ERBook::Node-index_link"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#index_link()</span></code></a></li><li>5.1.3.7&nbsp;&nbsp;<a id="rev:a-ERBook::Node-number_link" href="#a-ERBook::Node-number_link"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#number_link()</span></code></a></li><li>5.1.3.8&nbsp;&nbsp;<a id="rev:a-Hash-to_xml_atts" href="#a-Hash-to_xml_atts"><code class="code"><span style="color:#036;font-weight:bold">Hash</span><span style="color:#666">#to_xml_atts()</span></code></a></li><li>5.1.3.9&nbsp;&nbsp;<a id="rev:a-ERBook::Template-verbatim-aContent" href="#a-ERBook::Template-verbatim-aContent"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Template</span><span style="color:#666">#verbatim(aContent)</span></code></a></li><li>5.1.3.10&nbsp;&nbsp;<a id="rev:a-ERBook::Template-hyperlink-aUrl-aLabel-aUrl-aTitle-nil" href="#a-ERBook::Template-hyperlink-aUrl-aLabel-aUrl-aTitle-nil"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Template</span><span style="color:#666">#hyperlink(aUrl, aLabel = aUrl, aTitle = nil)</span></code></a></li><li>5.1.3.11&nbsp;&nbsp;<a id="rev:a-ERBook::Template-embed_image_file-aPath-aFormat-aPath-w-aAtts" href="#a-ERBook::Template-embed_image_file-aPath-aFormat-aPath-w-aAtts"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Template</span><span style="color:#666">#embed_image_file(aPath, aFormat = aPath[/\w+/], aAtts = {})</span></code></a></li><li>5.1.3.12&nbsp;&nbsp;<a id="rev:a-ERBook::Template-embed_image_data-aData-aFormat-aAtts" href="#a-ERBook::Template-embed_image_data-aData-aFormat-aAtts"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Template</span><span style="color:#666">#embed_image_data(aData, aFormat, aAtts = {})</span></code></a></li><li>5.1.3.13&nbsp;&nbsp;<a id="rev:a-String-to_xml_entities" href="#a-String-to_xml_entities"><code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_xml_entities()</span></code></a></li><li>5.1.3.14&nbsp;&nbsp;<a id="rev:a-String-to_uri_fragment" href="#a-String-to_uri_fragment"><code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_uri_fragment()</span></code></a></li><li>5.1.3.15&nbsp;&nbsp;<a id="rev:a-String-to_inline_xhtml" href="#a-String-to_inline_xhtml"><code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_inline_xhtml()</span></code></a></li><li>5.1.3.16&nbsp;&nbsp;<a id="rev:a-String-to_xhtml-aInline-false" href="#a-String-to_xhtml-aInline-false"><code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_xhtml(aInline = false)</span></code></a></li></ul></li><li>5.1.4&nbsp;&nbsp;<a id="rev:xhtml.nodes" href="#xhtml.nodes">Nodes</a><ul><li>5.1.4.1&nbsp;&nbsp;<a id="rev:Structural-nodes" href="#Structural-nodes">Structural nodes</a><ul><li>5.1.4.1.1&nbsp;&nbsp;<a id="rev:xhtml.nodes.header" href="#xhtml.nodes.header">header</a></li><li>5.1.4.1.2&nbsp;&nbsp;<a id="rev:xhtml.nodes.footer" href="#xhtml.nodes.footer">footer</a></li><li>5.1.4.1.3&nbsp;&nbsp;<a id="rev:xhtml.nodes.abstract" href="#xhtml.nodes.abstract">abstract</a></li><li>5.1.4.1.4&nbsp;&nbsp;<a id="rev:xhtml.nodes.xref" href="#xhtml.nodes.xref">xref</a></li></ul></li><li>5.1.4.2&nbsp;&nbsp;<a id="rev:Organizational-nodes" href="#Organizational-nodes">Organizational nodes</a><ul><li>5.1.4.2.1&nbsp;&nbsp;<a id="rev:xhtml.nodes.part" href="#xhtml.nodes.part">part</a><ul><li>5.1.4.2.1.1&nbsp;&nbsp;<a id="rev:An-example" href="#An-example">An example</a></li></ul></li><li>5.1.4.2.2&nbsp;&nbsp;<a id="rev:xhtml.nodes.chapter" href="#xhtml.nodes.chapter">chapter</a><ul><li>5.1.4.2.2.1&nbsp;&nbsp;<a id="rev:An-example-5.1.4.2.2.1" href="#An-example-5.1.4.2.2.1">An example</a></li></ul></li><li>5.1.4.2.3&nbsp;&nbsp;<a id="rev:xhtml.nodes.section" href="#xhtml.nodes.section">section</a><ul><li>5.1.4.2.3.1&nbsp;&nbsp;<a id="rev:An-example-5.1.4.2.3.1" href="#An-example-5.1.4.2.3.1">An example</a></li></ul></li><li>5.1.4.2.4&nbsp;&nbsp;<a id="rev:xhtml.nodes.paragraph" href="#xhtml.nodes.paragraph">paragraph</a></li></ul></li><li>5.1.4.3&nbsp;&nbsp;<a id="rev:Admonition-nodes" href="#Admonition-nodes">Admonition nodes</a><ul><li>5.1.4.3.1&nbsp;&nbsp;<a id="rev:xhtml.nodes.warning" href="#xhtml.nodes.warning">warning</a></li><li>5.1.4.3.2&nbsp;&nbsp;<a id="rev:xhtml.nodes.caution" href="#xhtml.nodes.caution">caution</a></li><li>5.1.4.3.3&nbsp;&nbsp;<a id="rev:xhtml.nodes.important" href="#xhtml.nodes.important">important</a></li><li>5.1.4.3.4&nbsp;&nbsp;<a id="rev:xhtml.nodes.note" href="#xhtml.nodes.note">note</a></li><li>5.1.4.3.5&nbsp;&nbsp;<a id="rev:xhtml.nodes.tip" href="#xhtml.nodes.tip">tip</a></li></ul></li><li>5.1.4.4&nbsp;&nbsp;<a id="rev:Auxilary-materials" href="#Auxilary-materials">Auxilary materials</a><ul><li>5.1.4.4.1&nbsp;&nbsp;<a id="rev:xhtml.nodes.figure" href="#xhtml.nodes.figure">figure</a></li><li>5.1.4.4.2&nbsp;&nbsp;<a id="rev:xhtml.nodes.table" href="#xhtml.nodes.table">table</a></li><li>5.1.4.4.3&nbsp;&nbsp;<a id="rev:xhtml.nodes.example" href="#xhtml.nodes.example">example</a></li><li>5.1.4.4.4&nbsp;&nbsp;<a id="rev:xhtml.nodes.equation" href="#xhtml.nodes.equation">equation</a></li><li>5.1.4.4.5&nbsp;&nbsp;<a id="rev:xhtml.nodes.procedure" href="#xhtml.nodes.procedure">procedure</a></li></ul></li><li>5.1.4.5&nbsp;&nbsp;<a id="rev:Bibliographical-nodes" href="#Bibliographical-nodes">Bibliographical nodes</a><ul><li>5.1.4.5.1&nbsp;&nbsp;<a id="rev:xhtml.nodes.reference" href="#xhtml.nodes.reference">reference</a></li><li>5.1.4.5.2&nbsp;&nbsp;<a id="rev:xhtml.nodes.cite" href="#xhtml.nodes.cite">cite</a></li></ul></li></ul></li></ul></li><li>5.2&nbsp;&nbsp;<a id="rev:text" href="#text">Plain text</a></li><li>5.3&nbsp;&nbsp;<a id="rev:latex" href="#latex">LaTeX (PDF)</a></li><li>5.4&nbsp;&nbsp;<a id="rev:man" href="#man">man (UNIX manual page)</a></li></ul></li>
+
+          <li><a href="#References">References</a></li>
+        </ul>
+      </div>
+
+      <div id="lof"><h2 id="Cautions" class="title"><a class="here" href="#Cautions">Cautions</a></h2> <ol><li><a id="rev:An-example-1-1" href="#An-example-1-1">An example</a></li></ol><h2 id="Equations" class="title"><a class="here" href="#Equations">Equations</a></h2> <ol><li><a id="rev:An-example-1-1-1-1-1-1" href="#An-example-1-1-1-1-1-1">An example</a></li></ol><h2 id="Examples" class="title"><a class="here" href="#Examples">Examples</a></h2> <ol><li><a id="rev:HelloWorld.spec" href="#HelloWorld.spec">HelloWorld format specification file</a></li><li><a id="rev:HelloWorld.input" href="#HelloWorld.input">Input document for HelloWorld format</a></li><li><a id="rev:HelloWorld.output" href="#HelloWorld.output">Output of HelloWorld format</a></li><li><a id="rev:An-example-4" href="#An-example-4">An example</a></li></ol><h2 id="Figures" class="title"><a class="here" href="#Figures">Figures</a></h2> <ol><li><a id="rev:An-example-1-1-1-1" href="#An-example-1-1-1-1">An example</a></li></ol><h2 id="Importants" class="title"><a class="here" href="#Importants">Importants</a></h2> <ol><li><a id="rev:Save-XHTML-output-as-.xhtml" href="#Save-XHTML-output-as-.xhtml">Save XHTML output as <tt>.xhtml</tt></a></li><li><a id="rev:An-example-2" href="#An-example-2">An example</a></li></ol><h2 id="Notes" class="title"><a class="here" href="#Notes">Notes</a></h2> <ol><li><a id="rev:See-the-source-of-this-manual" href="#See-the-source-of-this-manual">See the source of this manual</a></li><li><a id="rev:An-example-2-2" href="#An-example-2-2">An example</a></li></ol><h2 id="Procedures" class="title"><a class="here" href="#Procedures">Procedures</a></h2> <ol><li><a id="rev:An-example-1-1-1-1-1-1-1" href="#An-example-1-1-1-1-1-1-1">An example</a></li></ol><h2 id="Tables" class="title"><a class="here" href="#Tables">Tables</a></h2> <ol><li><a id="rev:An-example-1-1-1-1-1" href="#An-example-1-1-1-1-1">An example</a></li></ol><h2 id="Tips" class="title"><a class="here" href="#Tips">Tips</a></h2> <ol><li><a id="rev:An-example-1-1-1" href="#An-example-1-1-1">An example</a></li></ol><h2 id="Warnings" class="title"><a class="here" href="#Warnings">Warnings</a></h2> <ol><li><a id="rev:An-example-1" href="#An-example-1">An example</a></li></ol></div>
+
+    <br style="display: none"/>
+    <hr style="display: none"/>
+    <br style="display: none"/>
+
+    <div id="content">
+
+<div class="chapter">
+  <h1 class="title">
+    Chapter&nbsp;<a class="list" title="Return to table of contents" id="Introduction" href="#rev:Introduction">1</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#Introduction">Introduction</a></big>
+  </h1>
+  <div class="content"><p>erbook is an extensible document processor that emits <a class="xref" href="#xhtml" title="Chapter 5.1. XHTML (web page)">XHTML (web page)</a>, <a class="xref" href="#latex" title="Chapter 5.3. LaTeX (PDF)">LaTeX (PDF)</a>, <a class="xref" href="#man" title="Chapter 5.4. man (UNIX manual page)">man (UNIX manual page)</a>, <a class="xref" href="#text" title="Chapter 5.2. Plain text">plain text</a>, and <a class="xref" href="#HelloWorld" title="Section 3.2.3. Creating your own document format">any document format you can imagine</a> from <a href='http://en.wikipedia.org/wiki/ERuby'>eRuby templates</a> that allow scripting and dynamic content generation.</p>
+
+<p><div class="note">
+  <p class="title"><a class="list" title="Return to table of contents" id="See-the-source-of-this-manual" href="#rev:See-the-source-of-this-manual">Note 1</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#See-the-source-of-this-manual">See the source of this manual</a></p>
+  <div class="content"><img class="icon" src="&icon_note;" alt="note"/><p>Did you know that this manual was generated by erbook? Here is <a href='manual.erb'>the source document</a> to prove it!</p></div>
+</div> <div class="section">
+  <h2 class="title">
+    <a class="list" title="Return to table of contents" id="Relevance" href="#rev:Relevance">1.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Relevance">Relevance</a>
+  </h2>
+  <div class="content"><p>Unlike document processors such as <a href='http://www.docbook.org'>DocBook</a>, <a href='http://deplate.sourceforge.net'>Deplate</a>, and <a href='http://www.jus.uio.no/sisu/SiSU/'>SiSU</a>, erbook is:</p>
+
+<ul>
+<li><em>tiny</em> because its core contains less than 210 source lines of code</li>
+
+<li><em>extensible</em> because it lets you define <a class="xref" href="#HelloWorld" title="Section 3.2.3. Creating your own document format">your own custom document format</a></li>
+</ul>
+
+<p>Unlike the documents of raw text processors such as <a href='http://www.methods.co.nz/asciidoc/'>AsciiDoc</a>, <a href='http://txt2tags.sourceforge.net'>txt2tags</a>, and <a href='http://www.triptico.com/software/grutatxt.html'>Grutatxt</a>, erbook documents are <em>scriptable</em> eRuby templates, which means that you can inject arbitrary Ruby code into your documents for <strong>dynamic content generation</strong>.</p>
+
+<p><div class="section">
+  <h3 class="title">
+    <a class="list" title="Return to table of contents" id="Reviews" href="#rev:Reviews">1.1.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Reviews">Reviews</a>
+  </h3>
+  <div class="content"><p>Vitor Peres in <a href='http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/283052'>ruby-talk</a>:</p>
+
+<blockquote>
+<p>I actually felt like printing [this manual], because it&#8217;s just so well-thought typographically&#8230; Even if [erbook] weren&#8217;t great by itself, I&#8217;d feel good just looking at the manual.</p>
+</blockquote>
+
+<p>Ara T. Howard in <a href='http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/282949'>ruby-talk</a>:</p>
+
+<blockquote>
+<p>[this manual is] a insanely complete and nice looking bit of documentation [&#8230; erbook] looks like a great project</p>
+</blockquote>
+
+<p>Martin DeMello in <a href='http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/283304'>ruby-talk</a>:</p>
+
+<blockquote>
+<p>Very nice work indeed!</p>
+</blockquote></div>
+</div></p></div>
+</div> <div class="section">
+  <h2 class="title">
+    <a class="list" title="Return to table of contents" id="Logistics" href="#rev:Logistics">1.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Logistics">Logistics</a>
+  </h2>
+  <div class="content"><p>erbook is <a class="xref" href="#License" title="Section 1.2.2. License">open source software</a> so feel free to contribute your improvements and discuss your ideas <a class="xref" href="#License" title="Section 1.2.2. License">with the author</a>. You can obtain the source code from <a href='http://snk.tuxfamily.org/lib/erbook/src'>this source repository</a> and monitor for changes by subscribing to <a href='http://snk.tuxfamily.org/lib/erbook/dev'>this news feed</a>.</p>
+
+<p><div class="section">
+  <h3 class="title">
+    <a class="list" title="Return to table of contents" id="Credits" href="#rev:Credits">1.2.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Credits">Credits</a>
+  </h3>
+  <div class="content"><p>The erbook logo, its image file &#8220;erbook.png&#8221;, and its source file &#8220;erbook.svg&#8221; make use of the <a href='http://openclipart.org/media/files/lemmling/9065'>&#8220;cartoon owl sitting on a book&#8221;</a> graphic, which was created and released into the public domain by <a href='http://openclipart.org/media/people/lemmling'>Jens Vierbuchen</a> on July 7, 2008.</p></div>
+</div> <div class="section">
+  <h3 class="title">
+    <a class="list" title="Return to table of contents" id="License" href="#rev:License">1.2.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#License">License</a>
+  </h3>
+  <div class="content"><p>Copyright 2006 Suraj N. Kurapati <a href='mailto:sunaku@gmail.com'>&#115;&#117;&#110;&#097;&#107;&#117;&#064;&#103;&#109;&#097;&#105;&#108;&#046;&#099;&#111;&#109;</a></p>
+
+<p>Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.</p>
+
+<p>THE SOFTWARE IS PROVIDED &#8220;AS IS&#8221; AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.</p></div>
+</div> <div class="section">
+  <h3 class="title">
+    <a class="list" title="Return to table of contents" id="Version-numbers" href="#rev:Version-numbers">1.2.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Version-numbers">Version numbers</a>
+  </h3>
+  <div class="content"><p>erbook releases are numbered in <em>major.minor.patch</em> form, according to the <a href='http://www.rubygems.org/read/chapter/7'>RubyGems rational versioning policy</a> which can be <a href='http://ablog.apress.com/?p=738'>summarized</a> thus:</p>
+<table border="1">
+  <thead>
+    <tr>
+      <td rowspan='2'>What increased in the version number?</td>
+      <td colspan='3'>What does the increase signify about the release?</td>
+    </tr>
+    <tr>
+      <th>Backwards compatible?</th>
+      <th>New features?</th>
+      <th>Bug fixes?</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <th>major</th>
+      <td style='background-color: #FFE4E1;'>No</td>
+      <td>Yes</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <th>minor</th>
+      <td>Yes</td>
+      <td>Yes</td>
+      <td>Yes</td>
+    </tr>
+    <tr>
+      <th>patch</th>
+      <td>Yes</td>
+      <td style='background-color: #FFE4E1;'>No</td>
+      <td>Yes</td>
+    </tr>
+  </tbody>
+</table></div>
+</div></p></div>
+</div></p></div>
+</div>
+<div class="chapter">
+  <h1 class="title">
+    Chapter&nbsp;<a class="list" title="Return to table of contents" id="Setup" href="#rev:Setup">2</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#Setup">Setup</a></big>
+  </h1>
+  <div class="content"><p><div class="section">
+  <h2 class="title">
+    <a class="list" title="Return to table of contents" id="Requirements" href="#rev:Requirements">2.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Requirements">Requirements</a>
+  </h2>
+  <div class="content"><p>Your system needs the following software to run erbook.</p>
+<table border="1"><thead><tr><th>Software</th><th>Description</th><th>Notes</th></tr></thead><tbody><tr><td style='text-align: left;'><a href='http://ruby-lang.org'>Ruby</a></td><td style='text-align: left;'>Ruby language interpreter</td><td style='text-align: left;'>Version 1.8.x is required.</td>
+</tr><tr><td style='text-align: left;'><a href='http://maruku.rubyforge.org'>Maruku</a></td><td style='text-align: left;'>Markdown processor</td><td style='text-align: left;'>Required by the <a class="xref" href="#xhtml" title="Chapter 5.1. XHTML (web page)">default XHTML format</a>.</td>
+</tr><tr><td style='text-align: left;'><a href='http://coderay.rubychan.de'>CodeRay</a></td><td style='text-align: left;'>Syntax highlighter</td><td style='text-align: left;'>Required by the <a class="xref" href="#xhtml" title="Chapter 5.1. XHTML (web page)">default XHTML format</a>.</td>
+</tr><tr><td style='text-align: left;'><a href='http://trollop.rubyforge.org'>Trollop</a></td><td style='text-align: left;'>Command-line option parser</td><td style='text-align: left;'>Required by the <em>erbook</em> executable.</td>
+</tr></tbody></table>
+<p>If your system has <a href='http://rubygems.org'>RubyGems</a>, then you can install Maruku and CodeRay by running the following command:</p>
+
+<pre>gem install trollop maruku coderay</pre></div>
+</div> <div class="section">
+  <h2 class="title">
+    <a class="list" title="Return to table of contents" id="Installation" href="#rev:Installation">2.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Installation">Installation</a>
+  </h2>
+  <div class="content"><p>If your system has <a href='http://rubygems.org'>RubyGems</a>, then you can install erbook by running the following commands:</p>
+
+<pre>gem install erbook
+erbook -v</pre>
+
+<p>Otherwise, follow these instructions:</p>
+
+<ol>
+<li>
+<p>Download the newest release package from <a href='http://snk.tuxfamily.org/lib/erbook/pkg'>the download area</a>.</p>
+</li>
+
+<li>
+<p>Extract the release package somewhere on your system.</p>
+</li>
+
+<li>
+<p>Go inside the extracted directory and run the following command:</p>
+
+<pre>ruby bin/erbook -v</pre>
+</li>
+</ol>
+
+<p>If the installation was successful, then you will see output like this: <pre>project: erbook
+version: 5.0.0
+release: 2008-11-22
+website: http://snk.tuxfamily.org/lib/erbook
+install: /home/sun/src/erbook
+</pre></p>
+
+<p>Otherwise, you can <a class="xref" href="#License" title="Section 1.2.2. License">contact the author</a> for help.</p></div>
+</div> <div class="section">
+  <h2 class="title">
+    <a class="list" title="Return to table of contents" id="Manifest" href="#rev:Manifest">2.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Manifest">Manifest</a>
+  </h2>
+  <div class="content"><p>You will see the following items inside erbook&#8217;s installation directory, whose path you can determine by running this command:</p>
+
+<pre>erbook -v</pre>
+
+<ul>
+<li>
+<p><tt>bin/</tt> &#8212; contains executable programs.</p>
+
+<ul>
+<li><tt>erbook</tt> &#8212; core logic of erbook.</li>
+</ul>
+</li>
+
+<li>
+<p><tt>fmt/</tt> &#8212; contains the predefined set of <a class="xref" href="#SpecFile" title="Section 3.2. Format specification file">format specification files</a>. If you ever need to install your custom format specification file globally, then put it inside this directory.</p>
+</li>
+
+<li>
+<p><tt>latex.yaml</tt> &#8212; high-quality typesetting</p>
+</li>
+
+<li>
+<p><tt>man.yaml</tt> &#8212; manual page for UNIX</p>
+</li>
+
+<li>
+<p><tt>xhtml.yaml</tt> &#8212; web page for the Internet</p>
+</li>
+
+<li>
+<p><tt>text.yaml</tt> &#8212; plain text, nothing fancy</p>
+</li>
+
+<li>
+<p><tt>lib/</tt> &#8212; erbook automatically adds this directory to Ruby&#8217;s load path.</p>
+
+<ul>
+<li>
+<p><tt>erbook.rb</tt> &#8212; project version information.</p>
+</li>
+
+<li>
+<p><tt>erbook/</tt></p>
+
+<ul>
+<li>
+<p><tt>to_xhtml.rb</tt> &#8212; provides methods (see <a class="xref" href="#Text-to-XHTML-conversion">Section 5.1.1. Text to XHTML conversion</a>) for the <a class="xref" href="#xhtml">Chapter 5.1. XHTML (web page)</a> format.</p>
+</li>
+
+<li>
+<p><tt>rdoc.rb</tt> &#8212; provides RDoc parse trees to Ruby code.</p>
+</li>
+</ul>
+</li>
+</ul>
+</li>
+
+<li>
+<p><tt>doc/</tt> &#8212; contains this manual and other documentation.</p>
+
+<ul>
+<li>
+<p><tt>erbook.svg</tt> &#8212; source file of the erbook logo.</p>
+</li>
+
+<li>
+<p><tt>manual.erb</tt> &#8212; source file of this manual.</p>
+</li>
+
+<li>
+<p><tt>api/</tt> &#8212; contains API reference documentation for the provided Ruby code.</p>
+</li>
+</ul>
+</li>
+
+<li>
+<p><tt>LICENSE</tt> &#8212; project license and copyright notice.</p>
+</li>
+</ul></div>
+</div></p></div>
+</div>
+<div class="chapter">
+  <h1 class="title">
+    Chapter&nbsp;<a class="list" title="Return to table of contents" id="Theory-of-operation" href="#rev:Theory-of-operation">3</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#Theory-of-operation">Theory of operation</a></big>
+  </h1>
+  <div class="content"><p>When you run erbook, it does the following:</p>
+
+<ol>
+<li>
+<p>Loads the <a class="xref" href="#SpecFile" title="Section 3.2. Format specification file">format specification file</a>.</p>
+</li>
+
+<li>
+<p>Creates an <strong>input document</strong> by:</p>
+
+<ul>
+<li>
+<p>Reading the input (the content of either the input file or the standard input stream) into memory.</p>
+</li>
+
+<li>
+<p>Evaluating <a class="xref" href="#include" title="Section 4.2. Including external documents">include directives</a> in the input.</p>
+</li>
+</ul>
+</li>
+
+<li>
+<p>Transforms the input document into a <strong>processed document</strong> by:</p>
+
+<ul>
+<li>
+<p>Building a <strong>document tree</strong> data structure from <a class="xref" href="#Nodes" title="Section 3.1. Nodes">nodes</a> present in the input document.</p>
+</li>
+
+<li>
+<p>Replacing every node in the input document with the result of its <a class="xref" href="#SpecFile.nodes.output" title="Section 3.2.1.1. Node output template">node output template</a>.</p>
+</li>
+</ul>
+</li>
+
+<li>
+<p>Transforms the processed document into an <strong>output document</strong> according to the <a class="xref" href="#SpecFile.output" title="Section 3.2.2. Document output template">document output template</a>.</p>
+</li>
+
+<li>
+<p>Prints the output document to the standard output stream.</p>
+</li>
+</ol>
+
+<p>Although there is only one document being processed here, we refer to it using three distinct terms: <strong>input</strong>, <strong>processed</strong>, and <strong>output</strong>; because the content of the document changes radically with every transformation.</p>
+
+<p><div class="section">
+  <h2 class="title">
+    <a class="list" title="Return to table of contents" id="Nodes" href="#rev:Nodes">3.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Nodes">Nodes</a>
+  </h2>
+  <div class="content"><p>A node is a block of text that appears like this:</p>
+
+<pre>&lt;% node_type node_argument1, node_argument2, ... do |node_object| %&gt;
+  node_content
+&lt;% end %&gt;</pre>
+
+<p>Or like this:</p>
+
+<pre>&lt;% node_type node_argument1, node_argument2, ... do %&gt;
+  node_content
+&lt;% end %&gt;</pre>
+
+<p>Or like this:</p>
+
+<pre>&lt;%= node_type node_argument1, node_argument2, ... %&gt;</pre>
+
+<p>Alternatively, you may omit the leading &#8221;&lt;&#8221; and trailing &#8220;%&gt;&#8221; characters from an eRuby directive if the directive spans an <em>entire</em> line. So, the above examples become:</p>
+
+<pre>% node_type node_argument1, node_argument2, ... do |node_object|
+  node_content
+% end</pre>
+
+<p>And:</p>
+
+<pre>% node_type node_argument1, node_argument2, ... do
+  node_content
+% end</pre>
+
+<p>And:</p>
+
+<pre>%= node_type node_argument1, node_argument2, ...</pre>
+
+<p>Technically, nodes are Ruby method invocations composed of the following:</p>
+<table border="1"><thead><tr><th>Component</th><th>Description</th></tr></thead><tbody><tr><td style='text-align: left;'><code class="code">node_type</code></td><td style='text-align: left;'>name of the method being invoked</td>
+</tr><tr><td style='text-align: left;'><code class="code">node_argument1, node_argument2, ...</code></td><td style='text-align: left;'>arguments for the method invocation</td>
+</tr><tr><td style='text-align: left;'><code class="code">node_content</code></td><td style='text-align: left;'>a block argument being passed to the method invocation</td>
+</tr><tr><td style='text-align: left;'><code class="code">node_object</code></td><td style='text-align: left;'>a <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code> object (see <a class="xref" href="#Node.class">Section 3.1.1. The <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code> class</a>) representing this method invocation</td>
+</tr></tbody></table>
+<p>A <a class="xref" href="#SpecFile" title="Section 3.2. Format specification file">format specification file</a> defines what types of nodes an input document may use.</p>
+
+<p><div class="section">
+  <h3 class="title">
+    <a class="list" title="Return to table of contents" id="Node.class" href="#rev:Node.class">3.1.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Node.class">The <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code> class</a>
+  </h3>
+  <div class="content"><p>When erbook builds a document tree from the nodes in an input document, it stores information about these nodes into <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code> objects. A <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code> object has the following properties (methods):</p>
+<table border="1"><thead><tr><th>Property</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td style='text-align: left;'>type</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>Name of the type of this node.</td>
+</tr><tr><td style='text-align: left;'>args</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Array</span></code></td><td style='text-align: left;'>Arguments passed to this node.</td>
+</tr><tr><td style='text-align: left;'>content</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>The block of text passed to this node.</td>
+</tr><tr><td style='text-align: left;'>output</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>Result of the node output template for the content of this node.</td>
+</tr><tr><td style='text-align: left;'>digest</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>A unique identifier for the content of this node.</td>
+</tr><tr><td style='text-align: left;'>trace</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Array</span></code></td><td style='text-align: left;'>A stack trace describing the location of this node in the input document.</td>
+</tr><tr><td style='text-align: left;'>index</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>A LaTeX-style section number for this node. This property is only present if the <strong>index</strong> parameter is enabled in the definition of this type of node.</td>
+</tr><tr><td style='text-align: left;'>number</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Integer</span></code></td><td style='text-align: left;'>An order-of-occurrence number for this node. This property is only present if the <strong>number</strong> parameter is enabled in the definition of this type of node.</td>
+</tr><tr><td style='text-align: left;'>depth</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Integer</span></code></td><td style='text-align: left;'>Distance from the root of the document tree to this node.</td>
+</tr><tr><td style='text-align: left;'>parent</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code></td><td style='text-align: left;'>The <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code> object which contains this node. The value of this property will be <code class="code"><span style="color:#038;font-weight:bold">nil</span></code> if this node is a root of the document tree.</td>
+</tr><tr><td style='text-align: left;'>children</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Array</span></code> of <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code></td><td style='text-align: left;'>List of child nodes from the document tree.</td>
+</tr></tbody></table>
+<p>Furthermore, the <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code> class is derived from <a href='http://www.ruby-doc.org/stdlib/libdoc/ostruct/rdoc/classes/OpenStruct.html'>Ruby&#8217;s <code class="code"><span style="color:#036;font-weight:bold">OpenStruct</span></code> class</a>, so you can define new properties for <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code> objects dynamically.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h2 class="title">
+    <a class="list" title="Return to table of contents" id="SpecFile" href="#rev:SpecFile">3.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#SpecFile">Format specification file</a>
+  </h2>
+  <div class="content"><p>A format specification file is a plain-text file marked up in <a href='http://yaml4r.sourceforge.net/cookbook/'>YAML syntax</a>. Through the following parameters, it defines (1) what types of nodes an input document may contain, (2) how the content of those nodes is transformed into output, and (3) how the processed document is transformed into the output document.</p>
+<table border="1"><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td style='text-align: left;'>desc</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>A short description of the output format.</td>
+</tr><tr><td style='text-align: left;'>code</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>Ruby code that will be loaded before the input document is processed. This source code will be evaluated inside the main erbook executable, so any file-system or path-dependent portions of this source code should take appropriate precautions.</td>
+</tr><tr><td style='text-align: left;'>nodes</td><td style='text-align: left;'>Hash</td><td style='text-align: left;'>A listing of <a class="xref" href="#SpecFile.nodes" title="Section 3.2.1. Node definition">node definitions</a>.</td>
+</tr><tr><td style='text-align: left;'>output</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>An eRuby template for the final output document. See <a class="xref" href="#SpecFile.output">Section 3.2.2. Document output template</a>.</td>
+</tr></tbody></table>
+<p><div class="section">
+  <h3 class="title">
+    <a class="list" title="Return to table of contents" id="SpecFile.nodes" href="#rev:SpecFile.nodes">3.2.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#SpecFile.nodes">Node definition</a>
+  </h3>
+  <div class="content"><p>A node definition is a mapping from a name (the &#8220;node type&#8221;) to the following set of parameters:</p>
+<table border="1"><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td style='text-align: left;'>index</td><td style='text-align: left;'>Boolean</td><td style='text-align: left;'>Assign a LaTeX-style section number to this node?</td>
+</tr><tr><td style='text-align: left;'>number</td><td style='text-align: left;'>Boolean</td><td style='text-align: left;'>Assign an order-of-occurrence number to this node?</td>
+</tr><tr><td style='text-align: left;'>silent</td><td style='text-align: left;'>Boolean</td><td style='text-align: left;'>Suppress the output of this node?</td>
+</tr><tr><td style='text-align: left;'>output</td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>An eRuby template for the content of this node. See <a class="xref" href="#SpecFile.nodes.output">Section 3.2.1.1. Node output template</a>.</td>
+</tr></tbody></table>
+<p>You may define additional parameters in a node definition if you want.</p>
+
+<p><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="SpecFile.nodes.output" href="#rev:SpecFile.nodes.output">3.2.1.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#SpecFile.nodes.output">Node output template</a>
+  </h4>
+  <div class="content"><p>A node output template (the <strong>output</strong> parameter in a node definition) is an eRuby template that transforms a node&#8217;s content into output. During the processing stage, erbook replaces all nodes in the input document with the result of this template <em>unless</em> the <strong>silent</strong> parameter is enabled in this node&#8217;s definition.</p>
+
+<p>The following variables are available for use in this template:</p>
+<table border="1"><thead><tr><th>Variable</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@node</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code></td><td style='text-align: left;'>The node for which this template is being evaluated.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@roots</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Array</span></code> of <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code></td><td style='text-align: left;'>All root nodes in the document tree.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@nodes</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Array</span></code> of <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code></td><td style='text-align: left;'>All nodes in the document tree.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@types</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Hash</span></code></td><td style='text-align: left;'>Mapping from node type (<code class="code"><span style="color:#036;font-weight:bold">String</span></code>) to array of <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code> objects having that type.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@spec</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Hash</span></code></td><td style='text-align: left;'>Data from the format specification file.</td>
+</tr></tbody></table>
+<p>erbook also provides the following mappings inside the <code class="code"><span style="color:#33B">@spec</span></code> variable:</p>
+<table border="1"><thead><tr><th>Expression</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@spec</span>[<span style="color:#A60">:name</span>]</code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>Short-hand name of the current format.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@spec</span>[<span style="color:#A60">:file</span>]</code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>Path of the current format specification file.</td>
+</tr></tbody></table></div>
+</div></p></div>
+</div> <div class="section">
+  <h3 class="title">
+    <a class="list" title="Return to table of contents" id="SpecFile.output" href="#rev:SpecFile.output">3.2.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#SpecFile.output">Document output template</a>
+  </h3>
+  <div class="content"><p>A document output template (the <strong>output</strong> parameter in a format specification file) is an eRuby template that transforms a processed document into the final output document.</p>
+
+<p>The following variables are available for use in this template:</p>
+<table border="1"><thead><tr><th>Variable</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@content</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>Content of the processed document.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@roots</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Array</span></code> of <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code></td><td style='text-align: left;'>All root nodes in the document tree.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@nodes</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Array</span></code> of <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code></td><td style='text-align: left;'>All nodes in the document tree.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@types</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Hash</span></code></td><td style='text-align: left;'>Mapping from node type (<code class="code"><span style="color:#036;font-weight:bold">String</span></code>) to array of <code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span></code> objects having that type.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@spec</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Hash</span></code></td><td style='text-align: left;'>Data from the format specification file.</td>
+</tr></tbody></table>
+<p>erbook also provides the following mappings inside the <code class="code"><span style="color:#33B">@spec</span></code> variable:</p>
+<table border="1"><thead><tr><th>Expression</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@spec</span>[<span style="color:#A60">:name</span>]</code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>Short-hand name of the current format.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#33B">@spec</span>[<span style="color:#A60">:file</span>]</code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'>Path of the current format specification file.</td>
+</tr></tbody></table></div>
+</div> <div class="section">
+  <h3 class="title">
+    <a class="list" title="Return to table of contents" id="HelloWorld" href="#rev:HelloWorld">3.2.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#HelloWorld">Creating your own document format</a>
+  </h3>
+  <div class="content"><p>Here is a working example to help you digest all that you&#8217;ve learned so far about format specification files. A few things to notice in this example are:</p>
+
+<ul>
+<li>
+<p>We define a <code class="code">generate_name()</code> method in <a class="xref" href="#HelloWorld.spec">Example 1. HelloWorld format specification file</a> and make use of it in the <a class="xref" href="#HelloWorld.input">Example 2. Input document for HelloWorld format</a>. This shows how to provide format-specific functionality to an input document.</p>
+</li>
+
+<li>
+<p>We define a <code class="code"><span style="color:#d70;font-weight:bold">$style</span></code> variable in <a class="xref" href="#HelloWorld.input">Example 2. Input document for HelloWorld format</a> and make use of it in <a class="xref" href="#HelloWorld.spec">Example 1. HelloWorld format specification file</a>. This shows how to pass parameters from an input document to your format specification file.</p>
+</li>
+</ul>
+
+<p>To run this example:</p>
+
+<ol>
+<li>
+<p>Save the code shown in <a class="xref" href="#HelloWorld.spec">Example 1. HelloWorld format specification file</a> to a file named <tt>HelloWorld.spec</tt></p>
+</li>
+
+<li>
+<p>Save the text shown in <a class="xref" href="#HelloWorld.input">Example 2. Input document for HelloWorld format</a> to a file named <tt>HelloWorld.input</tt></p>
+</li>
+
+<li>
+<p>Run this command:</p>
+
+<pre>erbook HelloWorld.spec HelloWorld.input &gt; HelloWorld.output</pre>
+</li>
+
+<li>
+<p>Examine the <tt>HelloWorld.output</tt> file to your satisfaction!</p>
+</li>
+</ol>
+
+<p><div class="example">
+  <p class="title"><a class="list" title="Return to table of contents" id="HelloWorld.spec" href="#rev:HelloWorld.spec">Example 1</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#HelloWorld.spec">HelloWorld format specification file</a></p>
+  <div class="content"><p><pre class="code" lang="rhtml">desc: An example format.
+
+code: |
+  # Returns a random, yet pronounceable, name.
+  def generate_name
+    letters = ('a'..'z').to_a - %w[ c q w x ] # redundant sounds
+    vowels = %w[a e i o u]
+    consonants = letters - vowels
+    sets = [consonants, vowels]
+
+    length = 3 + rand(5)
+
+    name = (0...length).map do |i|
+      # alternate between consonants and vowels
+      set = sets[i % sets.length]
+
+      # choose a random letter from the set
+      set[rand(set.length)]
+    end.join
+
+    name
+  end
+
+  class Node
+    def name
+      # dynamically compute (and store)
+      # the name of this node on demand
+      @name ||= generate_name
+    end
+  end
+
+nodes:
+  hello:
+    index: true
+    number: true
+    silent: false
+    output: |
+      <span style="color:#070">&lt;h3&gt;</span><span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#33B">@node</span>.type <span style="font-weight:bold;color:#888">%&gt;</span></span> #<span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#33B">@node</span>.index <span style="font-weight:bold;color:#888">%&gt;</span></span>: <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#33B">@node</span>.name.inspect <span style="font-weight:bold;color:#888">%&gt;</span></span><span style="color:#070">&lt;/h3&gt;</span>
+
+      My name is <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#33B">@node</span>.name.inspect <span style="font-weight:bold;color:#888">%&gt;</span></span> and these are my properties:
+
+      <span style="color:#070">&lt;dl</span> <span style="color:#007">style</span>=<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#d70;font-weight:bold">$style</span> <span style="font-weight:bold;color:#888">%&gt;</span></span><span style="color:#710">&quot;</span></span><span style="color:#070">&gt;</span>
+        <span style="color:#070">&lt;dt&gt;</span>args<span style="color:#070">&lt;/dt&gt;</span>
+        <span style="color:#070">&lt;dd&gt;</span><span style="color:#070">&lt;code&gt;</span><span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#33B">@node</span>.args.inspect <span style="font-weight:bold;color:#888">%&gt;</span></span><span style="color:#070">&lt;/code&gt;</span><span style="color:#070">&lt;/dd&gt;</span>
+
+        <span style="color:#070">&lt;dt&gt;</span>index<span style="color:#070">&lt;/dt&gt;</span>
+        <span style="color:#070">&lt;dd&gt;</span><span style="color:#070">&lt;code&gt;</span><span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#33B">@node</span>.index.inspect <span style="font-weight:bold;color:#888">%&gt;</span></span><span style="color:#070">&lt;/code&gt;</span><span style="color:#070">&lt;/dd&gt;</span>
+
+        <span style="color:#070">&lt;dt&gt;</span>number<span style="color:#070">&lt;/dt&gt;</span>
+        <span style="color:#070">&lt;dd&gt;</span><span style="color:#070">&lt;code&gt;</span><span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#33B">@node</span>.number.inspect <span style="font-weight:bold;color:#888">%&gt;</span></span><span style="color:#070">&lt;/code&gt;</span><span style="color:#070">&lt;/dd&gt;</span>
+
+        <span style="color:#070">&lt;dt&gt;</span>trace<span style="color:#070">&lt;/dt&gt;</span>
+        <span style="color:#070">&lt;dd&gt;</span><span style="color:#070">&lt;pre&gt;</span><span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#33B">@node</span>.trace.join(<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#b0b">\n</span><span style="color:#710">&quot;</span></span>) <span style="font-weight:bold;color:#888">%&gt;</span></span><span style="color:#070">&lt;/pre&gt;</span><span style="color:#070">&lt;/dd&gt;</span>
+
+        <span style="color:#070">&lt;dt&gt;</span>content<span style="color:#070">&lt;/dt&gt;</span>
+        <span style="color:#070">&lt;dd&gt;</span><span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#33B">@node</span>.content <span style="font-weight:bold;color:#888">%&gt;</span></span><span style="color:#070">&lt;/dd&gt;</span>
+      <span style="color:#070">&lt;/dl&gt;</span>
+
+output: |
+  Welcome to the &quot;<span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#33B">@spec</span>[<span style="color:#A60">:name</span>] <span style="font-weight:bold;color:#888">%&gt;</span></span>&quot; format.
+  <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> <span style="color:#33B">@content</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+  That's all folks!
+</pre></p></div>
+</div> <div class="example">
+  <p class="title"><a class="list" title="Return to table of contents" id="HelloWorld.input" href="#rev:HelloWorld.input">Example 2</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#HelloWorld.input">Input document for HelloWorld format</a></p>
+  <div class="content"><p><pre class="code" lang="rhtml"><span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> <span style="color:#d70;font-weight:bold">$style</span> = <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">border-left: thick dotted LightGrey; padding-left: 1em;</span><span style="color:#710">&quot;</span></span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+<span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> hello <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Pretentious</span><span style="color:#710">&quot;</span></span>, <span style="color:#00D;font-weight:bold">1</span>, <span style="color:#00D;font-weight:bold">2</span>, <span style="color:#00D;font-weight:bold">3</span> <span style="color:#080;font-weight:bold">do</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+  <span style="color:#070">&lt;big&gt;</span>I'm<span style="color:#070">&lt;/big&gt;</span> the very first node, oh _yes_ I am! *sneer*
+
+  <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> hello <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Bashful</span><span style="color:#710">&quot;</span></span>, <span style="color:#00D;font-weight:bold">4</span>, <span style="color:#00D;font-weight:bold">5</span>, <span style="color:#00D;font-weight:bold">6</span> <span style="color:#080;font-weight:bold">do</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+    Hi, I... *hide*
+
+    <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> hello <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Hopeful</span><span style="color:#710">&quot;</span></span>, rand <span style="color:#080;font-weight:bold">do</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+      *sigh*
+
+      <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> hello <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Confused</span><span style="color:#710">&quot;</span></span>, (rand * rand) <span style="color:#080;font-weight:bold">do</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+        Huh?
+      <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> <span style="color:#080;font-weight:bold">end</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+    <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> <span style="color:#080;font-weight:bold">end</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+
+    <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> hello <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Raving</span><span style="color:#710">&quot;</span></span>, <span style="color:#038;font-weight:bold">__FILE__</span> <span style="color:#080;font-weight:bold">do</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+      Oh it's *on* now! You're going *down*!
+    <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> <span style="color:#080;font-weight:bold">end</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+  <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> <span style="color:#080;font-weight:bold">end</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+
+  <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> hello <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Sleepy</span><span style="color:#710">&quot;</span></span>, <span style="color:#036;font-weight:bold">Time</span>.now <span style="color:#080;font-weight:bold">do</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+    *yawn* Just five more minutes...
+
+    <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> hello <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Peaceful</span><span style="color:#710">&quot;</span></span>, <span style="color:#036;font-weight:bold">Dir</span>.pwd <span style="color:#080;font-weight:bold">do</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+      So _be_ happy my friend, *happy*!
+
+      <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> hello <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Lonely (as you can see, I have no block)</span><span style="color:#710">&quot;</span></span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+    <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> <span style="color:#080;font-weight:bold">end</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+  <span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> <span style="color:#080;font-weight:bold">end</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+<span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> <span style="color:#080;font-weight:bold">end</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+
+<span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> hello <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Snappy</span><span style="color:#710">&quot;</span></span> <span style="color:#080;font-weight:bold">do</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+  Zip! Zap! Wake up, you sap!
+  _Whoo I'm wild!_ ;-)
+<span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%</span> <span style="color:#080;font-weight:bold">end</span> <span style="font-weight:bold;color:#888">%&gt;</span></span>
+
+<span style="background:#eee"><span style="font-weight:bold;color:#888">&lt;%=</span> hello <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Independent (no block, no parents, I am _free_!)</span><span style="color:#710">&quot;</span></span> <span style="font-weight:bold;color:#888">%&gt;</span></span></pre></p></div>
+</div> <div class="example">
+  <p class="title"><a class="list" title="Return to table of contents" id="HelloWorld.output" href="#rev:HelloWorld.output">Example 3</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#HelloWorld.output">Output of HelloWorld format</a></p>
+  <div class="content"><p>Welcome to the &#8220;HelloWorld&#8221; format. <h3>hello #1: nil</h3></p>
+
+<p>My name is nil and these are my properties:</p>
+<dl style='border-left: thick dotted LightGrey; padding-left: 1em;'>
+  <dt>args</dt>
+  <dd><code class="code">[<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Pretentious</span><span style="color:#710">&quot;</span></span>, <span style="color:#00D;font-weight:bold">1</span>, <span style="color:#00D;font-weight:bold">2</span>, <span style="color:#00D;font-weight:bold">3</span>]</code></dd>
+
+  <dt>index</dt>
+  <dd><code class="code"><span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">1</span><span style="color:#710">&quot;</span></span></code></dd>
+
+  <dt>number</dt>
+  <dd><code class="code"><span style="color:#00D;font-weight:bold">1</span></code></dd>
+
+  <dt>trace</dt>
+  <dd><pre>doc/HelloWorld.input:1
+bin/erbook:307
+bin/erbook:307:in `instance_eval'
+bin/erbook:307</pre></dd>
+
+  <dt>content</dt>
+  <dd><big>I'm</big> the very first node, oh _yes_ I am! *sneer*
+
+<h3>hello #1.1: nil</h3>
+
+My name is nil and these are my properties:
+
+<dl style='border-left: thick dotted LightGrey; padding-left: 1em;'>
+  <dt>args</dt>
+  <dd><code class="code">[<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Bashful</span><span style="color:#710">&quot;</span></span>, <span style="color:#00D;font-weight:bold">4</span>, <span style="color:#00D;font-weight:bold">5</span>, <span style="color:#00D;font-weight:bold">6</span>]</code></dd>
+
+  <dt>index</dt>
+  <dd><code class="code"><span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">1.1</span><span style="color:#710">&quot;</span></span></code></dd>
+
+  <dt>number</dt>
+  <dd><code class="code"><span style="color:#00D;font-weight:bold">2</span></code></dd>
+
+  <dt>trace</dt>
+  <dd><pre>doc/HelloWorld.input:3
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:1
+bin/erbook:307
+bin/erbook:307:in `instance_eval'
+bin/erbook:307</pre></dd>
+
+  <dt>content</dt>
+  <dd>Hi, I... *hide*
+
+<h3>hello #1.1.1: nil</h3>
+
+My name is nil and these are my properties:
+
+<dl style='border-left: thick dotted LightGrey; padding-left: 1em;'>
+  <dt>args</dt>
+  <dd><code class="code">[<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Hopeful</span><span style="color:#710">&quot;</span></span>, <span style="color:#60E;font-weight:bold">0.0790764609144532</span>]</code></dd>
+
+  <dt>index</dt>
+  <dd><code class="code"><span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">1.1.1</span><span style="color:#710">&quot;</span></span></code></dd>
+
+  <dt>number</dt>
+  <dd><code class="code"><span style="color:#00D;font-weight:bold">3</span></code></dd>
+
+  <dt>trace</dt>
+  <dd><pre>doc/HelloWorld.input:5
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:3
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:1
+bin/erbook:307
+bin/erbook:307:in `instance_eval'
+bin/erbook:307</pre></dd>
+
+  <dt>content</dt>
+  <dd>*sigh*
+
+<h3>hello #1.1.1.1: nil</h3>
+
+My name is nil and these are my properties:
+
+<dl style='border-left: thick dotted LightGrey; padding-left: 1em;'>
+  <dt>args</dt>
+  <dd><code class="code">[<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Confused</span><span style="color:#710">&quot;</span></span>, <span style="color:#60E;font-weight:bold">0.528769558981025</span>]</code></dd>
+
+  <dt>index</dt>
+  <dd><code class="code"><span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">1.1.1.1</span><span style="color:#710">&quot;</span></span></code></dd>
+
+  <dt>number</dt>
+  <dd><code class="code"><span style="color:#00D;font-weight:bold">4</span></code></dd>
+
+  <dt>trace</dt>
+  <dd><pre>doc/HelloWorld.input:7
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:5
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:3
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:1
+bin/erbook:307
+bin/erbook:307:in `instance_eval'
+bin/erbook:307</pre></dd>
+
+  <dt>content</dt>
+  <dd>Huh?
+</dd>
+</dl></dd>
+</dl>
+<h3>hello #1.1.2: nil</h3>
+
+My name is nil and these are my properties:
+
+<dl style='border-left: thick dotted LightGrey; padding-left: 1em;'>
+  <dt>args</dt>
+  <dd><code class="code">[<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Raving</span><span style="color:#710">&quot;</span></span>, <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">doc/HelloWorld.input</span><span style="color:#710">&quot;</span></span>]</code></dd>
+
+  <dt>index</dt>
+  <dd><code class="code"><span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">1.1.2</span><span style="color:#710">&quot;</span></span></code></dd>
+
+  <dt>number</dt>
+  <dd><code class="code"><span style="color:#00D;font-weight:bold">5</span></code></dd>
+
+  <dt>trace</dt>
+  <dd><pre>doc/HelloWorld.input:9
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:3
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:1
+bin/erbook:307
+bin/erbook:307:in `instance_eval'
+bin/erbook:307</pre></dd>
+
+  <dt>content</dt>
+  <dd>Oh it's *on* now! You're going *down*!
+</dd>
+</dl></dd>
+</dl>
+<h3>hello #1.2: nil</h3>
+
+My name is nil and these are my properties:
+
+<dl style='border-left: thick dotted LightGrey; padding-left: 1em;'>
+  <dt>args</dt>
+  <dd><code class="code">[<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Sleepy</span><span style="color:#710">&quot;</span></span>, <span style="color:#036;font-weight:bold">Sat</span> <span style="color:#036;font-weight:bold">Nov</span> <span style="color:#00D;font-weight:bold">22</span> <span style="color:#00D;font-weight:bold">23</span>:<span style="color:#00D;font-weight:bold">17</span>:<span style="color:#00D;font-weight:bold">11</span> -<span style="color:#00D;font-weight:bold">0800</span> <span style="color:#00D;font-weight:bold">2008</span>]</code></dd>
+
+  <dt>index</dt>
+  <dd><code class="code"><span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">1.2</span><span style="color:#710">&quot;</span></span></code></dd>
+
+  <dt>number</dt>
+  <dd><code class="code"><span style="color:#00D;font-weight:bold">6</span></code></dd>
+
+  <dt>trace</dt>
+  <dd><pre>doc/HelloWorld.input:11
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:1
+bin/erbook:307
+bin/erbook:307:in `instance_eval'
+bin/erbook:307</pre></dd>
+
+  <dt>content</dt>
+  <dd>*yawn* Just five more minutes...
+
+<h3>hello #1.2.1: nil</h3>
+
+My name is nil and these are my properties:
+
+<dl style='border-left: thick dotted LightGrey; padding-left: 1em;'>
+  <dt>args</dt>
+  <dd><code class="code">[<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Peaceful</span><span style="color:#710">&quot;</span></span>, <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">/home/sun/src/erbook</span><span style="color:#710">&quot;</span></span>]</code></dd>
+
+  <dt>index</dt>
+  <dd><code class="code"><span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">1.2.1</span><span style="color:#710">&quot;</span></span></code></dd>
+
+  <dt>number</dt>
+  <dd><code class="code"><span style="color:#00D;font-weight:bold">7</span></code></dd>
+
+  <dt>trace</dt>
+  <dd><pre>doc/HelloWorld.input:13
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:11
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:1
+bin/erbook:307
+bin/erbook:307:in `instance_eval'
+bin/erbook:307</pre></dd>
+
+  <dt>content</dt>
+  <dd>So _be_ happy my friend, *happy*!
+
+<h3>hello #1.2.1.1: nil</h3>
+
+My name is nil and these are my properties:
+
+<dl style='border-left: thick dotted LightGrey; padding-left: 1em;'>
+  <dt>args</dt>
+  <dd><code class="code">[<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Lonely (as you can see, I have no block)</span><span style="color:#710">&quot;</span></span>]</code></dd>
+
+  <dt>index</dt>
+  <dd><code class="code"><span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">1.2.1.1</span><span style="color:#710">&quot;</span></span></code></dd>
+
+  <dt>number</dt>
+  <dd><code class="code"><span style="color:#00D;font-weight:bold">8</span></code></dd>
+
+  <dt>trace</dt>
+  <dd><pre>doc/HelloWorld.input:15
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:13
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:11
+bin/erbook:115:in `content_from_block'
+bin/erbook:288:in `hello'
+doc/HelloWorld.input:1
+bin/erbook:307
+bin/erbook:307:in `instance_eval'
+bin/erbook:307</pre></dd>
+
+  <dt>content</dt>
+  <dd />
+</dl>
+</dd>
+</dl></dd>
+</dl></dd>
+</dl><h3>hello #2: nil</h3>
+<p>My name is nil and these are my properties:</p>
+<dl style='border-left: thick dotted LightGrey; padding-left: 1em;'>
+  <dt>args</dt>
+  <dd><code class="code">[<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Snappy</span><span style="color:#710">&quot;</span></span>]</code></dd>
+
+  <dt>index</dt>
+  <dd><code class="code"><span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">2</span><span style="color:#710">&quot;</span></span></code></dd>
+
+  <dt>number</dt>
+  <dd><code class="code"><span style="color:#00D;font-weight:bold">9</span></code></dd>
+
+  <dt>trace</dt>
+  <dd><pre>doc/HelloWorld.input:17
+bin/erbook:307
+bin/erbook:307:in `instance_eval'
+bin/erbook:307</pre></dd>
+
+  <dt>content</dt>
+  <dd>Zip! Zap! Wake up, you sap!
+_Whoo I'm wild!_ ;-)
+</dd>
+</dl><h3>hello #3: nil</h3>
+<p>My name is nil and these are my properties:</p>
+<dl style='border-left: thick dotted LightGrey; padding-left: 1em;'>
+  <dt>args</dt>
+  <dd><code class="code">[<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Independent (no block, no parents, I am _free_!)</span><span style="color:#710">&quot;</span></span>]</code></dd>
+
+  <dt>index</dt>
+  <dd><code class="code"><span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">3</span><span style="color:#710">&quot;</span></span></code></dd>
+
+  <dt>number</dt>
+  <dd><code class="code"><span style="color:#00D;font-weight:bold">10</span></code></dd>
+
+  <dt>trace</dt>
+  <dd><pre>doc/HelloWorld.input:20
+bin/erbook:307
+bin/erbook:307:in `instance_eval'
+bin/erbook:307</pre></dd>
+
+  <dt>content</dt>
+  <dd />
+</dl>
+<p>That&#8217;s all folks!</p></div>
+</div></p></div>
+</div></p></div>
+</div></p></div>
+</div>
+<div class="chapter">
+  <h1 class="title">
+    Chapter&nbsp;<a class="list" title="Return to table of contents" id="Usage" href="#rev:Usage">4</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#Usage">Usage</a></big>
+  </h1>
+  <div class="content"><p><div class="section">
+  <h2 class="title">
+    <a class="list" title="Return to table of contents" id="Command-line-invocation" href="#rev:Command-line-invocation">4.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Command-line-invocation">Command-line invocation</a>
+  </h2>
+  <div class="content"><p>erbook is an extensible document processor based on eRuby.</p>
+
+<ul>
+<li>
+<p>The standard input stream will be read if an input file is not specified.</p>
+</li>
+
+<li>
+<p>The final output document will be written to the standard output stream.</p>
+</li>
+
+<li>
+<p>If an error occurs, the input document will be written to the standard output stream, so that you can investigate line numbers in the error.</p>
+</li>
+</ul>
+<b>Usage:</b>
+<p><pre>erbook [Option...] FormatName [InputFile]</pre> <pre>erbook [Option...] FormatFile [InputFile]</pre></p>
+<b>FormatName:</b>
+<dl>
+<dt>latex</dt>
+
+<dd>high-quality typesetting</dd>
+
+<dt>man</dt>
+
+<dd>manual page for UNIX</dd>
+
+<dt>xhtml</dt>
+
+<dd>web page for the Internet</dd>
+
+<dt>text</dt>
+
+<dd>plain text, nothing fancy</dd>
+</dl>
+<b>Option:</b>
+<dl>
+<dt><tt>--unindent</tt>, <tt>-u</tt></dt>
+
+<dd>Unindent node content hierarchically</dd>
+
+<dt><tt>--version</tt>, <tt>-v</tt></dt>
+
+<dd>Print version and exit</dd>
+
+<dt><tt>--help</tt>, <tt>-h</tt></dt>
+
+<dd>Show this message</dd>
+</dl>
+
+<p><div class="paragraph">
+  <p class="title"><a class="here" title="Permanent link to this section" href="#Command-line-arguments">Command-line arguments</a></p>
+  <div class="content"><p>The first command-line argument to erbook is either the name of a predefined format (FormatName) or the path to a <a class="xref" href="#SpecFile" title="Section 3.2. Format specification file">format specification file</a> (FormatFile).</p>
+
+<p>Predefined formats are simply short-hand names of format specification files located in the <tt>fmt/</tt> subdirectory of the erbook installation directory (see <a class="xref" href="#Manifest">Section 2.3. Manifest</a>).</p></div>
+</div> <div class="paragraph">
+  <p class="title"><a class="here" title="Permanent link to this section" href="#Saving-the-output-to-a-file">Saving the output to a file</a></p>
+  <div class="content"><p>Simply redirect the standard ouput stream (STDOUT) to a file like this:</p>
+
+<pre>erbook &gt; YOUR_PATH_HERE</pre>
+
+<p>In the above example, <strong>YOUR_PATH_HERE</strong> is the path of the file in which the output should be saved.</p>
+
+<p><div class="important">
+  <p class="title"><a class="list" title="Return to table of contents" id="Save-XHTML-output-as-.xhtml" href="#rev:Save-XHTML-output-as-.xhtml">Important 1</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Save-XHTML-output-as-.xhtml">Save XHTML output as <tt>.xhtml</tt></a></p>
+  <div class="content"><img class="icon" src="&icon_important;" alt="important"/><p>When you use the XHTML format, ensure that the file extension of your saved output document is either <tt>.xhtml</tt> or <tt>.xml</tt>. Alternatively, ensure that your saved output document is served to web browsers under the <tt>application/xhtml+xml</tt> mime type.</p>
+
+<p>Otherwise, most web browsers <em>will not display</em> the icons and graphics embedded in the saved XHTML output document because they will treat it as HTML instead of as XML. See this <a href='http://www.quirksmode.org/bugreports/archives/2005/02/custom_dtds_int_1.html'>QuirksMode.org bug report</a> for details.</p></div>
+</div></p></div>
+</div></p></div>
+</div> <div class="section">
+  <h2 class="title">
+    <a class="list" title="Return to table of contents" id="include" href="#rev:include">4.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#include">Including external documents</a>
+  </h2>
+  <div class="content"><p>The <strong>include</strong> directive allows you to insert the content of an arbitrary file at a certain place in the input document. It is written like this:</p>
+
+<pre>&lt;%# include YOUR_PATH_HERE #%&gt;</pre>
+
+<p>In the above example, <strong>YOUR_PATH_HERE</strong> is the path of the file whose content you wish to insert into the input document.</p>
+
+<p>You can divide a large document into separate files for easier editing and stitch them together, dynamically, into a single document using the <strong>include</strong> directive.</p></div>
+</div> <div class="section">
+  <h2 class="title">
+    <a class="list" title="Return to table of contents" id="Unindenting-nodes-hierarchically" href="#rev:Unindenting-nodes-hierarchically">4.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Unindenting-nodes-hierarchically">Unindenting nodes hierarchically</a>
+  </h2>
+  <div class="content"><p>When writing erbook documents, I prefer to indent the content of nodes according to their depth (as can be seen in <a class="xref" href="#See-the-source-of-this-manual" title="Note 1. See the source of this manual">the source of this manual</a>) because my <a href='http://jedit.org'>text editor of choice</a> automatically folds blocks of text based on indentation.</p>
+
+<p>If you also prefer to write documents in this way, be sure to pass the <tt>--unindent</tt> option to <strong>erbook</strong> so that the indentation will not affect the resulting output.</p></div>
+</div></p></div>
+</div>
+<div class="part">
+  <h1 class="title">
+    Part&nbsp;<a class="list" title="Return to table of contents" id="Formats" href="#rev:Formats">5</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#Formats">Formats</a></big>
+  </h1>
+  <div class="content"><p>This part describes the default formats provided along with erbook. The <a class="xref" href="#SpecFile" title="Section 3.2. Format specification file">format specification files</a> for these formats can be found in the <tt>fmt/</tt> directory of the erbook installation directory (see <a class="xref" href="#Manifest">Section 2.3. Manifest</a>).</p>
+
+<p>These formats are meant to serve as working examples. If you require more functionality from one of these formats, simply make a copy of the corresponding format specification file and edit the copy to suit your needs. If you would like to contribute or discuss your enhancements to these default formats, you can <a class="xref" href="#License" title="Section 1.2.2. License">contact the author</a>.</p>
+
+<p><div class="chapter">
+  <h1 class="title">
+    Chapter&nbsp;<a class="list" title="Return to table of contents" id="xhtml" href="#rev:xhtml">5.1</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#xhtml">XHTML (web page)</a></big>
+  </h1>
+  <div class="content"><p>This format generates a <em>monolithic</em> XHTML document that allows users to easily search for a particular topic using nothing more than their web browser&#8217;s built-in text search mechanism. This facilitates offline reading, where an Internet search engine is not available.</p>
+
+<p>In the XHTML document, you will notice that the numbers of chapters, sections, figures, admonitions, etc. are hyperlinks that take you back to the corresponding place in the table of contents. These links make it easy to navigate the XHTML document, especially for users of text-only web browsers.</p>
+
+<p>Furthermore, the XHTML document comes equipped with a stylesheet that makes it suitable for printing. In particular, users of the <a href='http://mozilla.org'>Mozilla</a> and <a href='http://www.opera.com/'>Opera</a> family of web browsers will be pleasantly surprised to notice that all hyperlinks have been expanded to include their target URL next to the link text. So try using the &#8220;print preview&#8221; function of a graphical web browser to see how the XHTML document will appear when printed.</p>
+
+<p><div class="section">
+  <h3 class="title">
+    <a class="list" title="Return to table of contents" id="Text-to-XHTML-conversion" href="#rev:Text-to-XHTML-conversion">5.1.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Text-to-XHTML-conversion">Text to XHTML conversion</a>
+  </h3>
+  <div class="content"><p>The <tt>lib/erbook/to_xhtml.rb</tt> file inside erbook&#8217;s installation directory (see <a class="xref" href="#Manifest">Section 2.3. Manifest</a>) defines the following methods:</p>
+
+<ul>
+<li>
+<p><code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_xhtml</span></code> - Transforms this string into XHTML while ensuring that the result contains one or more block-level elements at the root.</p>
+</li>
+
+<li>
+<p><code class="code"><span style="color:#036;font-weight:bold">String</span>.to_inline_xhtml</code> - Transforms this string into an <em>inline</em> XHTML string (one that does not contain any block-level XHTML elements at the root).</p>
+</li>
+</ul>
+
+<p>The default implementation of the <code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_xhtml</span></code> method employs the <a href='http://daringfireball.net/projects/markdown/'>Markdown</a> markup system. If you do not like Markdown or wish to use a different markup system for text in your documents, then simply edit the <tt>to_xhtml.rb</tt> file and adjust the source code of the default <code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_xhtml</span></code> and <code class="code"><span style="color:#036;font-weight:bold">String</span>.to_inline_xhtml</code> methods accordingly.</p>
+
+<p>For example, if you replace the entire <tt>to_xhtml.rb</tt> file with the following code, then the output of all nodes will appear within red boxes in the final output document.</p>
+
+<p><pre class="code">
+<span style="color:#080;font-weight:bold">class</span> <span style="color:#B06;font-weight:bold">String</span>
+  <span style="color:#666"># Transforms this string into XHTML while ensuring that the</span>
+  <span style="color:#666"># result contains one or more block-level elements at the root.</span>
+  <span style="color:#080;font-weight:bold">def</span> <span style="color:#06B;font-weight:bold">to_xhtml</span>
+    <span style="background-color:#fff0f0"><span style="color:#710">'</span><span style="color:#D20">&lt;p style=&quot;border: thin solid red&quot;&gt;</span><span style="color:#710">'</span></span> + <span style="color:#038;font-weight:bold">self</span> + <span style="background-color:#fff0f0"><span style="color:#710">'</span><span style="color:#D20">&lt;/p&gt;</span><span style="color:#710">'</span></span>
+  <span style="color:#080;font-weight:bold">end</span>
+
+  <span style="color:#666"># Transforms this string into an *inline* XHTML string (one that</span>
+  <span style="color:#666"># does not contain any block-level XHTML elements at the root).</span>
+  <span style="color:#080;font-weight:bold">def</span> <span style="color:#06B;font-weight:bold">to_inline_xhtml</span>
+    <span style="color:#038;font-weight:bold">self</span>
+  <span style="color:#080;font-weight:bold">end</span>
+<span style="color:#080;font-weight:bold">end</span>
+</pre></p>
+
+<p>In addition to supporting Markdown syntax, the default implementation has some additional features which are described in the following subsections.</p>
+
+<p><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="Syntax-coloring-for-source-code" href="#rev:Syntax-coloring-for-source-code">5.1.1.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Syntax-coloring-for-source-code">Syntax coloring for source code</a>
+  </h4>
+  <div class="content"><p>Syntax coloring is <em>automatically added</em> to source code found inside the <strong>&#60;code&#62;</strong> and <strong>&#60;/code&#62;</strong> HTML tags. The syntax coloring library, <a href='http://coderay.rubychan.de'>CodeRay</a>, currently supports the following programming languages:</p>
+
+<ul>
+<li>Ruby</li>
+
+<li>C</li>
+
+<li>Delphi</li>
+
+<li>HTML</li>
+
+<li>RHTML (Rails)</li>
+
+<li>Nitro-XHTML</li>
+</ul>
+
+<p><div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="Specifying-the-programming-language" href="#rev:Specifying-the-programming-language">5.1.1.1.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Specifying-the-programming-language">Specifying the programming language</a>
+  </h5>
+  <div class="content"><p>Because different programming languages have different syntax coloring schemes, you can specify the language of your source code using the <code class="code">lang</code> attribute to ensure that only the appropriate coloring scheme is used. Note that unless the <code class="code">lang</code> attribute is specified, <em>Ruby</em> is assumed to be the programming language of all source code by default.</p>
+
+<p>For example, here is some source code <em>without</em> the <code class="code">lang</code> attribute:</p>
+
+<p><pre class="code">
+<span style="color:#666"># Ruby ###########################</span>
+<span style="color:#080;font-weight:bold">def</span> <span style="color:#06B;font-weight:bold">hello</span>
+  puts <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Hello world!</span><span style="color:#710">&quot;</span></span>
+<span style="color:#080;font-weight:bold">end</span>
+
+
+<span style="background-color:#fff0ff"><span style="color:#404">/</span><span style="color:#808">* C ****************************</span><span style="color:#404">/</span></span>
+<span style="color:#666">#include &lt;stdio.h&gt;</span>
+int main(int argc, char **argv) {
+  printf(<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Hello world!</span><span style="color:#b0b">\n</span><span style="color:#710">&quot;</span></span>);
+  <span style="color:#080;font-weight:bold">return</span> <span style="color:#00D;font-weight:bold">0</span>;
+}
+
+
+&lt;!-- <span style="color:#036;font-weight:bold">HTML</span> -----------------------&gt;
+&lt;html&gt;
+  &lt;body&gt;
+    <span style="color:#036;font-weight:bold">Hello</span> world!
+  &lt;body&gt;
+&lt;<span style="background-color:#fff0ff"><span style="color:#404">/</span><span style="color:#808">html&gt;
+</span></span></pre></p>
+
+<p>And here is the same source code with a <code class="code">lang=<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">c</span><span style="color:#710">&quot;</span></span></code> attribute:</p>
+
+<p><pre class="code" lang="c">
+<span style="color:#579"># Ruby</span> <span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#</span><span style="color:#579">#
+def</span> hello
+  puts <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Hello world!</span><span style="color:#710">&quot;</span></span>
+end
+
+
+<span style="color:#666">/* C ****************************/</span>
+<span style="color:#579">#include</span> <span style="color:#B44;font-weight:bold">&lt;stdio.h&gt;</span>
+<span style="color:#339;font-weight:bold">int</span> main(<span style="color:#339;font-weight:bold">int</span> argc, <span style="color:#339;font-weight:bold">char</span> **argv) {
+  printf(<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Hello world!</span><span style="color:#b0b">\n</span><span style="color:#710">&quot;</span></span>);
+  <span style="color:#080;font-weight:bold">return</span> <span style="color:#00D;font-weight:bold">0</span>;
+}
+
+
+&lt;!-- HTML -----------------------&gt;
+&lt;html&gt;
+  &lt;body&gt;
+    Hello world!
+  &lt;body&gt;
+&lt;/html&gt;
+</pre></p>
+
+<p>And here is the same source code with a <code class="code">lang=<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">html</span><span style="color:#710">&quot;</span></span></code> attribute:</p>
+
+<p><pre class="code" lang="html">
+# Ruby ###########################
+def hello
+  puts &quot;Hello world!&quot;
+end
+
+
+/* C ****************************/
+#include <span style="color:#070">&lt;stdio.h&gt;</span>
+int main(int argc, char **argv) {
+  printf(&quot;Hello world!\n&quot;);
+  return 0;
+}
+
+
+<span style="color:#666">&lt;!-- HTML -----------------------&gt;</span>
+<span style="color:#070">&lt;html&gt;</span>
+  <span style="color:#070">&lt;body&gt;</span>
+    Hello world!
+  <span style="color:#070">&lt;body&gt;</span>
+<span style="color:#070">&lt;/html&gt;</span>
+</pre></p></div>
+</div></p></div>
+</div> <div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="Smart-sizing-of-source-code" href="#rev:Smart-sizing-of-source-code">5.1.1.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Smart-sizing-of-source-code">Smart sizing of source code</a>
+  </h4>
+  <div class="content"><p>Source code is <em>automatically sized</em> to be displayed as either a line or paragraph of text, depending on whether it contains line breaks.</p>
+
+<p>For example, here is a single line <code class="code">life = <span style="color:#038;font-weight:bold">true</span> <span style="color:#080;font-weight:bold">or</span> <span style="color:#038;font-weight:bold">false</span></code> of code. And here is a paragraph <pre class="code">life =
+<span style="color:#038;font-weight:bold">true</span> <span style="color:#080;font-weight:bold">or</span>
+<span style="color:#038;font-weight:bold">false</span></pre> of code.</p></div>
+</div> <div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="Protecting-verbatim-text" href="#rev:Protecting-verbatim-text">5.1.1.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Protecting-verbatim-text">Protecting verbatim text</a>
+  </h4>
+  <div class="content"><p>Sometimes you just need to protect some text from being mangled by the text-to-XHTML conversion process . In such cases, you can wrap the text you want to proctect within <strong>&#60;noformat&#62;</strong> and <strong>&#60;/noformat&#62;</strong> tags.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h3 class="title">
+    <a class="list" title="Return to table of contents" id="Parameters" href="#rev:Parameters">5.1.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Parameters">Parameters</a>
+  </h3>
+  <div class="content"><p>The XHTML format accepts the following document parameters.</p>
+<table border="1"><thead><tr><th>Parameter</th><th>Type</th><th>Default value</th><th>Description</th></tr></thead><tbody><tr><td style='text-align: left;'><code class="code"><span style="color:#d70;font-weight:bold">$title</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'><code class="code"><span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">$title</span><span style="color:#710">&quot;</span></span></code></td><td style='text-align: left;'>Title of the document.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#d70;font-weight:bold">$authors</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Hash</span></code></td><td style='text-align: left;'><code class="code">{<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">$authors</span><span style="color:#710">&quot;</span></span> =&gt; <span style="color:#038;font-weight:bold">nil</span>}</code></td><td style='text-align: left;'>A mapping of author name to author URL. You can obfuscate e-mail addresses using the provided <code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_xml_entities</span></code> method like this: <code class="code">{ <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">Y. Matsumoto</span><span style="color:#710">&quot;</span></span> =&gt; <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">mailto:matz@ruby.invalid</span><span style="color:#710">&quot;</span></span>.to_xml_entities }</code></td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#d70;font-weight:bold">$date</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Time</span>.now.strftime(<span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">%d %B %Y</span><span style="color:#710">&quot;</span></span>)</code></td><td style='text-align: left;'>Date when the document was written.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#d70;font-weight:bold">$logo</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">String</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#038;font-weight:bold">nil</span></code></td><td style='text-align: left;'>Arbitrary content that goes above the document title in the default header.</td>
+</tr><tr><td style='text-align: left;'><code class="code"><span style="color:#d70;font-weight:bold">$feeds</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#036;font-weight:bold">Hash</span></code></td><td style='text-align: left;'><code class="code"><span style="color:#038;font-weight:bold">nil</span></code></td><td style='text-align: left;'>A mapping of feed URL to feed format. Here is an example: <code class="code"><span style="color:#d70;font-weight:bold">$feeds</span> = { <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">my_rss_feed.xml</span><span style="color:#710">&quot;</span></span> =&gt; <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">rss</span><span style="color:#710">&quot;</span></span>, <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">my_atom_feed.xml</span><span style="color:#710">&quot;</span></span> =&gt; <span style="background-color:#fff0f0"><span style="color:#710">&quot;</span><span style="color:#D20">atom</span><span style="color:#710">&quot;</span></span> }</code></td>
+</tr></tbody></table></div>
+</div> <div class="section">
+  <h3 class="title">
+    <a class="list" title="Return to table of contents" id="Methods" href="#rev:Methods">5.1.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Methods">Methods</a>
+  </h3>
+  <div class="content"><p>The XHTML format provides the following methods. In the method declarations shown below,</p>
+
+<ul>
+<li>a pound sign (#) indicates that the method is an <em>instance method</em>, meaning that it can only be invoked on instances of a class, not on the classes themselves.</li>
+
+<li>a double colon sign (::) indicates that the method is a <em>class method</em>, meaning that it can only be invoked on a class.</li>
+</ul>
+
+<p><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-ERBook::Node-title" href="#rev:a-ERBook::Node-title">5.1.3.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-ERBook::Node-title"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#title()</span></code></a>
+  </h4>
+  <div class="content"><p>
+Returns the user-defined title for this node&#8216;s content.
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-ERBook::Node-id" href="#rev:a-ERBook::Node-id">5.1.3.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-ERBook::Node-id"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#id()</span></code></a>
+  </h4>
+  <div class="content"><p>
+Returns the user-defined indentifer for this node.
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-ERBook::Node-title_xhtml" href="#rev:a-ERBook::Node-title_xhtml">5.1.3.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-ERBook::Node-title_xhtml"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#title_xhtml()</span></code></a>
+  </h4>
+  <div class="content"><p>
+Returns the title of this node as XHTML.
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-ERBook::Node-content_xhtml" href="#rev:a-ERBook::Node-content_xhtml">5.1.3.4</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-ERBook::Node-content_xhtml"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#content_xhtml()</span></code></a>
+  </h4>
+  <div class="content"><p>
+Returns the content of this node as XHTML.
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-ERBook::Node-title_link-aTitle-nil" href="#rev:a-ERBook::Node-title_link-aTitle-nil">5.1.3.5</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-ERBook::Node-title_link-aTitle-nil"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#title_link(aTitle = nil)</span></code></a>
+  </h4>
+  <div class="content"><p>
+Returns a hyperlink to this node containing its title.
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-ERBook::Node-index_link" href="#rev:a-ERBook::Node-index_link">5.1.3.6</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-ERBook::Node-index_link"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#index_link()</span></code></a>
+  </h4>
+  <div class="content"><p>
+Returns a hyperlink to this node containing its LaTeX-style index number.
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-ERBook::Node-number_link" href="#rev:a-ERBook::Node-number_link">5.1.3.7</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-ERBook::Node-number_link"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Node</span><span style="color:#666">#number_link()</span></code></a>
+  </h4>
+  <div class="content"><p>
+Returns a hyperlink to this node containing its occurrence number.
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-Hash-to_xml_atts" href="#rev:a-Hash-to_xml_atts">5.1.3.8</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-Hash-to_xml_atts"><code class="code"><span style="color:#036;font-weight:bold">Hash</span><span style="color:#666">#to_xml_atts()</span></code></a>
+  </h4>
+  <div class="content"><p>
+Transforms this hash into a string of XML attribute key=&quot;value&quot;
+pairs.
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-ERBook::Template-verbatim-aContent" href="#rev:a-ERBook::Template-verbatim-aContent">5.1.3.9</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-ERBook::Template-verbatim-aContent"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Template</span><span style="color:#666">#verbatim(aContent)</span></code></a>
+  </h4>
+  <div class="content"><p>
+Protects the given content from the text-to-XHTML conversion process.
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-ERBook::Template-hyperlink-aUrl-aLabel-aUrl-aTitle-nil" href="#rev:a-ERBook::Template-hyperlink-aUrl-aLabel-aUrl-aTitle-nil">5.1.3.10</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-ERBook::Template-hyperlink-aUrl-aLabel-aUrl-aTitle-nil"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Template</span><span style="color:#666">#hyperlink(aUrl, aLabel = aUrl, aTitle = nil)</span></code></a>
+  </h4>
+  <div class="content"><p>
+Returns XHTML for a hyperlink to the given URL of the given label and
+mouse-hover title.
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-ERBook::Template-embed_image_file-aPath-aFormat-aPath-w-aAtts" href="#rev:a-ERBook::Template-embed_image_file-aPath-aFormat-aPath-w-aAtts">5.1.3.11</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-ERBook::Template-embed_image_file-aPath-aFormat-aPath-w-aAtts"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Template</span><span style="color:#666">#embed_image_file(aPath, aFormat = aPath[/\w+/], aAtts = {})</span></code></a>
+  </h4>
+  <div class="content"><p>
+Returns an &lt;img/&gt; tag that embeds the given image file.
+</p><table border="1">
+<tr><td valign='top'>aPath:</td><td>path to the image file
+
+</td></tr>
+<tr><td valign='top'>aFormat:</td><td>format of the image file (e.g. PNG, JPEG, GIF, etc.)
+
+</td></tr>
+<tr><td valign='top'>aAtts:</td><td>additional attributes for the &lt;img&gt; tag
+
+</td></tr>
+</table></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-ERBook::Template-embed_image_data-aData-aFormat-aAtts" href="#rev:a-ERBook::Template-embed_image_data-aData-aFormat-aAtts">5.1.3.12</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-ERBook::Template-embed_image_data-aData-aFormat-aAtts"><code class="code"><span style="color:#036;font-weight:bold">ERBook</span>::<span style="color:#036;font-weight:bold">Template</span><span style="color:#666">#embed_image_data(aData, aFormat, aAtts = {})</span></code></a>
+  </h4>
+  <div class="content"><p>
+Returns an &lt;img/&gt; tag that embeds the given raw image data.
+</p><table border="1">
+<tr><td valign='top'>aData:</td><td>raw image data
+
+</td></tr>
+<tr><td valign='top'>aFormat:</td><td>format of the image file (e.g. PNG, JPEG, GIF, etc.)
+
+</td></tr>
+<tr><td valign='top'>aAtts:</td><td>additional attributes for the &lt;img&gt; tag
+
+</td></tr>
+</table></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-String-to_xml_entities" href="#rev:a-String-to_xml_entities">5.1.3.13</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-String-to_xml_entities"><code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_xml_entities()</span></code></a>
+  </h4>
+  <div class="content"><p>
+Transforms this UTF-8 string into XML entities.
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-String-to_uri_fragment" href="#rev:a-String-to_uri_fragment">5.1.3.14</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-String-to_uri_fragment"><code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_uri_fragment()</span></code></a>
+  </h4>
+  <div class="content"><p>
+Transforms this string into a valid URI fragment. See <a href='http://www.nmt.edu/tcc/help/pubs/xhtml/id-type.html'>www.nmt.edu/tcc/help/pubs/xhtml/id-type.html</a>
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-String-to_inline_xhtml" href="#rev:a-String-to_inline_xhtml">5.1.3.15</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-String-to_inline_xhtml"><code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_inline_xhtml()</span></code></a>
+  </h4>
+  <div class="content"><p>
+Transforms this string into an <b>inline</b> XHTML string (one that does
+not contain any block-level XHTML elements at the root).
+</p></div>
+</div><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="a-String-to_xhtml-aInline-false" href="#rev:a-String-to_xhtml-aInline-false">5.1.3.16</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#a-String-to_xhtml-aInline-false"><code class="code"><span style="color:#036;font-weight:bold">String</span><span style="color:#666">#to_xhtml(aInline = false)</span></code></a>
+  </h4>
+  <div class="content"><p>
+Transforms this string into XHTML while ensuring that the result contains
+one or more block-level elements at the root.
+</p><p>
+If aInline is true, then the resulting XHTML will be an <b>inline</b>
+string.
+</p></div>
+</div></p></div>
+</div> <div class="chapter">
+  <h1 class="title">
+    Chapter&nbsp;<a class="list" title="Return to table of contents" id="xhtml.nodes" href="#rev:xhtml.nodes">5.1.4</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#xhtml.nodes">Nodes</a></big>
+  </h1>
+  <div class="content"><p>Unless otherwise noted, all nodes defined by the XHTML format accept two arguments, in this order:</p>
+
+<ol>
+<li>a required <em>title</em> for the node</li>
+
+<li>an optional <em>unique identifier</em> for the node</li>
+</ol>
+
+<p>The second argument is used by the cross-referencing nodes (see <a class="xref" href="#xhtml.nodes.xref">Section 5.1.4.1.4. xref</a> and <a class="xref" href="#xhtml.nodes.cite">Section 5.1.4.5.2. cite</a>), which allow you to refer to another node in the document by its unique identifier.</p>
+
+<p>Furthermore, <a class="xref" href="#SpecFile.nodes" title="Section 3.2.1. Node definition">node definitions</a> in the XHTML format have two additional parameters:</p>
+<table border="1"><thead><tr><th>Parameter</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td style='text-align: left;'>toc</td><td style='text-align: left;'>Boolean</td><td style='text-align: left;'>Include this node in the <strong>Table of Contents</strong> (TOC)?</td>
+</tr><tr><td style='text-align: left;'>lof</td><td style='text-align: left;'>Boolean</td><td style='text-align: left;'>Include this node in the <strong>List of Figures</strong> (LOF)?</td>
+</tr></tbody></table>
+<p><div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="Structural-nodes" href="#rev:Structural-nodes">5.1.4.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Structural-nodes">Structural nodes</a>
+  </h4>
+  <div class="content"><p>The nodes described in this section form the overall structure of the output document.</p>
+
+<p><div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.header" href="#rev:xhtml.nodes.header">5.1.4.1.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.header">header</a>
+  </h5>
+  <div class="content"><p>This node overrides the logo, title, list of authors, and date when the document was written, all of which are shown at the top of the document.</p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.footer" href="#rev:xhtml.nodes.footer">5.1.4.1.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.footer">footer</a>
+  </h5>
+  <div class="content"><p>This node overrides (1) the date when this document was generated and (2) the hyperlink to the erbook website, shown at the bottom of the document. The hyperlink is there as a way of saying thanks for erbook, the <em>wonderful</em> little utility you have grown so fond of! ;-)</p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.abstract" href="#rev:xhtml.nodes.abstract">5.1.4.1.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.abstract">abstract</a>
+  </h5>
+  <div class="content"><p>A summary of the entire document. This is what most readers will <em>skim</em> through, if you are lucky. Alas, nobody reads entire documents these days! :-(</p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.xref" href="#rev:xhtml.nodes.xref">5.1.4.1.4</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.xref">xref</a>
+  </h5>
+  <div class="content"><p>A cross-reference; a hyperlink that takes you to any node in the document.</p>
+
+<p>The first argument of this node is either the unique identifier or the user-defined title of the node you wish to cross-reference. If no nodes in the document have the given identifier or user-defined title, then an error will be raised.</p>
+
+<p>The second argument of this node overrides the default link text of the cross-reference.</p>
+
+<p>For example, this node in the input document:</p>
+
+<pre>&lt;%= xref &quot;SpecFile&quot; %&gt;</pre>
+
+<p>appears in the output document like this: <a class="xref" href="#SpecFile">Section 3.2. Format specification file</a>.</p>
+
+<p>As another example, this node in the input document:</p>
+
+<pre>&lt;%= xref &quot;SpecFile&quot;, &quot;custom link text&quot; %&gt;</pre>
+
+<p>appears in the output document like this: <a class="xref" href="#SpecFile" title="Section 3.2. Format specification file">custom link text</a>.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="Organizational-nodes" href="#rev:Organizational-nodes">5.1.4.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Organizational-nodes">Organizational nodes</a>
+  </h4>
+  <div class="content"><p>The nodes described in this section are meant to help organize the document&#8217;s content logically. Based on how deeply these nodes are nested in the document, their heading will be larger (shallow depth) or smaller (deep depth).</p>
+
+<p><div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.part" href="#rev:xhtml.nodes.part">5.1.4.2.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.part">part</a>
+  </h5>
+  <div class="content"><p>A collection of chapters.</p>
+
+<p><div class="part">
+  <h1 class="title">
+    Part&nbsp;<a class="list" title="Return to table of contents" id="An-example" href="#rev:An-example">5.1.4.2.1.1</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#An-example">An example</a></big>
+  </h1>
+  <div class="content"><p>This is how a <strong>part</strong> node appears.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.chapter" href="#rev:xhtml.nodes.chapter">5.1.4.2.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.chapter">chapter</a>
+  </h5>
+  <div class="content"><p>A collection of sections.</p>
+
+<p><div class="chapter">
+  <h1 class="title">
+    Chapter&nbsp;<a class="list" title="Return to table of contents" id="An-example-5.1.4.2.2.1" href="#rev:An-example-5.1.4.2.2.1">5.1.4.2.2.1</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#An-example-5.1.4.2.2.1">An example</a></big>
+  </h1>
+  <div class="content"><p>This is how a <strong>chapter</strong> node appears.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.section" href="#rev:xhtml.nodes.section">5.1.4.2.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.section">section</a>
+  </h5>
+  <div class="content"><p>A collection of paragraphs about a particular topic.</p>
+
+<p><div class="section">
+  <h6 class="title">
+    <a class="list" title="Return to table of contents" id="An-example-5.1.4.2.3.1" href="#rev:An-example-5.1.4.2.3.1">5.1.4.2.3.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#An-example-5.1.4.2.3.1">An example</a>
+  </h6>
+  <div class="content"><p>This is how a <strong>section</strong> node appears.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.paragraph" href="#rev:xhtml.nodes.paragraph">5.1.4.2.4</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.paragraph">paragraph</a>
+  </h5>
+  <div class="content"><p>A collection of sentences about a particular idea.</p>
+
+<p><div class="paragraph">
+  <p class="title"><a class="here" title="Permanent link to this section" href="#An-example-609202208">An example</a></p>
+  <div class="content"><p>This is how a <strong>paragraph</strong> node appears. Notice that there is no LaTeX-style index number in the heading of this <strong>paragraph</strong> node.</p></div>
+</div></p></div>
+</div></p></div>
+</div> <div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="Admonition-nodes" href="#rev:Admonition-nodes">5.1.4.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Admonition-nodes">Admonition nodes</a>
+  </h4>
+  <div class="content"><p>An admonition is basically a box that is indented more deeply than the text surrounding it. It is typically used to convey extraneous or pertinent information about the application of ideas discussed in the surrounding text.</p>
+
+<p>I like to follow the KDE guidelines<sup>[<a class="cite" href="#KDE.admonitions">1</a>]</sup> when determining which admonition to use in my documents.</p>
+
+<p> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.warning" href="#rev:xhtml.nodes.warning">5.1.4.3.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.warning">warning</a>
+  </h5>
+  <div class="content"><p>Use a <strong>warning</strong> node when &#8220;data loss could occur if you follow the procedure being described.&#8221; <sup>[<a class="cite" href="#KDE.admonitions">1</a>]</sup></p>
+
+<p><div class="warning">
+  <p class="title"><a class="list" title="Return to table of contents" id="An-example-1" href="#rev:An-example-1">Warning 1</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#An-example-1">An example</a></p>
+  <div class="content"><img class="icon" src="&icon_warning;" alt="warning"/><p>This is how a <strong>warning</strong> node appears.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.caution" href="#rev:xhtml.nodes.caution">5.1.4.3.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.caution">caution</a>
+  </h5>
+  <div class="content"><p>bq. A note of caution. Use this for example when the reader may lose easily recovered or replaceable information (e.g. user settings), or when they could cause data loss if they don&#8217;t correctly follow the procedure being outlined. <sup>[<a class="cite" href="#KDE.admonitions">1</a>]</sup></p>
+
+<p><div class="caution">
+  <p class="title"><a class="list" title="Return to table of contents" id="An-example-1-1" href="#rev:An-example-1-1">Caution 1</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#An-example-1-1">An example</a></p>
+  <div class="content"><img class="icon" src="&icon_caution;" alt="caution"/><p>This is how a <strong>caution</strong> node appears.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.important" href="#rev:xhtml.nodes.important">5.1.4.3.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.important">important</a>
+  </h5>
+  <div class="content"><p>Use an <strong>important</strong> node when:</p>
+
+<p>bq. When there is no danger of data loss, but you wish to make clear to the reader a consequence that isn&#8217;t immediately obvious (e.g. when changing the font for one instance of a program also changes the default setting, and this isn&#8217;t clear from the GUI.) <sup>[<a class="cite" href="#KDE.admonitions">1</a>]</sup></p>
+
+<p><div class="important">
+  <p class="title"><a class="list" title="Return to table of contents" id="An-example-2" href="#rev:An-example-2">Important 2</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#An-example-2">An example</a></p>
+  <div class="content"><img class="icon" src="&icon_important;" alt="important"/><p>This is how a <strong>important</strong> node appears.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.note" href="#rev:xhtml.nodes.note">5.1.4.3.4</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.note">note</a>
+  </h5>
+  <div class="content"><p>Use a <strong>note</strong> node to convey:</p>
+
+<p>bq. Information the user should be aware of, but is peripheral to the actual task being described. <sup>[<a class="cite" href="#KDE.admonitions">1</a>]</sup></p>
+
+<p><div class="note">
+  <p class="title"><a class="list" title="Return to table of contents" id="An-example-2-2" href="#rev:An-example-2-2">Note 2</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#An-example-2-2">An example</a></p>
+  <div class="content"><img class="icon" src="&icon_note;" alt="note"/><p>This is how a <strong>note</strong> node appears.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.tip" href="#rev:xhtml.nodes.tip">5.1.4.3.5</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.tip">tip</a>
+  </h5>
+  <div class="content"><p>Use a <strong>tip</strong> node when:</p>
+
+<p>bq. When you&#8217;re giving a hint to make things easier or more productive for the reader. <sup>[<a class="cite" href="#KDE.admonitions">1</a>]</sup></p>
+
+<p><div class="tip">
+  <p class="title"><a class="list" title="Return to table of contents" id="An-example-1-1-1" href="#rev:An-example-1-1-1">Tip 1</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#An-example-1-1-1">An example</a></p>
+  <div class="content"><img class="icon" src="&icon_tip;" alt="tip"/><p>This is how a <strong>tip</strong> node appears.</p></div>
+</div></p></div>
+</div></p></div>
+</div> <div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="Auxilary-materials" href="#rev:Auxilary-materials">5.1.4.4</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Auxilary-materials">Auxilary materials</a>
+  </h4>
+  <div class="content"><p><div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.figure" href="#rev:xhtml.nodes.figure">5.1.4.4.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.figure">figure</a>
+  </h5>
+  <div class="content"><p>A diagram, sketch, image, or illustration; something that visually depicts an idea or thought.</p>
+
+<p><div class="figure">
+  <p class="title"><a class="list" title="Return to table of contents" id="An-example-1-1-1-1" href="#rev:An-example-1-1-1-1">Figure 1</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#An-example-1-1-1-1">An example</a></p>
+  <div class="content"><p>This is how a <strong>figure</strong> node appears.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.table" href="#rev:xhtml.nodes.table">5.1.4.4.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.table">table</a>
+  </h5>
+  <div class="content"><p>Information (typically measurement data) represented in tabular form for easy reading, comparison, and analysis.</p>
+
+<p><div class="table">
+  <p class="title"><a class="list" title="Return to table of contents" id="An-example-1-1-1-1-1" href="#rev:An-example-1-1-1-1-1">Table 1</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#An-example-1-1-1-1-1">An example</a></p>
+  <div class="content"><p>This is how a <strong>table</strong> node appears.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.example" href="#rev:xhtml.nodes.example">5.1.4.4.3</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.example">example</a>
+  </h5>
+  <div class="content"><p>A sample application of an idea or thought.</p>
+
+<p><div class="example">
+  <p class="title"><a class="list" title="Return to table of contents" id="An-example-4" href="#rev:An-example-4">Example 4</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#An-example-4">An example</a></p>
+  <div class="content"><p>This is how a <strong>example</strong> node appears.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.equation" href="#rev:xhtml.nodes.equation">5.1.4.4.4</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.equation">equation</a>
+  </h5>
+  <div class="content"><p>A mathematical equation or formula.</p>
+
+<p><div class="equation">
+  <p class="title"><a class="list" title="Return to table of contents" id="An-example-1-1-1-1-1-1" href="#rev:An-example-1-1-1-1-1-1">Equation 1</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#An-example-1-1-1-1-1-1">An example</a></p>
+  <div class="content"><p>This is how a <strong>equation</strong> node appears.</p></div>
+</div></p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.procedure" href="#rev:xhtml.nodes.procedure">5.1.4.4.5</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.procedure">procedure</a>
+  </h5>
+  <div class="content"><p>An outline; a series of steps outlining some kind of process.</p>
+
+<p><div class="procedure">
+  <p class="title"><a class="list" title="Return to table of contents" id="An-example-1-1-1-1-1-1-1" href="#rev:An-example-1-1-1-1-1-1-1">Procedure 1</a>.&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#An-example-1-1-1-1-1-1-1">An example</a></p>
+  <div class="content"><p>This is how a <strong>procedure</strong> node appears.</p></div>
+</div></p></div>
+</div></p></div>
+</div> <div class="section">
+  <h4 class="title">
+    <a class="list" title="Return to table of contents" id="Bibliographical-nodes" href="#rev:Bibliographical-nodes">5.1.4.5</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#Bibliographical-nodes">Bibliographical nodes</a>
+  </h4>
+  <div class="content"><p>The nodes in this section deal with attribution of ideas&#8212;an important weapon against plagiarism.</p>
+
+<p><div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.reference" href="#rev:xhtml.nodes.reference">5.1.4.5.1</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.reference">reference</a>
+  </h5>
+  <div class="content"><p>This node stores bibliography information about an information source that is relevant to your document.</p>
+
+<p>If you wish to cite a certain source in several places in your document, start by creating a <strong>reference</strong> node first and then use a <strong>cite</strong> node (see <a class="xref" href="#xhtml.nodes.cite">Section 5.1.4.5.2. cite</a>) to perform the citation.</p>
+
+<p><div class="paragraph">
+  <p class="title"><a class="here" title="Permanent link to this section" href="#An-example-609275168">An example</a></p>
+  <div class="content"><p>See <a class="xref" href="#xhtml.nodes.reference.example">Reference 2</a> for an example of how a <strong>reference</strong> node appears.</p></div>
+</div> </p></div>
+</div> <div class="section">
+  <h5 class="title">
+    <a class="list" title="Return to table of contents" id="xhtml.nodes.cite" href="#rev:xhtml.nodes.cite">5.1.4.5.2</a>&nbsp;&nbsp;<a class="here" title="Permanent link to this section" href="#xhtml.nodes.cite">cite</a>
+  </h5>
+  <div class="content"><p>A citation to a <strong>reference</strong> node (see <a class="xref" href="#xhtml.nodes.reference">Section 5.1.4.5.1. reference</a>) in the document&#8217;s bibliography.</p>
+
+<p>The first argument of this node is the unique identifier of the reference node you wish to cite. You can specify additional arguments to give more detail about the citation.</p>
+
+<p>For example, this node in the input document:</p>
+
+<pre>&lt;%= cite &quot;xhtml.nodes.reference.example&quot; %&gt;</pre>
+
+<p>appears in the output document like this: <sup>[<a class="cite" href="#xhtml.nodes.reference.example">2</a>]</sup></p>
+
+<p>As another example, this node in the input document:</p>
+
+<pre>&lt;%= cite &quot;xhtml.nodes.reference.example&quot;, &quot;chapter 10&quot;, &quot;page 53&quot;, &quot;...&quot; %&gt;</pre>
+
+<p>appears in the output document like this: <sup>[<a class="cite" href="#xhtml.nodes.reference.example">2</a>, chapter 10, page 53, ...]</sup></p></div>
+</div></p></div>
+</div></p></div>
+</div></p></div>
+</div></p>
+
+<p><div class="chapter">
+  <h1 class="title">
+    Chapter&nbsp;<a class="list" title="Return to table of contents" id="text" href="#rev:text">5.2</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#text">Plain text</a></big>
+  </h1>
+  <div class="content"><p>This format is not yet implemented. I will do this evenually, but until then, <strong>patches are welcome!</strong> :-)</p>
+<a href='http://en.wikipedia.org/wiki/Plain_text'>http://en.wikipedia.org/wiki/Plain_text</a></div>
+</div> <div class="chapter">
+  <h1 class="title">
+    Chapter&nbsp;<a class="list" title="Return to table of contents" id="latex" href="#rev:latex">5.3</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#latex">LaTeX (PDF)</a></big>
+  </h1>
+  <div class="content"><p>This format is not yet implemented. I will do this evenually, but until then, <strong>patches are welcome!</strong> :-)</p>
+<a href='http://www.latex-project.org'>http://www.latex-project.org</a></div>
+</div> <div class="chapter">
+  <h1 class="title">
+    Chapter&nbsp;<a class="list" title="Return to table of contents" id="man" href="#rev:man">5.4</a>
+    <br/>
+    <big><a class="here" title="Permanent link to this section" href="#man">man (UNIX manual page)</a></big>
+  </h1>
+  <div class="content"><p>This format is not yet implemented. I will do this evenually, but until then, <strong>patches are welcome!</strong> :-)</p>
+<a href='http://en.wikipedia.org/wiki/Man_page'>http://en.wikipedia.org/wiki/Man_page</a></div>
+</div></p></div>
+</div></div>
+
+    <div id="bib">
+      <h1 class="title" id="References"><a class="here" href="#References">References</a></h1>
+      <ol>
+        <li id="KDE.admonitions"><p>L. Watts, &#8220;Admonitions: Tips, hints, and Warnings&#8221;, in <em>The KDE DocBook Authors guide</em>, Chapter 13, [Online document], 22 September 2004 (Revision 1.00.00), [cited 8 December 2007], Available at <a href='http://l10n.kde.org/docs/markup/tips-hints-etc.html'>http://l10n.kde.org/docs/markup/tips-hints-etc.html</a></p></li>
+        <li id="xhtml.nodes.reference.example"><p>This is how a <strong>reference</strong> node appears.</p></li>
+      </ol>
+    </div>
+
+    <br style="display: none"/>
+    <hr style="display: none"/>
+    <br style="display: none"/>
+
+    
+    <div id="footer">
+    
+      Generated by <a href="http://snk.tuxfamily.org/lib/erbook">erbook 5.0.0</a> on Sat Nov 22 23:17:15 -0800 2008.
+
+    <div id="footer-credits">
+      <p>
+          <img class="icon" src="&icon_caution;" alt="caution"/>
+          <img class="icon" src="&icon_tip;" alt="tip"/>
+          <img class="icon" src="&icon_important;" alt="important"/>
+          <img class="icon" src="&icon_note;" alt="note"/>
+          <img class="icon" src="&icon_warning;" alt="warning"/>
+          <img class="icon" src="&icon_quote;" alt="quote"/>
+
+        <br/>
+
+        The icons shown above are &copy; 2005 <a href="http://tango.freedesktop.org">Tango Desktop Project</a>. They are part of the <a href="http://tango.freedesktop.org/Tango_Icon_Library">Tango Icon Theme</a> set, which is distributed under the <a href="http://creativecommons.org/licenses/by-sa/2.5/">Creative Commons Attribution-ShareAlike 2.5 License Agreement</a>.
+      </p>
+
+      <p>
+          <img class="icon" src="&icon_link;" alt="link"/>
+
+        <br/>
+
+        The icons shown above are &copy; 2007 <a href="https://www.ohloh.net/projects/mediawiki/contributors">MediaWiki contributors</a>. They are part of the <a href="http://www.mediawiki.org/wiki/MediaWiki">MediaWiki</a> software, which is distributed under the <a href="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html">GNU General Public License, version 2</a>.
+      </p>
+    </div>
+    
+    </div>
+    
+  </body>
+</html>