RubyGems - asciidoctor - Versions diffs - 1.5.8 → 2.0.17 - Mend

asciidoctor 1.5.8 → 2.0.17

Files changed (197) hide show

checksums.yaml +4 -4
data/.yardopts +11 -0
data/CHANGELOG.adoc +628 -45
data/LICENSE +2 -1
data/README-de.adoc +28 -38
data/README-fr.adoc +30 -43
data/README-jp.adoc +255 -201
data/README-zh_CN.adoc +40 -44
data/README.adoc +170 -143
data/asciidoctor.gemspec +22 -34
data/bin/asciidoctor +5 -4
data/data/locale/attributes-ar.adoc +4 -3
data/data/locale/attributes-be.adoc +23 -0
data/data/locale/attributes-bg.adoc +4 -3
data/data/locale/attributes-ca.adoc +6 -5
data/data/locale/attributes-cs.adoc +4 -3
data/data/locale/attributes-da.adoc +6 -5
data/data/locale/attributes-de.adoc +6 -5
data/data/locale/attributes-en.adoc +4 -4
data/data/locale/attributes-es.adoc +6 -5
data/data/locale/attributes-fa.adoc +4 -3
data/data/locale/attributes-fi.adoc +4 -3
data/data/locale/attributes-fr.adoc +8 -7
data/data/locale/attributes-hu.adoc +4 -3
data/data/locale/attributes-id.adoc +4 -3
data/data/locale/attributes-it.adoc +6 -5
data/data/locale/attributes-ja.adoc +4 -3
data/data/locale/{attributes-kr.adoc → attributes-ko.adoc} +4 -3
data/data/locale/attributes-nb.adoc +4 -3
data/data/locale/attributes-nl.adoc +6 -5
data/data/locale/attributes-nn.adoc +4 -3
data/data/locale/attributes-pl.adoc +8 -7
data/data/locale/attributes-pt.adoc +6 -5
data/data/locale/attributes-pt_BR.adoc +6 -5
data/data/locale/attributes-ro.adoc +4 -3
data/data/locale/attributes-ru.adoc +6 -5
data/data/locale/attributes-sr.adoc +4 -4
data/data/locale/attributes-sr_Latn.adoc +4 -4
data/data/locale/attributes-sv.adoc +4 -4
data/data/locale/attributes-th.adoc +23 -0
data/data/locale/attributes-tr.adoc +4 -3
data/data/locale/attributes-uk.adoc +6 -5
data/data/locale/attributes-vi.adoc +23 -0
data/data/locale/attributes-zh_CN.adoc +4 -3
data/data/locale/attributes-zh_TW.adoc +4 -3
data/data/reference/syntax.adoc +296 -0
data/data/stylesheets/asciidoctor-default.css +120 -114
data/data/stylesheets/coderay-asciidoctor.css +15 -17
data/lib/asciidoctor/abstract_block.rb +146 -140
data/lib/asciidoctor/abstract_node.rb +152 -170
data/lib/asciidoctor/attribute_list.rb +77 -89
data/lib/asciidoctor/block.rb +29 -28
data/lib/asciidoctor/callouts.rb +4 -2
data/lib/asciidoctor/cli/invoker.rb +20 -24
data/lib/asciidoctor/cli/options.rb +107 -96
data/lib/asciidoctor/cli.rb +3 -2
data/lib/asciidoctor/convert.rb +199 -0
data/lib/asciidoctor/converter/composite.rb +40 -48
data/lib/asciidoctor/converter/docbook5.rb +627 -644
data/lib/asciidoctor/converter/html5.rb +1053 -951
data/lib/asciidoctor/converter/manpage.rb +581 -532
data/lib/asciidoctor/converter/template.rb +232 -271
data/lib/asciidoctor/converter.rb +370 -185
data/lib/asciidoctor/core_ext/float/truncate.rb +20 -0
data/lib/asciidoctor/core_ext/hash/merge.rb +8 -0
data/lib/asciidoctor/core_ext/match_data/names.rb +7 -0
data/lib/asciidoctor/core_ext/nil_or_empty.rb +1 -0
data/lib/asciidoctor/core_ext/regexp/is_match.rb +4 -2
data/lib/asciidoctor/core_ext.rb +8 -17
data/lib/asciidoctor/document.rb +503 -461
data/lib/asciidoctor/extensions.rb +127 -174
data/lib/asciidoctor/helpers.rb +184 -107
data/lib/asciidoctor/inline.rb +9 -12
data/lib/asciidoctor/list.rb +11 -29
data/lib/asciidoctor/load.rb +119 -0
data/lib/asciidoctor/logging.rb +22 -17
data/lib/asciidoctor/parser.rb +673 -719
data/lib/asciidoctor/path_resolver.rb +48 -33
data/lib/asciidoctor/reader.rb +383 -338
data/lib/asciidoctor/rouge_ext.rb +39 -0
data/lib/asciidoctor/rx.rb +723 -0
data/lib/asciidoctor/section.rb +17 -16
data/lib/asciidoctor/stylesheets.rb +19 -37
data/lib/asciidoctor/substitutors.rb +926 -1022
data/lib/asciidoctor/syntax_highlighter/coderay.rb +88 -0
data/lib/asciidoctor/syntax_highlighter/highlightjs.rb +34 -0
data/lib/asciidoctor/syntax_highlighter/html_pipeline.rb +10 -0
data/lib/asciidoctor/syntax_highlighter/prettify.rb +30 -0
data/lib/asciidoctor/syntax_highlighter/pygments.rb +157 -0
data/lib/asciidoctor/syntax_highlighter/rouge.rb +143 -0
data/lib/asciidoctor/syntax_highlighter.rb +253 -0
data/lib/asciidoctor/table.rb +152 -114
data/lib/asciidoctor/timings.rb +7 -5
data/lib/asciidoctor/version.rb +2 -1
data/lib/asciidoctor/writer.rb +30 -0
data/lib/asciidoctor.rb +266 -1340
data/man/asciidoctor.1 +49 -47
data/man/asciidoctor.adoc +54 -45
metadata +50 -245
data/CONTRIBUTING.adoc +0 -185
data/Gemfile +0 -60
data/Rakefile +0 -129
data/bin/asciidoctor-safe +0 -15
data/features/open_block.feature +0 -92
data/features/pass_block.feature +0 -66
data/features/step_definitions.rb +0 -49
data/features/text_formatting.feature +0 -57
data/features/xref.feature +0 -1039
data/lib/asciidoctor/converter/base.rb +0 -59
data/lib/asciidoctor/converter/docbook45.rb +0 -93
data/lib/asciidoctor/converter/factory.rb +0 -226
data/lib/asciidoctor/core_ext/1.8.7/base64/strict_encode64.rb +0 -6
data/lib/asciidoctor/core_ext/1.8.7/concurrent/hash.rb +0 -5
data/lib/asciidoctor/core_ext/1.8.7/hash/key.rb +0 -4
data/lib/asciidoctor/core_ext/1.8.7/io/binread.rb +0 -6
data/lib/asciidoctor/core_ext/1.8.7/io/write.rb +0 -5
data/lib/asciidoctor/core_ext/1.8.7/string/chr.rb +0 -6
data/lib/asciidoctor/core_ext/1.8.7/string/limit_bytesize.rb +0 -29
data/lib/asciidoctor/core_ext/1.8.7/symbol/empty.rb +0 -6
data/lib/asciidoctor/core_ext/1.8.7/symbol/length.rb +0 -6
data/lib/asciidoctor/core_ext/string/limit_bytesize.rb +0 -10
data/test/api_test.rb +0 -1240
data/test/attribute_list_test.rb +0 -242
data/test/attributes_test.rb +0 -1623
data/test/blocks_test.rb +0 -3870
data/test/converter_test.rb +0 -470
data/test/document_test.rb +0 -1853
data/test/extensions_test.rb +0 -1560
data/test/fixtures/asciidoc_index.txt +0 -521
data/test/fixtures/basic-docinfo-footer.html +0 -6
data/test/fixtures/basic-docinfo-footer.xml +0 -8
data/test/fixtures/basic-docinfo.html +0 -1
data/test/fixtures/basic-docinfo.xml +0 -4
data/test/fixtures/basic.asciidoc +0 -5
data/test/fixtures/chapter-a.adoc +0 -3
data/test/fixtures/child-include.adoc +0 -5
data/test/fixtures/circle.svg +0 -9
data/test/fixtures/custom-backends/erb/html5/block_paragraph.html.erb +0 -6
data/test/fixtures/custom-backends/haml/docbook45/block_paragraph.xml.haml +0 -6
data/test/fixtures/custom-backends/haml/html5/block_paragraph.html.haml +0 -3
data/test/fixtures/custom-backends/haml/html5/block_sidebar.html.haml +0 -5
data/test/fixtures/custom-backends/haml/html5-tweaks/block_paragraph.html.haml +0 -1
data/test/fixtures/custom-backends/slim/docbook45/block_paragraph.xml.slim +0 -6
data/test/fixtures/custom-backends/slim/html5/block_paragraph.html.slim +0 -3
data/test/fixtures/custom-backends/slim/html5/block_sidebar.html.slim +0 -5
data/test/fixtures/custom-docinfodir/basic-docinfo.html +0 -1
data/test/fixtures/custom-docinfodir/docinfo.html +0 -1
data/test/fixtures/docinfo-footer.html +0 -1
data/test/fixtures/docinfo-footer.xml +0 -9
data/test/fixtures/docinfo.html +0 -1
data/test/fixtures/docinfo.xml +0 -3
data/test/fixtures/doctime-localtime.adoc +0 -2
data/test/fixtures/dot.gif +0 -0
data/test/fixtures/encoding.asciidoc +0 -13
data/test/fixtures/file-with-missing-include.adoc +0 -1
data/test/fixtures/grandchild-include.adoc +0 -3
data/test/fixtures/hello-asciidoctor.pdf +0 -69
data/test/fixtures/include-file.asciidoc +0 -24
data/test/fixtures/include-file.jsx +0 -8
data/test/fixtures/include-file.ml +0 -3
data/test/fixtures/include-file.xml +0 -5
data/test/fixtures/lists.adoc +0 -96
data/test/fixtures/master.adoc +0 -5
data/test/fixtures/mismatched-end-tag.adoc +0 -7
data/test/fixtures/other-chapters.adoc +0 -11
data/test/fixtures/outer-include.adoc +0 -5
data/test/fixtures/parent-include-restricted.adoc +0 -5
data/test/fixtures/parent-include.adoc +0 -5
data/test/fixtures/sample.asciidoc +0 -30
data/test/fixtures/section-a.adoc +0 -4
data/test/fixtures/stylesheets/custom.css +0 -3
data/test/fixtures/subdir/index.adoc +0 -3
data/test/fixtures/subdir/inner-include.adoc +0 -3
data/test/fixtures/subdir/middle-include.adoc +0 -5
data/test/fixtures/subs-docinfo.html +0 -2
data/test/fixtures/subs.adoc +0 -6
data/test/fixtures/tagged-class-enclosed.rb +0 -25
data/test/fixtures/tagged-class.rb +0 -23
data/test/fixtures/tip.gif +0 -0
data/test/fixtures/unclosed-tag.adoc +0 -3
data/test/fixtures/unexpected-end-tag.adoc +0 -4
data/test/invoker_test.rb +0 -745
data/test/links_test.rb +0 -855
data/test/lists_test.rb +0 -5151
data/test/logger_test.rb +0 -211
data/test/manpage_test.rb +0 -660
data/test/options_test.rb +0 -262
data/test/paragraphs_test.rb +0 -562
data/test/parser_test.rb +0 -742
data/test/paths_test.rb +0 -395
data/test/preamble_test.rb +0 -173
data/test/reader_test.rb +0 -2161
data/test/sections_test.rb +0 -3575
data/test/substitutions_test.rb +0 -2066
data/test/tables_test.rb +0 -2036
data/test/test_helper.rb +0 -447
data/test/text_test.rb +0 -309

