aboutsummaryrefslogtreecommitdiff
path: root/MANUAL.txt
diff options
context:
space:
mode:
authorJohn MacFarlane <[email protected]>2025-07-25 10:25:14 -0700
committerJohn MacFarlane <[email protected]>2025-12-06 18:33:17 +0100
commit28d3dbfec97b9cdccf16fb63042380c2ef89cb63 (patch)
treec7389cf40d900cbeed16d58227bc5ab0159cb317 /MANUAL.txt
parent7ced712014b64b59d39e07c82a1633109c05f730 (diff)
Implement `reset-citation-positions` class on headings.reset-position
When the `reset-citation-positions` class is added to a top-level heading, `--citeproc` will reset position information at that point in the document. This is needed in order to ensure that the first citation in a chapter to a work that has been cited in a previous chapter will not be in abbreviated form. Requires a dependency on a development version of citeproc.
Diffstat (limited to 'MANUAL.txt')
-rw-r--r--MANUAL.txt11
1 files changed, 11 insertions, 0 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index 91f1c8e7f..f712eb68b 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -5992,6 +5992,17 @@ parentheses, while author-in-text citations will not. For
this reason, it is sometimes preferable to use the
author-in-text style inside notes when using a note style.
+Many CSL styles will format citations differently when the
+same source has been cited earlier. In documents with chapters,
+it is usually desirable to reset this position information
+at the beginning of every chapter. To do this, add the class
+`reset-citation-positions` to the heading for each chapter:
+
+ # The Beginning {.reset-citation-positions}
+
+Note that this class only has an effect when placed on
+top-level headings; it is ignored in nested blocks.
+
[CSL user documentation]: https://citationstyles.org/authors/
[CSL]: https://docs.citationstyles.org/en/stable/specification.html
[CSL markup specs]: https://citeproc-js.readthedocs.io/en/latest/csl-json/markup.html#html-like-formatting-tags