# encoding: UTF-8 unless defined? ASCIIDOCTOR_PROJECT_DIR $: << File.dirname(__FILE__); $:.uniq! require 'test_helper' end context 'Links' do test 'qualified url inline with text' do assert_xpath "//a[@href='http://asciidoc.org'][@class='bare'][text() = 'http://asciidoc.org']", render_string("The AsciiDoc project is located at http://asciidoc.org.") end test 'qualified url with role inline with text' do assert_xpath "//a[@href='http://asciidoc.org'][@class='bare project'][text() = 'http://asciidoc.org']", render_string("The AsciiDoc project is located at http://asciidoc.org[role=project].") end test 'qualified http url inline with hide-uri-scheme set' do assert_xpath "//a[@href='http://asciidoc.org'][@class='bare'][text() = 'asciidoc.org']", render_string("The AsciiDoc project is located at http://asciidoc.org.", :attributes => {'hide-uri-scheme' => ''}) end test 'qualified file url inline with label' do assert_xpath "//a[@href='file:///home/user/bookmarks.html'][text() = 'My Bookmarks']", render_embedded_string('file:///home/user/bookmarks.html[My Bookmarks]') end test 'qualified file url inline with hide-uri-scheme set' do assert_xpath "//a[@href='file:///etc/app.conf'][text() = '/etc/app.conf']", render_string('Edit the configuration file link:file:///etc/app.conf[]', :attributes => {'hide-uri-scheme' => ''}) end test 'qualified url with label' do assert_xpath "//a[@href='http://asciidoc.org'][text() = 'AsciiDoc']", render_string("We're parsing http://asciidoc.org[AsciiDoc] markup") end test 'qualified url with label containing escaped right square bracket' do assert_xpath "//a[@href='http://asciidoc.org'][text() = '[Ascii]Doc']", render_string("We're parsing http://asciidoc.org[[Ascii\\]Doc] markup") end test 'qualified url with backslash label' do assert_xpath "//a[@href='https://google.com'][text() = 'Google for \\']", render_string("I advise you to https://google.com[Google for +\\+]") end test 'qualified url with label using link macro' do assert_xpath "//a[@href='http://asciidoc.org'][text() = 'AsciiDoc']", render_string("We're parsing link:http://asciidoc.org[AsciiDoc] markup") end test 'qualified url with role using link macro' do assert_xpath "//a[@href='http://asciidoc.org'][@class='bare project'][text() = 'http://asciidoc.org']", render_string("We're parsing link:http://asciidoc.org[role=project] markup") end test 'qualified url using macro syntax with multi-line label inline with text' do assert_xpath %{//a[@href='http://asciidoc.org'][text() = 'AsciiDoc\nmarkup']}, render_string("We're parsing link:http://asciidoc.org[AsciiDoc\nmarkup]") end test 'qualified url with label containing square brackets using link macro' do str = 'http://example.com[[bracket1\]]' doc = document_from_string str, :header_footer => false, :doctype => 'inline' assert_match '[bracket1]', doc.convert, 1 doc = document_from_string str, :header_footer => false, :backend => 'docbook', :doctype => 'inline' assert_match '[bracket1]', doc.convert, 1 doc = document_from_string str, :header_footer => false, :backend => 'docbook45', :doctype => 'inline' assert_match '[bracket1]', doc.convert, 1 end test 'link macro with empty target' do input = 'Link to link:[this page].' output = render_embedded_string input assert_xpath '//a', output, 1 assert_xpath '//a[@href=""]', output, 1 end test 'should not recognize link macro with double colons' do input = 'The link::http://example.org[example domain] is reserved for tests and documentation.' output = render_embedded_string input assert_includes output, 'link::http://example.org[example domain]' end test 'qualified url surrounded by angled brackets' do assert_xpath '//a[@href="http://asciidoc.org"][text()="http://asciidoc.org"]', render_string(' is the project page for AsciiDoc.'), 1 end test 'qualified url surrounded by round brackets' do assert_xpath '//a[@href="http://asciidoc.org"][text()="http://asciidoc.org"]', render_string('(http://asciidoc.org) is the project page for AsciiDoc.'), 1 end test 'qualified url with trailing round bracket' do assert_xpath '//a[@href="https://asciidoctor.org"][text()="https://asciidoctor.org"]', render_string('Asciidoctor is a Ruby-based AsciiDoc processor (see https://asciidoctor.org)'), 1 end test 'qualified url with trailing semi-colon' do assert_xpath '//a[@href="https://asciidoctor.org"][text()="https://asciidoctor.org"]', render_string('https://asciidoctor.org; where text gets parsed'), 1 end test 'qualified url with trailing colon' do assert_xpath '//a[@href="https://asciidoctor.org"][text()="https://asciidoctor.org"]', render_string('https://asciidoctor.org: where text gets parsed'), 1 end test 'qualified url in round brackets with trailing colon' do assert_xpath '//a[@href="https://asciidoctor.org"][text()="https://asciidoctor.org"]', render_string('(https://asciidoctor.org): where text gets parsed'), 1 end test 'qualified url with trailing round bracket followed by colon' do result = render_embedded_string '(from https://asciidoctor.org): where text gets parsed' assert_xpath '//a[@href="https://asciidoctor.org"][text()="https://asciidoctor.org"]', result, 1 assert_xpath '//a[@href="https://asciidoctor.org"][text()="https://asciidoctor.org"]/preceding-sibling::text()[.="(from "]', result, 1 assert_xpath '//a[@href="https://asciidoctor.org"][text()="https://asciidoctor.org"]/following-sibling::text()[.="): where text gets parsed"]', result, 1 end test 'qualified url in round brackets with trailing semi-colon' do assert_xpath '//a[@href="https://asciidoctor.org"][text()="https://asciidoctor.org"]', render_string('(https://asciidoctor.org); where text gets parsed'), 1 end test 'qualified url with trailing round bracket followed by semi-colon' do result = render_embedded_string '(from https://asciidoctor.org); where text gets parsed' assert_xpath '//a[@href="https://asciidoctor.org"][text()="https://asciidoctor.org"]', result, 1 assert_xpath '//a[@href="https://asciidoctor.org"][text()="https://asciidoctor.org"]/preceding-sibling::text()[.="(from "]', result, 1 assert_xpath '//a[@href="https://asciidoctor.org"][text()="https://asciidoctor.org"]/following-sibling::text()[.="); where text gets parsed"]', result, 1 end test 'URI scheme with trailing characters should not be converted to a link' do input_sources = %w( (https://) http://; file://: ) expected_outputs = %w( (https://) http://; file://: <ftp://> ) input_sources.each_with_index do |input_source, i| expected_output = expected_outputs[i] actual = block_from_string input_source assert_equal expected_output, actual.content end end test 'qualified url containing round brackets' do assert_xpath '//a[@href="http://jruby.org/apidocs/org/jruby/Ruby.html#addModule(org.jruby.RubyModule)"][text()="addModule() adds a Ruby module"]', render_string('http://jruby.org/apidocs/org/jruby/Ruby.html#addModule(org.jruby.RubyModule)[addModule() adds a Ruby module]'), 1 end test 'qualified url adjacent to text in square brackets' do assert_xpath '//a[@href="http://asciidoc.org"][text()="AsciiDoc"]', render_string(']http://asciidoc.org[AsciiDoc] project page.'), 1 end test 'qualified url adjacent to text in round brackets' do assert_xpath '//a[@href="http://asciidoc.org"][text()="AsciiDoc"]', render_string(')http://asciidoc.org[AsciiDoc] project page.'), 1 end test 'qualified url following no-break space' do assert_xpath '//a[@href="http://asciidoc.org"][text()="AsciiDoc"]', render_string(%(#{[0xa0].pack 'U1'}http://asciidoc.org[AsciiDoc] project page.)), 1 end if ::RUBY_MIN_VERSION_1_9 test 'qualified url following smart apostrophe' do output = render_embedded_string("l’http://www.irit.fr[IRIT]") assert_match(/l’'), 1 end test 'link with quoted text should not be separated into attributes when text contains an equal sign' do assert_xpath '//a[@href="http://search.example.com"][text()="Google, Yahoo, Bing = Search Engines"]', render_embedded_string('http://search.example.com["Google, Yahoo, Bing = Search Engines"]'), 1 end test 'link with quoted text but no equal sign should carry quotes over to output' do assert_xpath %(//a[@href="http://search.example.com"][text()='"Google, Yahoo, Bing"']), render_embedded_string('http://search.example.com["Google, Yahoo, Bing"]'), 1 end test 'link with comma in text but no equal sign should not be separated into attributes' do assert_xpath '//a[@href="http://search.example.com"][text()="Google, Yahoo, Bing"]', render_embedded_string('http://search.example.com[Google, Yahoo, Bing]'), 1 end test 'role and window attributes on link are processed' do assert_xpath '//a[@href="http://google.com"][@class="external"][@target="_blank"]', render_embedded_string('http://google.com[Google, role=external, window="_blank"]'), 1 end test 'link macro with attributes but no text should use URL as text' do url = 'https://fonts.googleapis.com/css?family=Roboto:400,400italic,' assert_xpath %(//a[@href="#{url}"][text()="#{url}"]), render_embedded_string(%(link:#{url}[family=Roboto,weight=400])), 1 end test 'link macro with attributes but blank text should use URL as text' do url = 'https://fonts.googleapis.com/css?family=Roboto:400,400italic,' assert_xpath %(//a[@href="#{url}"][text()="#{url}"]), render_embedded_string(%(link:#{url}[,family=Roboto,weight=400])), 1 end test 'link macro with comma but no explicit attributes in text should not parse text' do url = 'https://fonts.googleapis.com/css?family=Roboto:400,400italic,' assert_xpath %(//a[@href="#{url}"][text()="Roboto,400"]), render_embedded_string(%(link:#{url}[Roboto,400])), 1 end test 'link text that ends in ^ should set link window to _blank' do assert_xpath '//a[@href="http://google.com"][@target="_blank"]', render_embedded_string('http://google.com[Google^]'), 1 end test 'rel=noopener should be added to a link that targets the _blank window' do assert_xpath '//a[@href="http://google.com"][@target="_blank"][@rel="noopener"]', render_embedded_string('http://google.com[Google^]'), 1 end test 'rel=noopener should be added to a link that targets a named window when the noopener option is set' do assert_xpath '//a[@href="http://google.com"][@target="name"][@rel="noopener"]', render_embedded_string('http://google.com[Google,window=name,opts=noopener]'), 1 end test 'rel=noopener should not be added to a link if it does not target a window' do result = render_embedded_string 'http://google.com[Google,opts=noopener]' assert_xpath '//a[@href="http://google.com"]', result, 1 assert_xpath '//a[@href="http://google.com"][@rel="noopener"]', result, 0 end test 'rel=nofollow should be added to a link when the nofollow option is set' do assert_xpath '//a[@href="http://google.com"][@target="name"][@rel="nofollow noopener"]', render_embedded_string('http://google.com[Google,window=name,opts="nofollow,noopener"]'), 1 end test 'id attribute on link is processed' do assert_xpath '//a[@href="http://google.com"][@id="link-1"]', render_embedded_string('http://google.com[Google, id="link-1"]'), 1 end test 'title attribute on link is processed' do assert_xpath '//a[@href="http://google.com"][@title="title-1"]', render_embedded_string('http://google.com[Google, title="title-1"]'), 1 end test 'inline irc link' do assert_xpath '//a[@href="irc://irc.freenode.net"][text()="irc://irc.freenode.net"]', render_embedded_string('irc://irc.freenode.net'), 1 end test 'inline irc link with text' do assert_xpath '//a[@href="irc://irc.freenode.net"][text()="Freenode IRC"]', render_embedded_string('irc://irc.freenode.net[Freenode IRC]'), 1 end test 'inline ref' do variations = %w([[tigers]] anchor:tigers[]) variations.each do |anchor| doc = document_from_string %(Here you can read about tigers.#{anchor}) output = doc.convert assert_equal '[tigers]', doc.catalog[:ids]['tigers'] assert_kind_of Asciidoctor::Inline, doc.catalog[:refs]['tigers'] assert_nil doc.catalog[:refs]['tigers'].text assert_xpath '//a[@id = "tigers"]', output, 1 assert_xpath '//a[@id = "tigers"]/child::text()', output, 0 end end test 'escaped inline ref' do variations = %w([[tigers]] anchor:tigers[]) variations.each do |anchor| doc = document_from_string %(Here you can read about tigers.\\#{anchor}) output = doc.convert refute doc.catalog[:ids].key?('tigers') refute doc.catalog[:refs].key?('tigers') assert_xpath '//a[@id = "tigers"]', output, 0 end end test 'inline ref can start with colon' do input = '[[:idname]] text' output = render_embedded_string input assert_xpath '//a[@id = ":idname"]', output, 1 end test 'inline ref cannot start with digit' do input = '[[1-install]] text' output = render_embedded_string input assert_includes output, '[[1-install]]' assert_xpath '//a[@id = "1-install"]', output, 0 end test 'inline ref with reftext' do %w([[tigers,Tigers]] anchor:tigers[Tigers]).each do |anchor| doc = document_from_string %(Here you can read about tigers.#{anchor}) output = doc.convert assert_equal 'Tigers', doc.catalog[:ids]['tigers'] assert_kind_of Asciidoctor::Inline, doc.catalog[:refs]['tigers'] assert_equal 'Tigers', doc.catalog[:refs]['tigers'].text assert_xpath '//a[@id = "tigers"]', output, 1 assert_xpath '//a[@id = "tigers"]/child::text()', output, 0 end end test 'should encode double quotes in reftext of anchor macro in DocBook output' do input = 'anchor:uncola[the "un"-cola]' result = render_inline_string input, :backend => :docbook assert_equal '', result end test 'should substitute attribute references in reftext when registering inline ref' do %w([[tigers,{label-tigers}]] anchor:tigers[{label-tigers}]).each do |anchor| doc = document_from_string %(Here you can read about tigers.#{anchor}), :attributes => { 'label-tigers' => 'Tigers' } doc.convert assert_kind_of Asciidoctor::Inline, doc.catalog[:refs]['tigers'] assert_equal 'Tigers', doc.catalog[:refs]['tigers'].text assert_equal 'Tigers', doc.catalog[:ids]['tigers'] end end test 'inline ref with reftext converted to DocBook' do %w([[tigers,]] anchor:tigers[]).each do |anchor| doc = document_from_string %(Here you can read about tigers.#{anchor}), :backend => :docbook45 output = doc.convert :header_footer => false assert_kind_of Asciidoctor::Inline, doc.catalog[:refs]['tigers'] assert_equal '', doc.catalog[:refs]['tigers'].text assert_equal '', doc.references[:ids]['tigers'] assert_includes output, '' end end test 'does not match bibliography anchor in prose when scanning for inline anchor' do doc = document_from_string 'Use [[[label]]] to assign a label to a bibliography entry.' refute doc.catalog[:ids].key?('label') refute doc.catalog[:refs].key?('label') end test 'repeating inline anchor macro with empty reftext' do input = 'anchor:one[] anchor:two[] anchor:three[]' result = render_inline_string input assert_equal ' ', result end test 'mixed inline anchor macro and anchor shorthand with empty reftext' do input = 'anchor:one[][[two]]anchor:three[][[four]]anchor:five[]' result = render_inline_string input assert_equal '', result end test 'assigns xreflabel value for anchor macro without reftext in DocBook output' do input = 'anchor:foo[]' result = render_inline_string input, :backend => :docbook assert_equal '', result end test 'unescapes square bracket in reftext of anchor macro' do input = 'see <> anchor:foo[b[a\]r]text' result = render_embedded_string input assert_includes result, 'see b[a]r' end test 'unescapes square bracket in reftext of anchor macro in DocBook output' do input = 'anchor:foo[b[a\]r]' result = render_inline_string input, :backend => :docbook assert_equal '', result end test 'xref using angled bracket syntax' do doc = document_from_string '<>' doc.register :refs, ['tigers', (Asciidoctor::Inline.new doc, :anchor, '[tigers]', :type => :ref, :target => 'tigers'), '[tigers]'] assert_xpath '//a[@href="#tigers"][text() = "[tigers]"]', doc.convert, 1 end test 'xref using angled bracket syntax with explicit hash' do doc = document_from_string '<<#tigers>>' doc.register :refs, ['tigers', (Asciidoctor::Inline.new doc, :anchor, 'Tigers', :type => :ref, :target => 'tigers'), 'Tigers'] assert_xpath '//a[@href="#tigers"][text() = "Tigers"]', doc.convert, 1 end test 'xref using angled bracket syntax with label' do input = <<-EOS <> [#tigers] == Tigers EOS assert_xpath '//a[@href="#tigers"][text() = "About Tigers"]', render_string(input), 1 end test 'xref using angled bracket syntax with quoted label' do input = <<-EOS <> [#tigers] == Tigers EOS assert_xpath %q(//a[@href="#tigers"][text() = '"About Tigers"']), render_string(input), 1 end test 'should not interpret path sans extension in xref with angled bracket syntax in compat mode' do using_memory_logger do |logger| doc = document_from_string '<>', :header_footer => false, :attributes => { 'compat-mode' => '' } assert_xpath '//a[@href="#tigers#"][text() = "[tigers#]"]', doc.convert, 1 end end test 'xref using angled bracket syntax with path sans extension' do doc = document_from_string '<>', :header_footer => false assert_xpath '//a[@href="tigers.html"][text() = "tigers.html"]', doc.convert, 1 end test 'inter-document xref should not add suffix to path with a non-AsciiDoc extension' do { 'using-.net-web-services' => 'Using .NET web services', '../file.pdf' => 'Download the .pdf file' }.each do |path, text| result = render_embedded_string %(<<#{path}#,#{text}>>) assert_xpath %(//a[@href="#{path}"][text() = "#{text}"]), result, 1 end end test 'inter-document xref should only remove the file extension part if the path contains a period elsewhere' do result = render_embedded_string '<>' assert_xpath '//a[@href="using-.net-web-services.html"][text() = "Using .NET web services"]', result, 1 end test 'xref using angled bracket syntax with path sans extension using docbook backend' do doc = document_from_string '<>', :header_footer => false, :backend => 'docbook' assert_match 'tigers.xml', doc.convert, 1 doc = document_from_string '<>', :header_footer => false, :backend => 'docbook45' assert_match 'tigers.xml', doc.convert, 1 end test 'xref using angled bracket syntax with ancestor path sans extension' do doc = document_from_string '<<../tigers#,tigers>>', :header_footer => false assert_xpath '//a[@href="../tigers.html"][text() = "tigers"]', doc.convert, 1 end test 'xref using angled bracket syntax with absolute path sans extension' do doc = document_from_string '<>', :header_footer => false assert_xpath '//a[@href="/path/to/tigers.html"][text() = "tigers"]', doc.convert, 1 end test 'xref using angled bracket syntax with path and extension' do using_memory_logger do |logger| doc = document_from_string '<>', :header_footer => false assert_xpath '//a[@href="#tigers.adoc"][text() = "[tigers.adoc]"]', doc.convert, 1 end end test 'xref using angled bracket syntax with path and extension with hash' do doc = document_from_string '<>', :header_footer => false assert_xpath '//a[@href="tigers.html"][text() = "tigers.html"]', doc.convert, 1 end test 'xref using angled bracket syntax with path and extension with fragment' do doc = document_from_string '<>', :header_footer => false assert_xpath '//a[@href="tigers.html#id"][text() = "tigers.html"]', doc.convert, 1 end test 'xref using macro syntax with path and extension in compat mode' do using_memory_logger do |logger| doc = document_from_string 'xref:tigers.adoc[]', :header_footer => false, :attributes => { 'compat-mode' => '' } assert_xpath '//a[@href="#tigers.adoc"][text() = "[tigers.adoc]"]', doc.convert, 1 end end test 'xref using macro syntax with path and extension' do doc = document_from_string 'xref:tigers.adoc[]', :header_footer => false assert_xpath '//a[@href="tigers.html"][text() = "tigers.html"]', doc.convert, 1 end test 'xref using angled bracket syntax with path and fragment' do doc = document_from_string '<>', :header_footer => false assert_xpath '//a[@href="tigers.html#about"][text() = "tigers.html"]', doc.convert, 1 end test 'xref using angled bracket syntax with path, fragment and text' do doc = document_from_string '<>', :header_footer => false assert_xpath '//a[@href="tigers.html#about"][text() = "About Tigers"]', doc.convert, 1 end test 'xref using angled bracket syntax with path and custom relfilesuffix and outfilesuffix' do attributes = {'relfileprefix' => '../', 'outfilesuffix' => '/'} doc = document_from_string '<>', :header_footer => false, :attributes => attributes assert_xpath '//a[@href="../tigers/#about"][text() = "About Tigers"]', doc.convert, 1 end test 'xref using angled bracket syntax with path and custom relfilesuffix' do attributes = { 'relfilesuffix' => '/' } doc = document_from_string '<>', :header_footer => false, :attributes => attributes assert_xpath '//a[@href="tigers/#about"][text() = "About Tigers"]', doc.convert, 1 end test 'xref using angled bracket syntax with path which has been included in this document' do using_memory_logger do |logger| in_verbose_mode do doc = document_from_string '<>', :header_footer => false doc.catalog[:includes]['tigers'] = true output = doc.convert assert_xpath '//a[@href="#about"][text() = "About Tigers"]', output, 1 assert_message logger, :WARN, 'invalid reference: about' end end end test 'xref using angled bracket syntax with nested path which has been included in this document' do using_memory_logger do |logger| in_verbose_mode do doc = document_from_string '<>', :header_footer => false doc.catalog[:includes]['part1/tigers'] = true output = doc.convert assert_xpath '//a[@href="#about"][text() = "About Tigers"]', output, 1 assert_message logger, :WARN, 'invalid reference: about' end end end test 'xref using angled bracket syntax inline with text' do input = <<-EOS Want to learn <>? [#tigers] == Tigers EOS assert_xpath '//a[@href="#tigers"][text() = "about tigers"]', render_string(input), 1 end test 'xref using angled bracket syntax with multi-line label inline with text' do input = <<-EOS Want to learn <>? [#tigers] == Tigers EOS assert_xpath %{//a[@href="#tigers"][normalize-space(text()) = "about tigers"]}, render_string(input), 1 end test 'xref with escaped text' do # when \x0 was used as boundary character for passthrough, it was getting stripped # now using unicode marks as boundary characters, which resolves issue input = <<-EOS See the <> section for details about tigers. [#tigers] == Tigers EOS output = render_embedded_string input assert_xpath %(//a[@href="#tigers"]/code[text()="[tigers]"]), output, 1 end test 'xref with target that begins with attribute reference in title' do ['<<{lessonsdir}/lesson-1#,Lesson 1>>', 'xref:{lessonsdir}/lesson-1#[Lesson 1]'].each do |xref| input = <<-EOS :lessonsdir: lessons [#lesson-1-listing] == #{xref} A summary of the first lesson. EOS output = render_embedded_string input assert_xpath '//h2/a[@href="lessons/lesson-1.html"]', output, 1 end end test 'xref using macro syntax' do doc = document_from_string 'xref:tigers[]' doc.register :refs, ['tigers', (Asciidoctor::Inline.new doc, :anchor, '[tigers]', :type => :ref, :target => 'tigers'), '[tigers]'] assert_xpath '//a[@href="#tigers"][text() = "[tigers]"]', doc.convert, 1 end test 'multiple xref macros with implicit text in single line' do input = <<-EOS This document has two sections, xref:sect-a[] and xref:sect-b[]. [#sect-a] == Section A [#sect-b] == Section B EOS result = render_embedded_string input assert_xpath '//a[@href="#sect-a"][text() = "Section A"]', result, 1 assert_xpath '//a[@href="#sect-b"][text() = "Section B"]', result, 1 end test 'xref using macro syntax with explicit hash' do doc = document_from_string 'xref:#tigers[]' doc.register :refs, ['tigers', (Asciidoctor::Inline.new doc, :anchor, 'Tigers', :type => :ref, :target => 'tigers'), 'Tigers'] assert_xpath '//a[@href="#tigers"][text() = "Tigers"]', doc.convert, 1 end test 'xref using macro syntax with label' do input = <<-EOS xref:tigers[About Tigers] [#tigers] == Tigers EOS assert_xpath '//a[@href="#tigers"][text() = "About Tigers"]', render_string(input), 1 end test 'xref using macro syntax inline with text' do input = <<-EOS Want to learn xref:tigers[about tigers]? [#tigers] == Tigers EOS assert_xpath '//a[@href="#tigers"][text() = "about tigers"]', render_string(input), 1 end test 'xref using macro syntax with multi-line label inline with text' do input = <<-EOS Want to learn xref:tigers[about tigers]? [#tigers] == Tigers EOS assert_xpath %{//a[@href="#tigers"][normalize-space(text()) = "about tigers"]}, render_string(input), 1 end test 'xref using macro syntax with text that ends with an escaped closing bracket' do input = <<-EOS xref:tigers[[tigers\\]] [#tigers] == Tigers EOS assert_xpath '//a[@href="#tigers"][text() = "[tigers]"]', render_embedded_string(input), 1 end test 'xref using macro syntax with text that contains an escaped closing bracket' do input = <<-EOS xref:tigers[[tigers\\] are cats] [#tigers] == Tigers EOS assert_xpath '//a[@href="#tigers"][text() = "[tigers] are cats"]', render_embedded_string(input), 1 end test 'unescapes square bracket in reftext used by xref' do input = 'anchor:foo[b[a\]r]about see <>' result = render_embedded_string input assert_xpath '//a[@href="#foo"]', result, 1 assert_xpath '//a[@href="#foo"][text()="b[a]r"]', result, 1 end test 'xref using invalid macro syntax does not create link' do doc = document_from_string 'xref:tigers' doc.register :refs, ['tigers', (Asciidoctor::Inline.new doc, :anchor, 'Tigers', :type => :ref, :target => 'tigers'), 'Tigers'] assert_xpath '//a', doc.convert, 0 end test 'should warn and create link if verbose flag is set and reference is not found' do input = <<-EOS [#foobar] == Foobar == Section B See <>. EOS using_memory_logger do |logger| in_verbose_mode do output = render_embedded_string input assert_xpath '//a[@href="#foobaz"][text() = "[foobaz]"]', output, 1 assert_message logger, :WARN, 'invalid reference: foobaz' end end end test 'should warn and create link if verbose flag is set and reference using # notation is not found' do input = <<-EOS [#foobar] == Foobar == Section B See <<#foobaz>>. EOS using_memory_logger do |logger| in_verbose_mode do output = render_embedded_string input assert_xpath '//a[@href="#foobaz"][text() = "[foobaz]"]', output, 1 assert_message logger, :WARN, 'invalid reference: foobaz' end end end test 'should produce an internal anchor from an inter-document xref to file included into current file' do input = <<-'EOS' = Book Title :doctype: book [#ch1] == Chapter 1 So it begins. Read <> to find out what happens next! include::other-chapters.adoc[] EOS doc = document_from_string input, :safe => :safe, :base_dir => fixturedir assert doc.catalog[:includes].key?('other-chapters') assert doc.catalog[:includes]['other-chapters'] output = doc.convert assert_xpath '//a[@href="#ch2"][text()="Chapter 2"]', output, 1 end test 'should produce an internal anchor from an inter-document xref to file included entirely into current file using tags' do input = <<-'EOS' = Book Title :doctype: book [#ch1] == Chapter 1 So it begins. Read <> to find out what happens next! include::other-chapters.adoc[tags=**] EOS output = render_embedded_string input, :safe => :safe, :base_dir => fixturedir assert_xpath '//a[@href="#ch2"][text()="Chapter 2"]', output, 1 end test 'should not produce an internal anchor for inter-document xref to file partially included into current file' do input = <<-'EOS' = Book Title :doctype: book [#ch1] == Chapter 1 So it begins. Read <> to find out what happens next! include::other-chapters.adoc[tags=ch2] EOS doc = document_from_string input, :safe => :safe, :base_dir => fixturedir assert doc.catalog[:includes].key?('other-chapters') refute doc.catalog[:includes]['other-chapters'] output = doc.convert assert_xpath '//a[@href="other-chapters.html#ch2"][text()="the next chapter"]', output, 1 end test 'should warn and create link if debug mode is enabled, inter-document xref points to current doc, and reference not found' do input = <<-EOS [#foobar] == Foobar == Section B See <>. EOS using_memory_logger do |logger| in_verbose_mode do output = render_embedded_string input, :attributes => { 'docname' => 'test' } assert_xpath '//a[@href="#foobaz"][text() = "[foobaz]"]', output, 1 assert_message logger, :WARN, 'invalid reference: foobaz' end end end test 'xref uses title of target as label for forward and backward references in html output' do input = <<-EOS == Section A <<_section_b>> == Section B <<_section_a>> EOS output = render_embedded_string input assert_xpath '//h2[@id="_section_a"][text()="Section A"]', output, 1 assert_xpath '//a[@href="#_section_a"][text()="Section A"]', output, 1 assert_xpath '//h2[@id="_section_b"][text()="Section B"]', output, 1 assert_xpath '//a[@href="#_section_b"][text()="Section B"]', output, 1 end test 'anchor creates reference' do doc = document_from_string "[[tigers]]Tigers roam here." assert_equal({'tigers' => '[tigers]'}, doc.catalog[:ids]) end test 'anchor with label creates reference' do doc = document_from_string "[[tigers,Tigers]]Tigers roam here." assert_equal({'tigers' => 'Tigers'}, doc.catalog[:ids]) end test 'anchor with quoted label creates reference with quoted label text' do doc = document_from_string %([[tigers,"Tigers roam here"]]Tigers roam here.) assert_equal({'tigers' => '"Tigers roam here"'}, doc.catalog[:ids]) end test 'anchor with label containing a comma creates reference' do doc = document_from_string %([[tigers,Tigers, scary tigers, roam here]]Tigers roam here.) assert_equal({'tigers' => 'Tigers, scary tigers, roam here'}, doc.catalog[:ids]) end end