Testing syntax combinations with simple, relative document names.

Input Document ID Output link path HTML Output
xref:foo[Foo] foo <a href="#foo">Foo</a> Foo
xref:bar#[Bar] bar bar <a href="bar.html">Bar</a> Bar
xref:bar.adoc[Bar] bar bar <a href="bar.html">Bar</a> Bar
xref:bar.adoc#[Bar] bar bar <a href="bar.html">Bar</a> Bar
xref:bar#foo[Foobar] bar foo bar <a href="bar.html#foo">Foobar</a> Foobar
xref:bar.adoc#foo[Foobar] bar foo bar <a href="bar.html#foo">Foobar</a> Foobar
<<foo,Foo>> foo <a href="#foo">Foo</a> Foo
<<bar#,Bar>> bar bar <a href="bar.html">Bar</a> Bar
<<bar.adoc,Bar>> bar bar <a href="bar.html">Bar</a> Bar
<<bar.adoc#,Bar>> bar bar <a href="bar.html">Bar</a> Bar
<<bar#foo,Foobar>> bar foo bar <a href="bar.html#foo">Foobar</a> Foobar
<<bar.adoc#foo,Foobar>> bar foo bar <a href="bar.html#foo">Foobar</a> Foobar

Testing deep 'path-like' name traversal.

Input Document ID Output link path HTML Output
xref:bar#[Bar] x/y/z/bar bar <a href="bar.html">Bar</a> Bar
xref:../bar#[Bar] x/y/bar ../bar <a href="../bar.html">Bar</a> Bar
xref:../../bar#[Bar] x/bar ../../bar <a href="../../bar.html">Bar</a> Bar
xref:../../../bar#[Bar] bar ../../../bar <a href="../../../bar.html">Bar</a> Bar
xref:../../../x/bar#[Bar] x/bar ../../bar <a href="../../bar.html">Bar</a> Bar
xref:../../../x/y/bar#[Bar] x/y/bar ../bar <a href="../bar.html">Bar</a> Bar
xref:../../../x/y/z/bar#[Bar] x/y/z/bar bar <a href="bar.html">Bar</a> Bar
xref:../../../x/b/z/bar#[Bar] x/b/z/bar ../../b/z/bar <a href="../../b/z/bar.html">Bar</a> Bar
xref:../../../a/b/c/bar#[Bar] a/b/c/bar ../../../a/b/c/bar <a href="../../../a/b/c/bar.html">Bar</a> Bar

Testing document and ID combinations with one-to-one exporting (one output file per document).

Input Document ID Output link path HTML Output
xref:foo[Foo] foo <a href="#foo">Foo</a> Foo
xref:bar#[Bar] foo/bar bar <a href="bar.html">Bar</a> Bar
xref:bar.adoc[Bar] foo/bar bar <a href="bar.html">Bar</a> Bar
xref:../bar#[Bar] bar ../bar <a href="../bar.html">Bar</a> Bar
xref:../bar#[Bar] bar ../bar <a href="../bar.html">Bar</a> Bar
xref:bar#foo[Foobar] foo/bar foo bar <a href="bar.html#foo">Foobar</a> Foobar
xref:../bar#foo[Foobar] bar foo ../bar <a href="../bar.html#foo">Foobar</a> Foobar

Testing document and ID combinations with many-to-one exporting (one big output file).

Input Document ID Output link path HTML Output
xref:foo[Foo] foo N/A <a href="#foo">Foo</a> Foo
xref:bar#[Bar] foo/bar N/A <a href="foo_bar.html#foo_bar_id">Bar</a> Bar
xref:bar.adoc[Bar] foo/bar N/A <a href="foo_bar.html#foo_bar_id">Bar</a> Bar
xref:../bar#[Bar] bar N/A <a href="bar.html#bar_id">Bar</a> Bar
xref:../bar#[Bar] bar N/A <a href="bar.html#bar_id">Bar</a> Bar
xref:bar#foo[Foobar] foo/bar foo N/A <a href="foo_bar.html#foo_bar_id">Foobar</a> Foobar
xref:../bar#foo[Foobar] bar foo N/A <a href="bar.html#bar_id">Foobar</a> Foobar

Testing document and ID combinations with one-to-many exporting (each document split by section into multiple output files).

Input Document ID Output link path HTML Output
xref:foo[Foo] foo qux_section15 <a href="qux_section15.html#foo">Foo</a> Foo
xref:bar#[Bar] foo/bar bar_section15 <a href="bar_section15.html">Bar</a> Bar
xref:bar.adoc[Bar] foo/bar bar_section15 <a href="bar_section15.html">Bar</a> Bar
xref:../bar#[Bar] bar ../bar_section15 <a href="../bar_section15.html">Bar</a> Bar
xref:../bar#[Bar] bar ../bar_section15 <a href="../bar_section15.html">Bar</a> Bar
xref:bar#foo[Foobar] foo/bar foo bar_section15 <a href="bar_section15.html#foo">Foobar</a> Foobar
xref:../bar#foo[Foobar] bar foo ../bar_section15 <a href="../bar_section15.html#foo">Foobar</a> Foobar