anchor.diff:  :install-mac: http://asciidoctor.org/docs/install-asciidoctor-macosx/
   :render: http://asciidoctor.org/docs/render-documents
   :factory: http://asciidoctor.org/docs/produce-custom-themes-using-asciidoctor-stylesheet-factory
  +:java: http://asciidoctor.org/docs/install-and-use-asciidoctor-java-integration
   :man: http://asciidoctor.org/man/asciidoctor 
   :sources: https://github.com/asciidoctor/asciidoctor
  +:tests: https://github.com/asciidoctor/asciidoctor/tree/master/test
   :issues: https://github.com/asciidoctor/asciidoctor/issues
   :forum: http://discuss.asciidoctor.org
   :irc: irc://irc.freenode.org/#asciidoctor
  
positive.code: 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. 
  (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 enable it using the +:header_footer+ 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 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')
  
  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. 
  
negative.code: 
  == Contributing
  
  In the spirit of {freesoftware}[free software], _everyone_ is encouraged to help improve this project.
  
  Here are some ways *you* can contribute:
  
  