asciidoctor 1.5.8 → 2.0.17

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: asciidoctor
 version: !ruby/object:Gem::Version
-  version: 1.5.8
+  version: 2.0.17
 platform: ruby
 authors:
 - Dan Allen
@@ -13,24 +13,10 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-10-28 00:00:00.000000000 Z
+date: 2022-01-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: asciimath
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.0.0
-- !ruby/object:Gem::Dependency
-  name: coderay
+  name: concurrent-ruby
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
@@ -49,98 +35,98 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: 3.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.4.0
+        version: 3.1.0
 - !ruby/object:Gem::Dependency
-  name: erubis
+  name: erubi
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.7.0
+        version: 1.10.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.7.0
+        version: 1.10.0
 - !ruby/object:Gem::Dependency
   name: haml
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.0.0
+        version: 5.2.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.0.0
+        version: 5.2.0
 - !ruby/object:Gem::Dependency
-  name: nokogiri
+  name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.8.5
+        version: 5.14.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.8.5
+        version: 5.14.0
 - !ruby/object:Gem::Dependency
-  name: rake
+  name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 10.0.0
+        version: 1.10.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 10.0.0
+        version: 1.10.0
 - !ruby/object:Gem::Dependency
-  name: rspec-expectations
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.14.0
+        version: 12.3.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.14.0
+        version: 12.3.0
 - !ruby/object:Gem::Dependency
   name: slim
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.1.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 4.0.0
+        version: 4.1.0
 - !ruby/object:Gem::Dependency
   name: tilt
   requirement: !ruby/object:Gem::Requirement
@@ -155,48 +141,27 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 2.0.0
-- !ruby/object:Gem::Dependency
-  name: minitest
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 5.3.0
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 5.3.0
-description: A fast, open source text processor and publishing toolchain, written
-  in Ruby, for converting AsciiDoc content to HTML5, DocBook 5 (or 4.5) and other
-  formats.
+description: A fast, open source text processor and publishing toolchain for converting
+  AsciiDoc content to HTML 5, DocBook 5, and other formats.
 email:
 - dan.j.allen@gmail.com
 executables:
 - asciidoctor
-- asciidoctor-safe
 extensions: []
-extra_rdoc_files:
-- CHANGELOG.adoc
-- CONTRIBUTING.adoc
-- LICENSE
+extra_rdoc_files: []
 files:
+- ".yardopts"
 - CHANGELOG.adoc
-- CONTRIBUTING.adoc
-- Gemfile
 - LICENSE
 - README-de.adoc
 - README-fr.adoc
 - README-jp.adoc
 - README-zh_CN.adoc
 - README.adoc
-- Rakefile
 - asciidoctor.gemspec
 - bin/asciidoctor
-- bin/asciidoctor-safe
 - data/locale/attributes-ar.adoc
+- data/locale/attributes-be.adoc
 - data/locale/attributes-bg.adoc
 - data/locale/attributes-ca.adoc
 - data/locale/attributes-cs.adoc
@@ -211,7 +176,7 @@ files:
 - data/locale/attributes-id.adoc
 - data/locale/attributes-it.adoc
 - data/locale/attributes-ja.adoc
-- data/locale/attributes-kr.adoc
+- data/locale/attributes-ko.adoc
 - data/locale/attributes-nb.adoc
 - data/locale/attributes-nl.adoc
 - data/locale/attributes-nn.adoc
@@ -223,18 +188,16 @@ files:
 - data/locale/attributes-sr.adoc
 - data/locale/attributes-sr_Latn.adoc
 - data/locale/attributes-sv.adoc
+- data/locale/attributes-th.adoc
 - data/locale/attributes-tr.adoc
 - data/locale/attributes-uk.adoc
+- data/locale/attributes-vi.adoc
 - data/locale/attributes-zh_CN.adoc
 - data/locale/attributes-zh_TW.adoc
 - data/locale/attributes.adoc
