asciidocpage.adoc

basic linked variations in asciidoc

Table of Contents

• play with this file
• official docs
• linking
• including
• using images
  • relative image
  • absolute image url

play with this file

• build gradle orchidServe

• view http://localhost:8080/asciidoc/asciidocpage

official docs

• https://asciidoctor.org/docs/user-manual/#navigating-between-source-files

• https://asciidoctor.org/docs/user-manual/#inter-document-cross-references

linking

sample relative linking	result
asciidoc linked via xref!	inter document cross reference (first choice), could work with :outfilesuffix: to remove .html suffix
asciidoc linked via link!	link relative (second choice), could work with :outfilesuffix:

including

including does not work with orchid. E.g. safe modes enabled?

relative url include

link:include.sample.txt[role=include]

relative url partial include

link:include.sample.txt[role=include]

using images

image links do work, images have to be copied separatly (e.g. with gradle copy task).

relative image

absolute image url