anchor.diff:  More than likely, you will want to 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. 
  +--
  +To render a file containing AsciiDoc markup to HTML 5, use:
  +
  + Asciidoctor.render_file 'sample.adoc', :in_place => true
  +
  +The command will output to the file +sample.html+ in the same directory. 
  +
  +You can render the file to DocBook 4.5 by setting the +:backend+ option to +'docbook'+:
  +
  + Asciidoctor.render_file 'sample.adoc', :in_place => true, :backend => 'docbook'
  +
  +The command will output to the file +sample.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.')
  + puts Asciidoctor.render '*This* is Asciidoctor.'
   
   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 enable it using the +:header_footer+ option:
   
  - puts Asciidoctor.render('*This* is it.', :header_footer => true)
  + puts Asciidoctor.render '*This* is Asciidoctor.', :header_footer => true
   
   Now you'll get a full HTML 5 file. 
  +If you only want the inline markup to be processed, set the +:doctype+ option to +'inline'+:
  +
  + puts Asciidoctor.render '*This* is Asciidoctor.', :doctype => 'inline'
  +
   As before, you can also produce DocBook 4.5:
   
  - puts Asciidoctor.render('*This* is it.', :header_footer => true,
  -   :attributes => {'backend' => 'docbook'})
  + puts Asciidoctor.render '*This* is Asciidoctor.', :header_footer => true,
  +   :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 Asciidoctor can figure out which template goes with which element, Asciidoctor will use the templates in this directory instead of its built-in templates for any elements for which it finds a matching template. 
   It will fallback to its default templates for everything else.
   
  - puts Asciidoctor.render('*This* is it.', :header_footer => true,
  -   :template_dir => 'templates')
  + puts Asciidoctor.render '*This* is Asciidoctor.', :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 determine which view framework it will use to use to render the template. 
  
positive.code: 
  If you would like this library to support another Ruby version, you may volunteer to be a maintainer. 
  Being a maintainer entails making sure all tests run and pass on that implementation. 
  When something breaks on your implementation, you will be personally responsible for providing patches in a timely fashion. 
  If critical issues for a particular implementation exist at the time of a major release, support for that Ruby version may be dropped.
  
  // vim: tw=72
  
negative.code: .Loading a document
  To parse a file into an +Asciidoctor::Document+ object:
  
   doc = Asciidoctor.load_file 'sample.adoc'
  
  You can get information about the document:
  
  