+- data/reference/syntax.adoc
 - data/stylesheets/asciidoctor-default.css
 - data/stylesheets/coderay-asciidoctor.css
-- features/open_block.feature
-- features/pass_block.feature
-- features/step_definitions.rb
-- features/text_formatting.feature
-- features/xref.feature
 - lib/asciidoctor.rb
 - lib/asciidoctor/abstract_block.rb
 - lib/asciidoctor/abstract_node.rb
@@ -244,132 +207,57 @@ files:
 - lib/asciidoctor/cli.rb
 - lib/asciidoctor/cli/invoker.rb
 - lib/asciidoctor/cli/options.rb
+- lib/asciidoctor/convert.rb
 - lib/asciidoctor/converter.rb
-- lib/asciidoctor/converter/base.rb
 - lib/asciidoctor/converter/composite.rb
-- lib/asciidoctor/converter/docbook45.rb
 - lib/asciidoctor/converter/docbook5.rb
-- lib/asciidoctor/converter/factory.rb
 - lib/asciidoctor/converter/html5.rb
 - lib/asciidoctor/converter/manpage.rb
 - lib/asciidoctor/converter/template.rb
 - lib/asciidoctor/core_ext.rb
-- lib/asciidoctor/core_ext/1.8.7/base64/strict_encode64.rb
-- lib/asciidoctor/core_ext/1.8.7/concurrent/hash.rb
-- lib/asciidoctor/core_ext/1.8.7/hash/key.rb
-- lib/asciidoctor/core_ext/1.8.7/io/binread.rb
-- lib/asciidoctor/core_ext/1.8.7/io/write.rb
-- lib/asciidoctor/core_ext/1.8.7/string/chr.rb
-- lib/asciidoctor/core_ext/1.8.7/string/limit_bytesize.rb
-- lib/asciidoctor/core_ext/1.8.7/symbol/empty.rb
-- lib/asciidoctor/core_ext/1.8.7/symbol/length.rb
+- lib/asciidoctor/core_ext/float/truncate.rb
+- lib/asciidoctor/core_ext/hash/merge.rb
+- lib/asciidoctor/core_ext/match_data/names.rb
 - lib/asciidoctor/core_ext/nil_or_empty.rb
 - lib/asciidoctor/core_ext/regexp/is_match.rb
-- lib/asciidoctor/core_ext/string/limit_bytesize.rb
 - lib/asciidoctor/document.rb
 - lib/asciidoctor/extensions.rb
 - lib/asciidoctor/helpers.rb
 - lib/asciidoctor/inline.rb
 - lib/asciidoctor/list.rb
+- lib/asciidoctor/load.rb
 - lib/asciidoctor/logging.rb
 - lib/asciidoctor/parser.rb
 - lib/asciidoctor/path_resolver.rb
 - lib/asciidoctor/reader.rb
+- lib/asciidoctor/rouge_ext.rb
+- lib/asciidoctor/rx.rb
 - lib/asciidoctor/section.rb
 - lib/asciidoctor/stylesheets.rb
 - lib/asciidoctor/substitutors.rb
+- lib/asciidoctor/syntax_highlighter.rb
+- lib/asciidoctor/syntax_highlighter/coderay.rb
+- lib/asciidoctor/syntax_highlighter/highlightjs.rb
+- lib/asciidoctor/syntax_highlighter/html_pipeline.rb
+- lib/asciidoctor/syntax_highlighter/prettify.rb
+- lib/asciidoctor/syntax_highlighter/pygments.rb
+- lib/asciidoctor/syntax_highlighter/rouge.rb
 - lib/asciidoctor/table.rb
 - lib/asciidoctor/timings.rb
 - lib/asciidoctor/version.rb
+- lib/asciidoctor/writer.rb
 - man/asciidoctor.1
 - man/asciidoctor.adoc
