anchor.diff: -= AdocSpec examples
  += Asciidoctor::DocTest
   
  -This directory contains example suites for testing Asciidoctor backends (templates).
  +DocTest is a test suite for Asciidoctor backends based on comparing of textual examples.
   
   TODO
   
  -.Directory structure
  -----
  -examples
  -|-- asciidoc
  -|   |-- block_admonition.adoc
  -|   |-- block_audio.adoc
  -|   |-- ...
  -|   +-- section.adoc
  -+-- {backend-name}
  -|   |-- block_admonition.{suffix}
  -|   |-- block_audio.{suffix}
  -|   |-- ...
  -|   +-- section.{suffix}
  -+-- README.adoc
  -----
   
  -== /asciidoc
  +== Installation
  +
  +Add this line to your Asciidoctor backend’s Gemfile:
  +
  +```ruby
  +gem 'asciidoctor-doctest'
  +```
  +
  +And then execute:
  +
  + $ bundle
  +
  +
  +== Testing examples
  +
  +=== AsciiDoc
   
   The reference examples in Asciidoc(tor) syntax.
   
  
positive.code: 
  ----
  
  == /html5
  
  [source, html]
  .Syntax
  ----
  <!-- .first-example
    Each block must be preceded by a comment; the first line must contain the
    example's name prefixed with a dot.
  -->
  <p>The example's content in <strong>HTML</strong>.</p>
  
  <div class="note">The trailing new line (below this) will be removed.</div>
  
  <!-- .second-example
  :option name: value
  -->
  <ol>
    <li>List item level 1
      <ol>
        <li>List item level 2</li>
      </ol>
    </li>
  </ol>
  
  ----
  
negative.code: ----
  // .first-example
  // Each block must be preceded by a comment; the first line must contain the
  // example’s name prefixed with a dot.
  The example’s content in *Asciidoc*.
  
  NOTE: The trailing new line (below this) will be removed.
  
  