anchor.diff:  :idprefix:
   :idseparator: -
   
  -{homepage}[Asciidoctor] is a pure Ruby processor for converting {asciidoc}[AsciiDoc] source files and strings into HTML 5, DocBook 5.0, DocBook 4.5 and other formats. 
  -It's {gem}[published as a RubyGem] and is available under the MIT open source license.
  +{homepage}[Asciidoctor] is an open source text processor and publishing toolchain for transforming {asciidoc}[AsciiDoc] markup into HTML 5, DocBook 4.5 and 5.0 and other custom formats.
  +Asciidoctor is written entirely in Ruby, packaged as a RubyGem and published to {gem}[RubyGems.org].
  +There are also Fedora, Debian and Ubuntu packages available for installing Asciidoctor.
  +Asciidoctor is released under the MIT license.
   
   ifndef::awestruct[]
   image::https://travis-ci.org/asciidoctor/asciidoctor.png?branch=master[Build Status, link="https://travis-ci.org/asciidoctor/asciidoctor"]
   endif::awestruct[]
   
  -Asciidoctor uses a set of built-in ERB templates to render the document to HTML 5 or DocBook.
  -We've matched the rendered output as close as possible to the default output of the native Python processor. 
  -You can override this behavior by providing {tilt}[Tilt]-compatible templates.
  +== AsciiDoc Processing
  +
  +Asciidoctor reads and parses AsciiDoc markup (from a file or string) and feeds the parsed result to a set of built-in templates to render the document as HTML 5, DocBook 4.5 or DocBook 5.0.
  +Asciidoctor is a drop-in replacement for the original AsciiDoc processor.
  +We've matched the output to that produced by the AsciiDoc Python processor as faithfully as possible.
  +You can override the built-in templates, or produce a custom format, by pointing the processor at a set of template files written in a language supported by {tilt}[Tilt].
   See the <<usage>> section for more details.
  +
  +NOTE: With few exceptions, Asciidoctor is compliant with the original AsciiDoc processor.
  +Asciidoctor has well over 1,000 tests to ensure compatibility with the AsciiDoc syntax.
  +We continue to work hard to ensure Asciidoctor continues to serve as a drop-in replacement for AsciiDoc. 
   
   == Operating Systems
   
  
positive.code: .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:
  
  
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:
  
  