-- test/api_test.rb
-- test/attribute_list_test.rb
-- test/attributes_test.rb
-- test/blocks_test.rb
-- test/converter_test.rb
-- test/document_test.rb
-- test/extensions_test.rb
-- test/fixtures/asciidoc_index.txt
-- test/fixtures/basic-docinfo-footer.html
-- test/fixtures/basic-docinfo-footer.xml
-- test/fixtures/basic-docinfo.html
-- test/fixtures/basic-docinfo.xml
-- test/fixtures/basic.asciidoc
-- test/fixtures/chapter-a.adoc
-- test/fixtures/child-include.adoc
-- test/fixtures/circle.svg
-- test/fixtures/custom-backends/erb/html5/block_paragraph.html.erb
-- test/fixtures/custom-backends/haml/docbook45/block_paragraph.xml.haml
-- test/fixtures/custom-backends/haml/html5-tweaks/block_paragraph.html.haml
-- test/fixtures/custom-backends/haml/html5/block_paragraph.html.haml
-- test/fixtures/custom-backends/haml/html5/block_sidebar.html.haml
-- test/fixtures/custom-backends/slim/docbook45/block_paragraph.xml.slim
-- test/fixtures/custom-backends/slim/html5/block_paragraph.html.slim
-- test/fixtures/custom-backends/slim/html5/block_sidebar.html.slim
-- test/fixtures/custom-docinfodir/basic-docinfo.html
-- test/fixtures/custom-docinfodir/docinfo.html
-- test/fixtures/docinfo-footer.html
-- test/fixtures/docinfo-footer.xml
-- test/fixtures/docinfo.html
-- test/fixtures/docinfo.xml
-- test/fixtures/doctime-localtime.adoc
-- test/fixtures/dot.gif
-- test/fixtures/encoding.asciidoc
-- test/fixtures/file-with-missing-include.adoc
-- test/fixtures/grandchild-include.adoc
-- test/fixtures/hello-asciidoctor.pdf
-- test/fixtures/include-file.asciidoc
-- test/fixtures/include-file.jsx
-- test/fixtures/include-file.ml
-- test/fixtures/include-file.xml
-- test/fixtures/lists.adoc
-- test/fixtures/master.adoc
-- test/fixtures/mismatched-end-tag.adoc
-- test/fixtures/other-chapters.adoc
-- test/fixtures/outer-include.adoc
-- test/fixtures/parent-include-restricted.adoc
-- test/fixtures/parent-include.adoc
-- test/fixtures/sample.asciidoc
-- test/fixtures/section-a.adoc
-- test/fixtures/stylesheets/custom.css
-- test/fixtures/subdir/index.adoc
-- test/fixtures/subdir/inner-include.adoc
-- test/fixtures/subdir/middle-include.adoc
-- test/fixtures/subs-docinfo.html
-- test/fixtures/subs.adoc
-- test/fixtures/tagged-class-enclosed.rb
-- test/fixtures/tagged-class.rb
-- test/fixtures/tip.gif
-- test/fixtures/unclosed-tag.adoc
-- test/fixtures/unexpected-end-tag.adoc
-- test/invoker_test.rb
-- test/links_test.rb
-- test/lists_test.rb
-- test/logger_test.rb
-- test/manpage_test.rb
-- test/options_test.rb
-- test/paragraphs_test.rb
-- test/parser_test.rb
-- test/paths_test.rb
-- test/preamble_test.rb
-- test/reader_test.rb
-- test/sections_test.rb
-- test/substitutions_test.rb
-- test/tables_test.rb
-- test/test_helper.rb
-- test/text_test.rb
-homepage: http://asciidoctor.org
+homepage: https://asciidoctor.org
 licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/asciidoctor/asciidoctor/issues
-  changelog_uri: https://github.com/asciidoctor/asciidoctor/blob/master/CHANGELOG.adoc
+  changelog_uri: https://github.com/asciidoctor/asciidoctor/blob/HEAD/CHANGELOG.adoc
   mailing_list_uri: http://discuss.asciidoctor.org
   source_code_uri: https://github.com/asciidoctor/asciidoctor
 post_install_message: 
