anchor.diff:  built-in templates for any elements for which it finds a matching
   template. It will fallback to its default templates for everything else.
   
  - doc = Asciidoctor::Document.new("*This* is it.", :template_dir => 'templates')
  - puts doc.render
  + puts Asciidoctor.render('*This* is it.', :header_footer => true,
  +   :template_dir => 'templates')
   
   The Document and Section templates should begin with `document.` and
   `section.`, respectively. The file extension is used by Tilt to
  
positive.code: :branch: http://learn.github.com/p/branching.html
  :pr: http://help.github.com/send-pull-requests/
  :license: https://github.com/erebor/asciidoctor/blob/master/LICENSE
  
  {asciidoctor}[Asciidoctor] is a pure-Ruby processor for turning
  {asciidoc}[AsciiDoc] documents or strings into HTML (and, eventually
  other formats as well...'stay tuned!').
  
  image::https://travis-ci.org/erebor/asciidoctor.png?branch=master["Build Status", link="https://travis-ci.org/erebor/asciidoctor"]
  
  Asciidoctor uses simple built-in ERB templates to style the output in
  a way that roughly matches the default HTML output of the native
  Python processor. You can override this behavior by providing
  {tilt}[Tilt]-compatible templates. See the xref:usage[Usage section]
  for more details.
  
  Asciidoctor currently works with Ruby 1.8.7 and 1.9.3, though I don't
  know of any reason it shouldn't work with more exotic Ruby versions,
  and would welcome help in testing that out.
  
  The initial code from which Asciidoctor started was from the
  {gitscm-next}[Git SCM site repo]. Refer to commit history of
  {asciidoctorseed}[asciidoc.rb] to view the initial contributions.
  
  == Installation
  
  NOTE: This gem is very immature, and as yet only supports a small subset
  of AsciiDoc features (but it's getting better!). Thus, you should only
  use it if you have a high tolerance for bugs, failures, and generally
  bad and intemperate behavior.
  
  To install the gem:
  
  
negative.code: 
  == Usage
  
  To use Asciidoctor in your application, you first need to require the
  library:
  
   require 'asciidoctor'
  
  With that in place, you can start processing AsciiDoc documents.
  
  .Loading a document
  To parse a file into an `Asciidoctor::Document` object:
  
   doc = Asciidoctor.load_file('your_file.asciidoc')
  
  You can get information about the document:
  
   puts doc.doctitle
   puts doc.attributes
  
  More than likely, you want to just render the document.
  
  .Rendering files
  To render a file containing AsciiDoc markup to HTML 5:
  
   Asciidoctor.render_file('your_file.asciidoc', :in_place => true)
  
  The command will output to the file `your_file.html` in the same
  directory. You can render the file to DocBook 4.5 by setting the
  `backend` attribute to 'docbook':
  
   Asciidoctor.render_file('your_file.asciidoc', :in_place => true,
     :attributes => {'backend' => 'docbook'})
  
  The command will output to the file `your_file.xml` in the same
  directory. (If you're on Linux, you can view the file using yelp).
  
  .Rendering strings
  To render an AsciiDoc-formatted string:
  
   puts Asciidoctor.render('*This* is it.')
  
  When rendering a string, the header and footer are excluded by default
  to make Asciidoctor consistent with other lightweight markup engines
  like Markdown. If you want the header and footer, just declare it as
  an option:
  
   puts Asciidoctor.render('*This* is it.', :header_footer => true)
  
  Now you'll get a full HTML 5 file. As before, you can also produce
  DocBook 4.5:
  
   puts Asciidoctor.render('*This* is it.', :header_footer => true,
     :attributes => {'backend' => 'docbook'})
  
  If you don't like the output you see, you can change it. Any of it!
  
  .Custom templates
  Asciidoctor allows you to override the {templates}[built-in templates]
  used to render almost any individual AsciiDoc element. If you provide a
  directory of {tilt}[Tilt]-compatible templates, named in such a way that
  