data/features/xref.feature DELETED Viewed

@@ -1,1039 +0,0 @@
-# language: en
-Feature: Cross References
-  In order to create cross references between sections and blocks in the current or neighboring document
-  As a writer
-  I want to be able to use the cross reference macro to compose these references
-  Scenario: Create a cross reference to a block that has explicit reftext
-  Given the AsciiDoc source
-    """
-    :xrefstyle: full
-    See <<param-type-t>> to learn how it works.
-    .Parameterized Type <T>
-    [[param-type-t,that "<T>" thing]]
-    ****
-    This sidebar describes what that <T> thing is all about.
-    ****
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#param-type-t' that "&lt;T&gt;" thing
-    |to learn how it works.
-    """
-  When it is converted to docbook
-  Then the result should match the XML structure
-    """
-    simpara
-      |See
-      xref<> linkend='param-type-t'/
-      |to learn how it works.
-    sidebar xml:id='param-type-t' xreflabel='that &quot;&lt;T&gt;&quot; thing'
-      title Parameterized Type &lt;T&gt;
-      simpara This sidebar describes what that &lt;T&gt; thing is all about.
-    """
-  Scenario: Create a cross reference to a block that has explicit reftext with formatting
-  Given the AsciiDoc source
-    """
-    :xrefstyle: full
-    There are cats, then there are the <<big-cats>>.
-    [[big-cats,*big* cats]]
-    == Big Cats
-    So ferocious.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |There are cats, then there are the
-    a< href='#big-cats' <strong>big</strong> cats
-    |.
-    """
-  When it is converted to docbook
-  Then the result should match the XML structure
-    """
-    simpara
-      |There are cats, then there are the
-      xref< linkend='big-cats'/
-      |.
-    section xml:id='big-cats' xreflabel='big cats'
-      title Big Cats
-      simpara So ferocious.
-    """
-  Scenario: Create a full cross reference to a numbered section
-  Given the AsciiDoc source
-    """
-    :sectnums:
-    :xrefstyle: full
-    See <<sect-features>> to find a complete list of features.
-    == About
-    [#sect-features]
-    === Features
-    All the features are listed in this section.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#sect-features' Section 1.1, &#8220;Features&#8221;
-    |to find a complete list of features.
-    """
-  Scenario: Create a short cross reference to a numbered section
-  Given the AsciiDoc source
-    """
-    :sectnums:
-    :xrefstyle: short
-    See <<sect-features>> to find a complete list of features.
-    [#sect-features]
-    == Features
-    All the features are listed in this section.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#sect-features' Section 1
-    |to find a complete list of features.
-    """
-  Scenario: Create a basic cross reference to an unnumbered section
-  Given the AsciiDoc source
-    """
-    :xrefstyle: full
-    See <<sect-features>> to find a complete list of features.
-    [#sect-features]
-    == Features
-    All the features are listed in this section.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#sect-features' Features
-    |to find a complete list of features.
-    """
-  Scenario: Create a basic cross reference to a numbered section when the section reference signifier is disabled
-  Given the AsciiDoc source
-    """
-    :sectnums:
-    :xrefstyle: full
-    :!section-refsig:
-    See <<sect-features>> to find a complete list of features.
-    [#sect-features]
-    == Features
-    All the features are listed in this section.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#sect-features' 1, &#8220;Features&#8221;
-    |to find a complete list of features.
-    """
-  Scenario: Create a full cross reference to a numbered chapter
-  Given the AsciiDoc source
-    """
-    :doctype: book
-    :sectnums:
-    :xrefstyle: full
-    See <<chap-features>> to find a complete list of features.
-    [#chap-features]
-    == Features
-    All the features are listed in this chapter.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#chap-features' Chapter 1, <em>Features</em>
-    |to find a complete list of features.
-    """
-  Scenario: Create a short cross reference to a numbered chapter
-  Given the AsciiDoc source
-    """
-    :doctype: book
-    :sectnums:
-    :xrefstyle: short
-    See <<chap-features>> to find a complete list of features.
-    [#chap-features]
-    == Features
-    All the features are listed in this chapter.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#chap-features' Chapter 1
-    |to find a complete list of features.
-    """
-  Scenario: Create a basic cross reference to a numbered chapter
-  Given the AsciiDoc source
-    """
-    :doctype: book
-    :sectnums:
-    :xrefstyle: basic
-    See <<chap-features>> to find a complete list of features.
-    [#chap-features]
-    == Features
-    All the features are listed in this chapter.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#chap-features' <em>Features</em>
-    |to find a complete list of features.
-    """
-  Scenario: Create a basic cross reference to an unnumbered chapter
-  Given the AsciiDoc source
-    """
-    :doctype: book
-    :xrefstyle: full
-    See <<chap-features>> to find a complete list of features.
-    [#chap-features]
-    == Features
-    All the features are listed in this chapter.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#chap-features' <em>Features</em>
-    |to find a complete list of features.
-    """
-  Scenario: Create a cross reference to a chapter using a custom chapter reference signifier
-  Given the AsciiDoc source
-    """
-    :doctype: book
-    :sectnums:
-    :xrefstyle: full
-    :chapter-refsig: Ch
-    See <<chap-features>> to find a complete list of features.
-    [#chap-features]
-    == Features
-    All the features are listed in this chapter.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#chap-features' Ch 1, <em>Features</em>
-    |to find a complete list of features.
-    """
-  Scenario: Create a full cross reference to a numbered part
-  Given the AsciiDoc source
-    """
-    :doctype: book
-    :sectnums:
-    :partnums:
-    :xrefstyle: full
-    [preface]
-    = Preface
-    See <<p1>> for an introduction to the language.
-    [#p1]
-    = Language
-    == Syntax
-    This chapter covers the syntax.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#p1' Part I, &#8220;Language&#8221;
-    |for an introduction to the language.
-    """
-  Scenario: Create a short cross reference to a numbered part
-  Given the AsciiDoc source
-    """
-    :doctype: book
-    :sectnums:
-    :partnums:
-    :xrefstyle: short
-    [preface]
-    = Preface
-    See <<p1>> for an introduction to the language.
-    [#p1]
-    = Language
-    == Syntax
-    This chapter covers the syntax.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#p1' Part I
-    |for an introduction to the language.
-    """
-  Scenario: Create a basic cross reference to a numbered part
-  Given the AsciiDoc source
-    """
-    :doctype: book
-    :sectnums:
-    :partnums:
-    :xrefstyle: basic
-    [preface]
-    = Preface
-    See <<p1>> for an introduction to the language.
-    [#p1]
-    = Language
-    == Syntax
-    This chapter covers the syntax.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#p1' Language
-    |for an introduction to the language.
-    """
-  Scenario: Create a basic cross reference to an unnumbered part
-  Given the AsciiDoc source
-    """
-    :doctype: book
-    :sectnums:
-    :xrefstyle: full
-    [preface]
-    = Preface
-    See <<p1>> for an introduction to the language.
-    [#p1]
-    = Language
-    == Syntax
-    This chapter covers the syntax.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#p1' Language
-    |for an introduction to the language.
-    """
-  @wip
-  Scenario: Create a cross reference to a part using a custom part reference signifier
-  Given the AsciiDoc source
-    """
-    :doctype: book
-    :sectnums:
-    :partnums:
-    :xrefstyle: full
-    :part-refsig: P
-    [preface]
-    = Preface
-    See <<p1>> for an introduction to the language.
-    [#p1]
-    = Language
-    == Syntax
-    This chapter covers the syntax.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#p1' P I, &#8220;Language&#8221;
-    |for an introduction to the language.
-    """
-  Scenario: Create a full cross reference to a numbered appendix
-  Given the AsciiDoc source
-    """
-    :sectnums:
-    :xrefstyle: full
-    See <<app-features>> to find a complete list of features.
-    [appendix#app-features]
-    == Features
-    All the features are listed in this appendix.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#app-features' Appendix A, <em>Features</em>
-    |to find a complete list of features.
-    """
-  Scenario: Create a short cross reference to a numbered appendix
-  Given the AsciiDoc source
-    """
-    :sectnums:
-    :xrefstyle: short
-    See <<app-features>> to find a complete list of features.
-    [appendix#app-features]
-    == Features
-    All the features are listed in this appendix.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#app-features' Appendix A
-    |to find a complete list of features.
-    """
-  Scenario: Create a full cross reference to an appendix even when section numbering is disabled
-  Given the AsciiDoc source
-    """
-    :xrefstyle: full
-    See <<app-features>> to find a complete list of features.
-    [appendix#app-features]
-    == Features
-    All the features are listed in this appendix.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#app-features' Appendix A, <em>Features</em>
-    |to find a complete list of features.
-    """
-  Scenario: Create a full cross reference to a numbered formal block
-  Given the AsciiDoc source
-    """
-    :xrefstyle: full
-    See <<tbl-features>> to find a table of features.
-    .Features
-    [#tbl-features%autowidth]
-    |===
-    |Text formatting |Formats text for display.
-    |===
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#tbl-features' Table 1, &#8220;Features&#8221;
-    |to find a table of features.
-    """
-  Scenario: Create a short cross reference to a numbered formal block
-  Given the AsciiDoc source
-    """
-    :xrefstyle: short
-    See <<tbl-features>> to find a table of features.
-    .Features
-    [#tbl-features%autowidth]
-    |===
-    |Text formatting |Formats text for display.
-    |===
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#tbl-features' Table 1
-    |to find a table of features.
-    """
-  Scenario: Create a basic cross reference to a numbered formal block when the caption prefix is disabled
-  Given the AsciiDoc source
-    """
-    :xrefstyle: full
-    :!table-caption:
-    See <<tbl-features>> to find a table of features.
-    .Features
-    [#tbl-features%autowidth]
-    |===
-    |Text formatting |Formats text for display.
-    |===
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#tbl-features' Features
-    |to find a table of features.
-    """
-  Scenario: Create a cross reference to a numbered formal block with a custom caption prefix
-  Given the AsciiDoc source
-    """
-    :xrefstyle: full
-    :table-caption: Tbl
-    See <<tbl-features>> to find a table of features.
-    .Features
-    [#tbl-features%autowidth]
-    |===
-    |Text formatting |Formats text for display.
-    |===
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#tbl-features' Tbl 1, &#8220;Features&#8221;
-    |to find a table of features.
-    """
-  Scenario: Create a full cross reference to a formal image block
-  Given the AsciiDoc source
-    """
-    :xrefstyle: full
-    Behold, <<tiger>>!
-    .The ferocious Ghostscript tiger
-    [#tiger]
-    image::tiger.svg[Ghostscript tiger]
-    """
-  When it is converted to html
-  Then the result should match the HTML structure
-    """
-    .paragraph: p
-      |Behold,
-      a< href='#tiger' Figure 1, &#8220;The ferocious Ghostscript tiger&#8221;
-      |!
-    #tiger.imageblock
-      .content: img src='tiger.svg' alt='Ghostscript tiger'
-      .title Figure 1. The ferocious Ghostscript tiger
-    """
-  Scenario: Create a short cross reference to a formal image block
-  Given the AsciiDoc source
-    """
-    :xrefstyle: short
-    Behold, <<tiger>>!
-    .The ferocious Ghostscript tiger
-    [#tiger]
-    image::tiger.svg[Ghostscript tiger]
-    """
-  When it is converted to html
-  Then the result should match the HTML structure
-    """
-    .paragraph: p
-      |Behold,
-      a< href='#tiger' Figure 1
-      |!
-    #tiger.imageblock
-      .content: img src='tiger.svg' alt='Ghostscript tiger'
-      .title Figure 1. The ferocious Ghostscript tiger
-    """
-  Scenario: Create a full cross reference to a block with an explicit caption
-  Given the AsciiDoc source
-    """
-    :xrefstyle: full
-    See <<diagram-1>> and <<diagram-2>>.
-    .Managing Orders
-    [#diagram-1,caption="Diagram {counter:diag-number}. "]
-    image::managing-orders.png[Managing Orders]
-    .Managing Inventory
-    [#diagram-2,caption="Diagram {counter:diag-number}. "]
-    image::managing-inventory.png[Managing Inventory]
-    """
-  When it is converted to html
-  Then the result should match the HTML structure
-    """
-    .paragraph: p
-      |See
-      a<> href='#diagram-1' Diagram 1, &#8220;Managing Orders&#8221;
-      |and
-      a< href='#diagram-2' Diagram 2, &#8220;Managing Inventory&#8221;
-      |.
-    #diagram-1.imageblock
-      .content: img src='managing-orders.png' alt='Managing Orders'
-      .title Diagram 1. Managing Orders
-    #diagram-2.imageblock
-      .content: img src='managing-inventory.png' alt='Managing Inventory'
-      .title Diagram 2. Managing Inventory
-    """
-  Scenario: Create a short cross reference to a block with an explicit caption
-  Given the AsciiDoc source
-    """
-    :xrefstyle: short
-    See <<diagram-1>> and <<diagram-2>>.
-    .Managing Orders
-    [#diagram-1,caption="Diagram {counter:diag-number}. "]
-    image::managing-orders.png[Managing Orders]
-    .Managing Inventory
-    [#diagram-2,caption="Diagram {counter:diag-number}. "]
-    image::managing-inventory.png[Managing Inventory]
-    """
-  When it is converted to html
-  Then the result should match the HTML structure
-    """
-    .paragraph: p
-      |See
-      a<> href='#diagram-1' Diagram 1
-      |and
-      a< href='#diagram-2' Diagram 2
-      |.
-    #diagram-1.imageblock
-      .content: img src='managing-orders.png' alt='Managing Orders'
-      .title Diagram 1. Managing Orders
-    #diagram-2.imageblock
-      .content: img src='managing-inventory.png' alt='Managing Inventory'
-      .title Diagram 2. Managing Inventory
-    """
-  Scenario: Create a basic cross reference to an unnumbered formal block
-  Given the AsciiDoc source
-    """
-    :xrefstyle: full
-    See <<data>> to find the data used in this report.
-    .Data
-    [#data]
-    ....
-    a
-    b
-    c
-    ....
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |See
-    a<> href='#data' Data
-    |to find the data used in this report.
-    """
-  Scenario: Use title as cross reference text to refer to a formal admonition block
-  Given the AsciiDoc source
-    """
-    :xrefstyle: full
-    Recall in <<essential-tip-1>>, we told you how to speed up this process.
-    .Essential tip #1
-    [#essential-tip-1]
-    TIP: You can speed up this process by pressing the turbo button.
-    """
-  When it is converted to html
-  Then the result should contain the HTML structure
-    """
-    |Recall in
-    a< href='#essential-tip-1' Essential tip #1
-    |, we told you how to speed up this process.
-    """
-  Scenario: Create a cross reference from an AsciiDoc cell to a section
-  Given the AsciiDoc source
-    """
-    |===
-    a|See <<_install>>
-    |===
-    == Install
-    Instructions go here.
-    """
-  When it is converted to html
-  Then the result should match the HTML structure
-    """
-    table.tableblock.frame-all.grid-all.stretch
-      colgroup
-        col style='width: 100%;'
-      tbody
-        tr
-          td.tableblock.halign-left.valign-top
-            div.content
-              .paragraph: p
-                |See
-                a< href='#_install' Install
-    .sect1
-      h2#_install Install
-      .sectionbody
-        .paragraph: p Instructions go here.
-    """
-    Scenario: Create a cross reference using the title of the target section
-    Given the AsciiDoc source
-      """
-      == Section One
-      content
-      == Section Two
-      refer to <<Section One>>
-      """
-    When it is converted to html
-    Then the result should match the HTML structure
-      """
-      .sect1
-        h2#_section_one Section One
-        .sectionbody: .paragraph: p content
-      .sect1
-        h2#_section_two Section Two
-        .sectionbody: .paragraph: p
-          |refer to
-          a< href='#_section_one' Section One
-      """
-    Scenario: Create a cross reference using the reftext of the target section
-    Given the AsciiDoc source
-      """
-      [reftext="the first section"]
-      == Section One
-      content
-      == Section Two
-      refer to <<the first section>>
-      """
-    When it is converted to html
-    Then the result should match the HTML structure
-      """
-      .sect1
-        h2#_section_one Section One
-        .sectionbody: .paragraph: p content
-      .sect1
-        h2#_section_two Section Two
-        .sectionbody: .paragraph: p
-          |refer to
-          a< href='#_section_one' the first section
-      """
-    When it is converted to docbook
-    Then the result should match the XML structure
-      """
-      section xml:id='_section_one' xreflabel='the first section'
-        title Section One
-        simpara content
-      section xml:id='_section_two'
-        title Section Two
-        simpara
-          |refer to
-          xref< linkend='_section_one'/
-      """
-    Scenario: Create a cross reference using the formatted title of the target section
-    Given the AsciiDoc source
-      """
-      == Section *One*
-      content
-      == Section Two
-      refer to <<Section *One*>>
-      """
-    When it is converted to html
-    Then the result should match the HTML structure
-      """
-      .sect1
-        h2#_section_one
-          |Section <strong>One</strong>
-        .sectionbody: .paragraph: p content
-      .sect1
-        h2#_section_two Section Two
-        .sectionbody: .paragraph: p
-          |refer to
-          a< href='#_section_one' Section <strong>One</strong>
-      """
-    Scenario: Does not process a natural cross reference in compat mode
-    Given the AsciiDoc source
-      """
-      :compat-mode:
-      == Section One
-      content
-      == Section Two
-      refer to <<Section One>>
-      """
-    When it is converted to html
-    Then the result should match the HTML structure
-      """
-      .sect1
-        h2#_section_one
-          |Section One
-        .sectionbody: .paragraph: p content
-      .sect1
-        h2#_section_two Section Two
-        .sectionbody: .paragraph: p
-          |refer to
-          a< href='#Section One' [Section One]
-      """
-    Scenario: Parses text of xref macro as attributes if attribute signature found
-    Given the AsciiDoc source
-      """
-      == Section One
-      content
-      == Section Two
-      refer to xref:_section_one[role=next]
-      """
-    When it is converted to html
-    Then the result should match the HTML structure
-      """
-      .sect1
-        h2#_section_one
-          |Section One
-        .sectionbody: .paragraph: p content
-      .sect1
-        h2#_section_two Section Two
-        .sectionbody: .paragraph: p
-          |refer to
-          a< href='#_section_one' class='next' Section One
-      """
-    Scenario: Does not parse text of xref macro as attribute if attribute signature not found
-    Given the AsciiDoc source
-      """
-      == Section One
-      content
-      == Section Two
-      refer to xref:_section_one[One, Section One]
-      """
-    When it is converted to html
-    Then the result should match the HTML structure
-      """
-      .sect1
-        h2#_section_one
-          |Section One
-        .sectionbody: .paragraph: p content
-      .sect1
-        h2#_section_two Section Two
-        .sectionbody: .paragraph: p
-          |refer to
-          a< href='#_section_one' One, Section One
-      """
-    Scenario: Uses whole text of xref macro as link text if attribute signature found and text is enclosed in double quotes
-    Given the AsciiDoc source
-      """
-      == Section One
-      content
-      == Section Two
-      refer to xref:_section_one["Section One == Starting Point"]
-      """
-    When it is converted to html
-    Then the result should match the HTML structure
-      """
-      .sect1
-        h2#_section_one
-          |Section One
-        .sectionbody: .paragraph: p content
-      .sect1
-        h2#_section_two Section Two
-        .sectionbody: .paragraph: p
-          |refer to
-          a< href='#_section_one'
-            |Section One == Starting Point
-      """
-    Scenario: Does not parse text of xref macro as text if enclosed in double quotes but attribute signature not found
-    Given the AsciiDoc source
-      """
-      == Section One
-      content
-      == Section Two
-      refer to xref:_section_one["The Premier Section"]
-      """
-    When it is converted to html
-    Then the result should match the HTML structure
-      """
-      .sect1
-        h2#_section_one
-          |Section One
-        .sectionbody: .paragraph: p content
-      .sect1
-        h2#_section_two Section Two
-        .sectionbody: .paragraph: p
-          |refer to
-          a< href='#_section_one' "The Premier Section"
-      """
-    Scenario: Can escape double quotes in text of xref macro using backslashes when text is parsed as attributes
-    Given the AsciiDoc source
-      """
-      == Section One
-      content
-      == Section Two
-      refer to xref:_section_one["\"The Premier Section\"",role=spotlight]
-      """
-    When it is converted to html
-    Then the result should match the HTML structure
-      """
-      .sect1
-        h2#_section_one
-          |Section One
-        .sectionbody: .paragraph: p content
-      .sect1
-        h2#_section_two Section Two
-        .sectionbody: .paragraph: p
-          |refer to
-          a< href='#_section_one' class='spotlight' "The Premier Section"
-      """
-    Scenario: Override xrefstyle for a given part of the document
-    Given the AsciiDoc source
-      """
-      :xrefstyle: full
-      :doctype: book
-      :sectnums:
-      == Foo
-      refer to <<#_bar>>
-      == Bar
-      :xrefstyle: short
-      refer to xref:#_foo[xrefstyle=short]
-      """
-    When it is converted to html
-    Then the result should match the HTML structure
-      """
-      .sect1
-        h2#_foo 1. Foo
-        .sectionbody: .paragraph: p
-          |refer to
-          a< href='#_bar' Chapter 2, <em>Bar</em>
-      .sect1
-        h2#_bar 2. Bar
-        .sectionbody: .paragraph: p
-          |refer to
-          a< href='#_foo' Chapter 1
-      """
-    Scenario: Override xrefstyle for a specific reference by assigning the xrefstyle attribute on the xref macro
-    Given the AsciiDoc source
-      """
-      :xrefstyle: full
-      :doctype: book
-      :sectnums:
-      == Foo
-      content
-      == Bar
-      refer to <<#_foo>>
-      refer to xref:#_foo[xrefstyle=short]
-      """
-    When it is converted to html
-    Then the result should match the HTML structure
-      """
-      .sect1
-        h2#_foo 1. Foo
-        .sectionbody: .paragraph: p content
-      .sect1
-        h2#_bar 2. Bar
-        .sectionbody
-          .paragraph: p
-            |refer to
-            a< href='#_foo' Chapter 1, <em>Foo</em>
-          .paragraph: p
-            |refer to
-            a< href='#_foo' Chapter 1
-      """