text-crossrefs: add a rule for notes in Typst and provide a way to disable

This commit is contained in:
Bastien Dumont
2025-12-23 13:10:13 +01:00
parent ddeabe22b8
commit 6864f3e35f
2 changed files with 30 additions and 5 deletions

View File

@ -140,6 +140,11 @@ in addition to those that the filter already inserts:
#set page(supplement: [])
```
The filter also adds a show rule for `#ref` that prints the footnote reference number
in normal script (by default, Typst handles it as a footnote anchor).
If you wish to provide your own rules instead,
you can set the metadata variable `tcrf-typst-adaptations` to `false`.
In the default mode, you can also (ab)use the `note` reference type to refer to
a heading, figure or equation by its number, for the `note` reference type
is mapped to the `normal` form in Typst, which is common to all these elements:
@ -372,6 +377,9 @@ In this case, the metadata fields [specific to TeX](#tex-options) will be taken
Otherwise, _text-crossrefs_ will only output native `#ref` commands.
In this case, the metadata fields [specific to DOCX and ODT](#docx-odt-options) will be used.
_text-crossrefs_ [adds two rules to `header-includes`](#typst)
to make `#ref` print only the reference numbers without formatting:
if you prefer to define your own rules, set `tcrf-typst-alter-ref` to false.
# Compatibility with other filters