anchor.diff:  == AsciiDoc Processing
   
   Asciidoctor reads and parses text written in the AsciiDoc syntax, then feeds the parse tree into a set of built-in templates to produce HTML5, DocBook 5 (or 4.5).
  -You have the option of writing your own converter or providing {tilt-uri}[Tilt]-supported templates to customize the generated output or produce alternative formats.
  +You have the option of writing your own converter or providing {uri-tilt}[Tilt]-supported templates to customize the generated output or produce alternative formats.
   
   NOTE: Asciidoctor is a drop-in replacement for the original AsciiDoc Python processor (`asciidoc.py`).
  -The Asciidoctor test suite has {tests-uri}[> 1,500 tests] to ensure compatibility with the AsciiDoc syntax.
  +The Asciidoctor test suite has {uri-tests}["> 1,500 tests"] to ensure compatibility with the AsciiDoc syntax.
   
   In addition to the standard AsciiDoc syntax, Asciidoctor recognizes additional markup and formatting options, such as font-based icons (e.g., [x-]`icon:fire[]`) and UI elements (e.g., [x-]`button:[Save]`).
  -Asciidoctor also offers a modern, responsive theme based on {foundation-uri}[Foundation] to style the HTML5 output.
  +Asciidoctor also offers a modern, responsive theme based on {uri-foundation}[Foundation] to style the HTML5 output.
   
   == Requirements
   
  -Asciidoctor works on Linux, OSX (Mac) and Windows and requires one of the following implementations of {ruby-uri}[Ruby]:
  +Asciidoctor works on Linux, OSX (Mac) and Windows and requires one of the following implementations of {uri-ruby}[Ruby]:
   
   * MRI (Ruby 1.8.7, 1.9.3, 2.0.0 & 2.1.2)
   * JRuby 1.7 (Ruby 1.8 and 1.9 modes)
  
positive.code: html = document.convert
  ----
  
  Keep in mind, if you don't like the output you see, _you can change it!_
  Asciidoctor supports custom {tilt-uri}[Tilt]-supported templates, which to allow you customize the output piecemeal, or custom converters, which give you 100% control over the output.
  
  For more information about how to use the API or to customize the output, see the {user-manual-uri}[user manual].
  
  == Contributing
  
  In the spirit of {freesoftware-uri}[free software], _everyone_ is encouraged to help improve this project.
  If you discover errors or ommisions in the source code, documentation, or website content, please don't hesitate to submit an issue or open a pull request with a fix.
  New contributors are always welcome!
  
  Here are some ways *you* can contribute:
  
  * by using alpha, beta, and prerelease versions
  * by reporting bugs
  * by suggesting new features
  * by writing or editing documentation
  
negative.code: 
  === Other installation options
  
  * {uri-install-doc}[Installing the Asciidoctor toolchain]
  * {uri-install-osx-doc}[Installing Asciidoctor on Mac OS X]
  
  == Usage
  
  If the Asciidoctor gem installed successfully, the `asciidoctor` command line interface (CLI) will be available on your PATH.
  To verify it's available, run the following in your terminal:
  
   $ asciidoctor --version
  
  You should see information about the Asciidoctor version and your Ruby environment printed in the terminal.
  
  [.output]
  ....
  Asciidoctor 1.5.0 [http://asciidoctor.org]
  Runtime Environment (ruby 2.1.2p95 (2014-05-08 revision 45877) [x86_64-linux])
  ....
  
  Asciidoctor also provides an API.
  The API is intended for integration with other Ruby software, such as Rails, Sinatra and GitHub, and other languages, such as Java (via {uri-asciidoctorj}[AsciidoctorJ]) and JavaScript (via {uri-asciidoctorjs}[Asciidoctor.js]).
  
  === Command line interface (CLI)
  
  The `asciidoctor` command allows you to invoke Asciidoctor from the command line (i.e., a terminal).
  
  The following command converts the file README.adoc to HTML and saves the result to the file README.html in the same directory.
  The name of the generated HTML file is derived from the source file by changing its file extension to `.html`.
  
   $ asciidoctor README.adoc
  