-rdoc_options:
-- "--charset=UTF-8"
+rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
@@ -383,91 +271,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.7.7
+rubygems_version: 3.2.32
 signing_key: 
 specification_version: 4
 summary: An implementation of the AsciiDoc text processor and publishing toolchain
-  in Ruby
-test_files:
-- features/open_block.feature
-- features/pass_block.feature
-- features/step_definitions.rb
-- features/text_formatting.feature
-- features/xref.feature
-- test/api_test.rb
-- test/attribute_list_test.rb
-- test/attributes_test.rb
-- test/blocks_test.rb
-- test/converter_test.rb
-- test/document_test.rb
-- test/extensions_test.rb
-- test/fixtures/asciidoc_index.txt
-- test/fixtures/basic-docinfo-footer.html
-- test/fixtures/basic-docinfo-footer.xml
-- test/fixtures/basic-docinfo.html
-- test/fixtures/basic-docinfo.xml
-- test/fixtures/basic.asciidoc
-- test/fixtures/chapter-a.adoc
-- test/fixtures/child-include.adoc
-- test/fixtures/circle.svg
-- test/fixtures/custom-backends/erb/html5/block_paragraph.html.erb
-- test/fixtures/custom-backends/haml/docbook45/block_paragraph.xml.haml
-- test/fixtures/custom-backends/haml/html5-tweaks/block_paragraph.html.haml
-- test/fixtures/custom-backends/haml/html5/block_paragraph.html.haml
-- test/fixtures/custom-backends/haml/html5/block_sidebar.html.haml
-- test/fixtures/custom-backends/slim/docbook45/block_paragraph.xml.slim
-- test/fixtures/custom-backends/slim/html5/block_paragraph.html.slim
-- test/fixtures/custom-backends/slim/html5/block_sidebar.html.slim
-- test/fixtures/custom-docinfodir/basic-docinfo.html
-- test/fixtures/custom-docinfodir/docinfo.html
-- test/fixtures/docinfo-footer.html
-- test/fixtures/docinfo-footer.xml
-- test/fixtures/docinfo.html
-- test/fixtures/docinfo.xml
-- test/fixtures/doctime-localtime.adoc
-- test/fixtures/dot.gif
-- test/fixtures/encoding.asciidoc
-- test/fixtures/file-with-missing-include.adoc
-- test/fixtures/grandchild-include.adoc
-- test/fixtures/hello-asciidoctor.pdf
-- test/fixtures/include-file.asciidoc
-- test/fixtures/include-file.jsx
-- test/fixtures/include-file.ml
-- test/fixtures/include-file.xml
-- test/fixtures/lists.adoc
-- test/fixtures/master.adoc
-- test/fixtures/mismatched-end-tag.adoc
-- test/fixtures/other-chapters.adoc
-- test/fixtures/outer-include.adoc
-- test/fixtures/parent-include-restricted.adoc
-- test/fixtures/parent-include.adoc
-- test/fixtures/sample.asciidoc
-- test/fixtures/section-a.adoc
-- test/fixtures/stylesheets/custom.css
-- test/fixtures/subdir/index.adoc
-- test/fixtures/subdir/inner-include.adoc
-- test/fixtures/subdir/middle-include.adoc
-- test/fixtures/subs-docinfo.html
-- test/fixtures/subs.adoc
-- test/fixtures/tagged-class-enclosed.rb
-- test/fixtures/tagged-class.rb
-- test/fixtures/tip.gif
-- test/fixtures/unclosed-tag.adoc
-- test/fixtures/unexpected-end-tag.adoc
-- test/invoker_test.rb
-- test/links_test.rb
-- test/lists_test.rb
-- test/logger_test.rb
-- test/manpage_test.rb
-- test/options_test.rb
-- test/paragraphs_test.rb
-- test/parser_test.rb
-- test/paths_test.rb
-- test/preamble_test.rb
-- test/reader_test.rb
-- test/sections_test.rb
-- test/substitutions_test.rb
-- test/tables_test.rb
-- test/test_helper.rb
-- test/text_test.rb
+test_files: []

