Antora & AsciiDoc Feature Reference

TIP: Use `subs=attributes+` for code blocks with attributes.

[NOTE]
====
This is a block admonition.
It can contain multiple paragraphs.
====

status-active: icon:circle[role=green] Active
status-complete: icon:check-circle[role=blue] Complete
status-archived: icon:archive[role=gray] Archived
status-planned: icon:clock[role=gray] Planned
status-in-progress: icon:spinner[role=blue]
status-done: icon:check[role=green]

| Project Alpha | {status-active} |
| Project Beta | {status-complete} |

[source,bash]
----
#!/bin/bash
echo "Hello, World!"
----

[source,bash]
----
vault write pki_int/issue/domus-client \ (1)
  common_name="host.example.com" \ (2)
  ttl="8760h" (3)
----
<1> PKI mount path and role
<2> Common name for certificate
<3> Time to live (1 year)

[source,bash]
----
export VAULT_ADDR="https://vault.example.com" (1)
vault login -method=ldap username="$USER" (2)
----
<1> Set Vault address
<2> Authenticate with LDAP

[source,bash,subs=attributes+]
----
ssh {person-evan}@{ise-hostname}
vault status -address=https://{vault-ip}:{vault-port}
----

include::partial$trackers/work/adhoc.adoc[]

// tag::carryover[]
| Task 1 | 5 days |
| Task 2 | 3 days |
// end::carryover[]

include::partial$trackers/work/adhoc.adoc[tag=carryover]

include::partial$trackers/work/projects.adoc[tags=p0;p1]

include::example$script.sh[lines=10..20]

include::partial$section.adoc[leveloffset=+1]

ifdef::env-github[]
This only appears on GitHub.
endif::[]

ifndef::backend-html5[]
This appears for non-HTML output.
endif::[]

ifeval::[{sectnums} == true]
Sections are numbered.
endif::[]

ifeval::["{backend}" == "html5"]
HTML-specific content here.
endif::[]

[cols="1,2,3",options="header,footer,autowidth"]
|===
| Header 1 | Header 2 | Header 3
| Cell | Cell | Cell
| Footer 1 | Footer 2 | Footer 3
|===

|===
| Cell 1 | Cell 2 | Cell 3

2+| Spans 2 columns | Cell 3

.2+| Spans 2 rows
| Cell 2
| Cell 3

2.3+| Spans 2 cols, 3 rows
|===

= Document Title
:stem: asciimath

The formula stem:[sqrt(4) = 2] is simple.
Water (stem:[H_2O]) is essential.

[stem]
++++
sum_(i=1)^n i^3=((n(n+1))/2)^2
++++

latexmath:[\lim_{n \to \infty}\frac{n}{\sqrt[n]{n!}} = e]

xref:page.adoc[Link Text]
xref:folder/page.adoc#section[Section Link]

// TODO: Enable when infra-ops component is in playbook
// xref:infra-ops::runbooks/vyos-deployment.adoc[VyOS Runbook]
// TODO: Enable when ise-linux component is in playbook
// xref:ise-linux::02-pki/certificate-enrollment.adoc[Cert Enrollment]

See the xref:page.adoc[official documentation,role=external,window=_blank].

* Item 1
** Nested item
*** Deep nested
* Item 2

. First
. Second
.. Sub-item a
.. Sub-item b
. Third

* [x] Completed task
* [ ] Pending task
* [*] Also completed (alternative)

Term 1:: Definition 1
Term 2:: Definition 2
Nested term::: Nested definition

// WRONG - Antora interprets {print} as missing attribute
awk '/ERROR/ {print}'

WARN (asciidoctor): skipping reference to missing attribute: print

// CORRECT - backslash escapes the brace
awk '/ERROR/ \{print}'

// WRONG
The `{print}` function outputs text.

// CORRECT
The `\{print}` function outputs text.

pass:c[{print $1}]