aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJohn MacFarlane <[email protected]>2025-09-06 20:01:32 +0200
committerJohn MacFarlane <[email protected]>2025-09-06 20:01:32 +0200
commit149c812e6a1f32fb1cdb82d7ce1027e174471809 (patch)
treec8608e0c7079deae4a1a342fd1cda208b17d1acb
parent8aa665a33dd07ff7edbb296b8718a1ded4b91b33 (diff)
Document the last change (`refs` with citeproc) in manual.
-rw-r--r--MANUAL.txt9
1 files changed, 8 insertions, 1 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index 57a4d4395..2b621cd85 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -6487,7 +6487,7 @@ comma will be added if appropriate.) Thus:
## Placement of the bibliography
If the style calls for a list of works cited, it will be placed
-in a div with id `refs`, if one exists:
+in a div with id `refs`, if one exists:[^note-on-refs]
::: {#refs}
:::
@@ -6496,6 +6496,13 @@ Otherwise, it will be placed at the end of the document.
Generation of the bibliography can be suppressed by setting
`suppress-bibliography: true` in the YAML metadata.
+[^note-on-refs]:
+ Note that if `--file-scope` is used, a div written this way will be
+ given an identifier of the form `FILE__refs`, to avoid duplicate
+ identifiers (see `--file-scope`). In view of this possibility,
+ pandoc will place the bibliography in any div whose identifier is
+ `refs` *or* ends with `__refs`.
+
If you wish the bibliography to have a section heading, you can
set `reference-section-title` in the metadata, or put the heading
at the beginning of the div with id `refs` (if you are using it)