data/CONTRIBUTING.adoc

@@ -1,185 +0,0 @@
-= Contributing
-// settings:
-:idprefix:
-:idseparator: -
-:source-language: ruby
-:language: {source-language}
-ifdef::env-github,env-browser[:outfilesuffix: .adoc]
-// URIs:
-:uri-repo: https://github.com/asciidoctor/asciidoctor
-:uri-help-base: https://help.github.com/articles
-:uri-issues: {uri-repo}/issues
-:uri-fork-help: {uri-help-base}/fork-a-repo
-:uri-branch-help: {uri-fork-help}#create-branches
-:uri-pr-help: {uri-help-base}/using-pull-requests
-:uri-gist: https://gist.github.com
-:uri-yard: https://yardoc.org
-:uri-tomdoc: http://tomdoc.org
-
-== License Agreement
-
-By contributing changes to this repository, you agree to license your contributions under the MIT license.
-This ensures your contributions have the same license as the project and that the community is free to use your contributions.
-You also assert that you are the original author of the work that you are contributing unless otherwise stated.
-
-== Submitting an Issue
-
-We use the {uri-issues}[issue tracker on GitHub] associated with this project to track bugs and features.
-Before submitting a bug report or feature request, check to make sure it hasn't already been submitted.
-When submitting a bug report, please include a {uri-gist}[Gist] that includes any details that may help reproduce the bug, including your gem version, Ruby version, and operating system.
-
-Most importantly, since Asciidoctor is a text processor, reproducing most bugs requires that we have some snippet of text on which Asciidoctor exhibits the bad behavior.
-
-An ideal bug report would include a pull request with failing specs.
-
-== Submitting a Pull Request
-
-. {uri-fork-help}[Fork the repository].
-. Run `NOKOGIRI_USE_SYSTEM_LIBRARIES=1 bundle` to install development dependencies.
-  - If the `bundle` command is not available, run `gem install bundler` to install it.
-. {uri-branch-help}[Create a topic branch] (preferably using the pattern `issue-XYZ`, where `XYZ` is the issue number).
-. Add tests for your unimplemented feature or bug fix. (See <<writing-and-executing-tests>>)
-. Run `bundle exec rake` to run the tests.
-If your tests pass, return to step 4.
-. Implement your feature or bug fix.
-. Run `bundle exec rake` to run the tests.
-If your tests fail, return to step 6.
-. Add documentation for your feature or bug fix.
-. If your changes are not 100% documented, go back to step 8.
-. Add, commit, and push your changes.
-. {uri-pr-help}[Submit a pull request].
-
-For ideas about how to use pull requests, see the post http://blog.quickpeople.co.uk/2013/07/10/useful-github-patterns[Useful GitHub Patterns].
-
-=== Background Knowledge
-
-As Asciidoctor is built using Ruby some basic knowledge of Ruby, RubyGems and Minitest is beneficial. The following resources provide a good starting point for contributors who may not be completely comfortable with these tools:
-
-* https://www.ruby-lang.org/en/documentation/quickstart/[Ruby in 20 minutes]
-* https://www.ruby-lang.org/en/documentation/ruby-from-other-languages/[Ruby from other languages]
-* http://guides.rubygems.org/rubygems-basics/[RubyGems basics]
-* http://guides.rubygems.org/what-is-a-gem/[What is a Gem?]
-* http://blog.teamtreehouse.com/short-introduction-minitest[How to use Minitest]
-* http://www.rubyinside.com/a-minitestspec-tutorial-elegant-spec-style-testing-that-comes-with-ruby-5354.html[Minitest spec tutorial]
-* https://github.com/seattlerb/minitest/blob/master/README.rdoc[Minitest Project Documentation]
-
-While these resources don't cover everything needed they serve as a good starting off point for beginners.
-
-=== Writing and Executing Tests
-
-Tests live inside the test directory and are named <topic>_test.rb.
-For instance, tests for the different types of blocks can be found in the file test/blocks_test.rb.
-
-Within a test file, individual test cases are organized inside of contexts.
-A context is type of logical container that groups related tests together.
-
-Each test case follows the same structure:
-
-[source]
-----
-test 'description of test' do
-  # test logic
-end
-----
-
-At the moment, the tests are quite primitive.
-Here's how a typical test operates:
-
-. Defines sample AsciiDoc source
-. Renders the document to HTML or DocBook
-. Uses XPath and CSS expressions to verify expected output
-
-Here's how we might test the open block syntax:
-
-[source]
-----
-test 'should render content bounded by two consecutive hyphens as an open block' do
-  input = <<-EOS
---
-This is an open block.
---
-  EOS
-  result = render_embedded_string input
-  assert_css '.openblock', result, 1
-  assert_css '.openblock p', result, 1
-  assert_xpath '/div[@class="openblock"]//p[text()="This is an open block."]', result, 1
-end
-----
-
-As you can see, several helpers are used to facilitate the test scenario.
-The `render_embedded_string` invokes Asciidoctor's render method with the header and footer option disabled.
-This method is ideal for unit-level tests.
-If you need to test the whole document, use `render_string` instead.
-The `assert_css` and `assert_xpath` assertion methods take a CSS or XPath selector, respectively, the rendered result and the number of expected matches.
-You can also use built-in assertions in Ruby's test library.
-
-To run all the tests, simply execute `rake`:
-
- $ rake
-
-NOTE: The tests should only take a few seconds to run using Ruby 2.1.
-
-If you want to run a single test file, you can use `ruby`:
-
- $ ruby test/blocks_test.rb
-
-To test a single test case, first add the string "wip" to the beginning of the description.
-For example:
-
-[source]
-----
-test 'wip should render ...' do
-  ...
-end
-----
-
-Then, run `ruby` again, but this time pass a selector argument so it finds matching tests:
-
- $ ruby test/blocks_test.rb -n /wip/
-
-You can also turn on verbose mode if you want to see more output:
-
- $ ruby test/blocks_test.rb -n /wip/ -v
-
-Once you are done with your test, make sure to remove `wip` from the description and run all the tests again using `rake`.
-
-We plan on switching to a more elegant testing framework in the future, such as RSpec or Cucumber, in order to make the tests more clear and robust.
-
-=== Running Asciidoctor in Development Mode
-
-Asciidoctor is designed so that you can run the script directly out of the cloned repository.
-Simply execute the `asciidoctor` command directly (referencing it either by relative or absolute path).
-There's no need to install it using the `gem` command first.
-
-For example, to convert the README file, switch to the root of the project and run:
-
- $ ./bin/asciidoctor README.adoc
-
-IMPORTANT: You'll need to make sure you reference the correct relative path to the `asciidoctor` command.
-
-If you want to be able to execute the `asciidoctor` command from any directory without worrying about the relative (or absolute) path, you can setup the following Bash alias:
-
- alias asciidoctor-dev="/path/to/asciidoctor/bin/asciidoctor"
-
-Now you can execute the `asciidoctor` command from any folder as follows:
-
- $ asciidoctor-dev README.adoc
-
-== Building the API Documentation
-
-The API documentation is written in the {uri-tomdoc}[TomDoc] dialect and built using {uri-yard}[Yard].
-
-The options for Yard are configured in the [.path]_.yardopts_ file at the root of the project.
-
-To build the API documentation locally, run the following command:
-
- $ bundle exec yard
-
-The documentation will be built into the [.path]_rdoc_ folder.
-
-== Supporting Additional Ruby Versions
-
-If you would like this library to support another Ruby version, you may volunteer to be a maintainer.
-Being a maintainer entails making sure all tests run and pass on that implementation.
-When something breaks on your implementation, you will be expected to provide patches in a timely fashion.
-If critical issues for a particular implementation exist at the time of a major release, support for that Ruby version may be dropped.