summaryrefslogtreecommitdiff
path: root/docs/modules/api
diff options
context:
space:
mode:
authorDan Allen <dan.j.allen@gmail.com>2023-03-13 14:33:44 -0600
committerDan Allen <dan.j.allen@gmail.com>2023-03-13 14:33:44 -0600
commit093eed14225bc9ef4664d03fdc965fa7e2acb7a1 (patch)
tree0592b2be49a863990484a6ad698db555122f40cd /docs/modules/api
parentea73a2d05b34da0020b40cbd06747b96781afbe9 (diff)
clarify that inline anchors in paragraphs and list items are cataloged during initial parse; must be escaped with backslash
Diffstat (limited to 'docs/modules/api')
-rw-r--r--docs/modules/api/pages/catalog-assets.adoc7
1 files changed, 6 insertions, 1 deletions
diff --git a/docs/modules/api/pages/catalog-assets.adoc b/docs/modules/api/pages/catalog-assets.adoc
index 663c78fa..04db7d30 100644
--- a/docs/modules/api/pages/catalog-assets.adoc
+++ b/docs/modules/api/pages/catalog-assets.adoc
@@ -20,8 +20,13 @@ The processor always cataloged the following assets, regardless of this setting:
* block or inline anchors (key: `:refs`)
* footnotes (key: `:footnotes`)
-Inline elements are not cataloged until conversion.
+Generally speaking, inline elements are not cataloged until conversion.
Therefore, they're only available after the document has been converted, not after it has been loaded.
+However, inline anchors are an exception.
+
+Inline anchors in paragraphs and list items are cataloged when the document is parsed.
+However, the scan for inline anchors happens before inline passthroughs are processed.
+Therefore, to escape an inline anchor, you must use a backslash instead of an inline passthrough.
== Set :catalog_assets option