Skip to content
Permalink
Browse files
add a section on page refs
  • Loading branch information
djencks committed Jul 23, 2021
1 parent f5ab68c commit bc98af373b0b60e225850fd8988d4f6b12ff3671
Showing 1 changed file with 22 additions and 2 deletions.
@@ -62,13 +62,33 @@ To manually specify an id, precede the section line with `[#my-id]` on a separat
* Code blocks look like this:
[source,adoc]
------
[source,java]
----
[source,java] <1>
---- <2>
class Foo {
...
}
----
------
<1> Any language you want: highlighting is available for most.
<2> Block separator `----`
=== Page links
Between pages::
Use the `xref:` inline macro:
`+++xref:other-page.adoc[]+++`.
* The path to the other page starts from the `pages` directory: it is not relative to the current page.
* For a non-fragment reference, the default link text is the other page title.
Custom text may be specified inside the `[]` brackets.
* For fragment references you must specify the link text.
Within a page::
Use the form `+++<<#_fragment_name, link text>>+++`.
For a link to a section, the default link text is the section title.
NOTE: The Intellij asciidoc plugin has Antora-aware syntax checking and auto-complete, including the generated section ids.
== Local build

0 comments on commit bc98af3

Please sign in to comment.