anchor.diff:  
   == The Big Picture
   
  +Asciidoctor reads content written in plain text, as shown in the panel on the left in the image below, and converts it to HTML5, as shown rendered in the right panel.
  +Asciidoctor adds a default stylesheet to the HTML5 document, as shown, to provide a pleasant out-of-the-box experience.
  +
   image::{screenshot-img}[Preview of AsciiDoc source and corresponding rendered HTML]
   
   == 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 HTML 5, DocBook 5 or DocBook 4.5.
  -You have the option of using your own {tilt-uri}[Tilt]-supported templates to customize the generated output or to convert AsciiDoc to additional formats.
  +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 to convert the AsciiDoc to alternative formats.
   
   NOTE: Asciidoctor is a drop-in replacement for the original AsciiDoc Python processor.
   The project has {tests-uri}[> 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 HTML output.
  +Asciidoctor also offers a modern, responsive theme based on {foundation-uri}[Foundation] to style the HTML5 output.
   
   == Requirements
   
  
positive.code: // [settings]
  :page-layout: base
  :idprefix:
  :idseparator: -
  :source-language: ruby
  :language: {source-language}
  
negative.code: // [Images]
  :screenshot-img: screenshot.png
  
  {project-uri}[Asciidoctor] is a _fast_ text processor and publishing toolchain for converting {what-is-asciidoc-uri}[AsciiDoc] content to HTML5, DocBook 5 (or 4.5) and other formats.
  Asciidoctor is written in {ruby-uri}[Ruby], packaged as a RubyGem and published to {rubygem-uri}[RubyGems.org].
  The gem is also packaged in several Linux distributions, including Fedora, Debian and Ubuntu.
  Asciidoctor is open source, {repo-uri}[hosted on GitHub] and released under the MIT license.
  
  TIP: You can run Asciidoctor on the JVM using JRuby.
  You can also use the Asciidoctor APIs from Java and other JVM languages using {asciidoctorj-uri}[AsciidoctorJ].
  Asciidoctor can also be used in JavaScript.
  http://opalrb.org[Opal] is used to transcompile the code from Ruby to JavaScript to make {asciidoctorjs-uri}[Asciidoctor.js], which can be used whereever JavaScript runs, such as in a web browser or on Node.js.
  
  ifdef::env-github[]
  *Project health:* image:https://travis-ci.org/asciidoctor/asciidoctor.png?branch=master[Build Status, link="https://travis-ci.org/asciidoctor/asciidoctor"]
  