diff options
| author | John MacFarlane <jgm@berkeley.edu> | 2020-12-30 10:42:24 -0800 |
|---|---|---|
| committer | John MacFarlane <jgm@berkeley.edu> | 2020-12-30 10:42:24 -0800 |
| commit | ee03d86a5da55f0b79346a3e4d5b1fe4b150d3b5 (patch) | |
| tree | 2741520f00d78e896bc3997184a3d3d1e3d4b470 | |
| parent | dcbd8d326cce4960e0d736e25e7d00f9057a1fc2 (diff) | |
| download | pandoc-ee03d86a5da55f0b79346a3e4d5b1fe4b150d3b5.tar.gz | |
MANUAL: Document use of citations in note styles.
See #6828.
| -rw-r--r-- | MANUAL.txt | 28 |
1 files changed, 28 insertions, 0 deletions
diff --git a/MANUAL.txt b/MANUAL.txt index b1f0f305c..53cd54e5f 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -5359,6 +5359,34 @@ example: } } + +## Citations in note styles + +Pandoc's citation processing is designed to allow you to +move between author-date, numerical, and note styles without +modifying the markdown source. When you're using a note +style, avoid inserting footnotes manually. Instead, insert +citations just as you would in an author-date style---for +example, + + Blah blah [@foo, p. 33]. + +The footnote will be created automatically. Pandoc will take +care of removing the space and moving the note before or +after the period, depending on the setting of +`notes-after-punctuation`, as described below in [Other relevant +metadata fields]. + +In some cases you may need to put a citation inside a regular +footnote. Normal citations in footnotes (such as `[@foo, p. +33]`) will be rendered in parentheses. In-text citations (such +as `@foo [p. 33]`) will be rendered without parentheses. (A +comma will be added if appropriate.) Thus: + + [^1]: Some studies [@foo; @bar, p. 33] show that + frubulicious zoosnaps are quantical. For a survey + of the literature, see @baz [chap. 1]. + ## Raw content in a style To include raw content in a prefix, suffix, delimiter, or term, |