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: ----
  // .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.
  
  
negative.code: 
  ----
  
  === HTML
  
  [source, html]
  .Syntax
  ----
  <!-- .first-example
    Each example must be preceded by a comment; the first line must contain the
    example’s name prefixed with 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
    You may also specify options for comparing or Asciidoctor renderer. Option
    line starts with a semicolon, then comes the option name ended by a
    semicolon and after that the option’s value (may be omitted for boolean
    options).
    :include: .//section[0]/node()
    :exclude: ./div[@class="listingblock"]
    :header_footer:
  -->
  <div class="colist">
    <ol>
      <li>Method signature</li>
      <li>Some stuff inside</li>
      <li>Return statement</li>
    </ol>
  </div>
  
  ----
  
  == TODO
  
  * describe how to use it
  * write specs
  
  
  == Contributing
  
  . Fork it
  . Create your feature branch (`git checkout -b my-new-feature`)
  . Commit your changes (`git commit -am 'Add some feature'`)
  . Push to the branch (`git push origin my-new-feature`)
  . Create new Pull Request
  
  == License
  
  This project is licensed under http://opensource.org/licenses/MIT/[MIT License]. For the full text of the license, see the link:LICENSE[LICENSE] file.
  