git.iko.soy/typeable/pandoc
on master help sign in
MANUAL: Document use of citations in note styles.

See #6828.

commitee03d86a5da55f0b79346a3e4d5b1fe4b150d3b5 authorJohn MacFarlane <jgm@berkeley.edu> dateWed 30 Dec 2020, 10:42 (6 years ago) parentdcbd8d3
1 file changed+28
MANUAL.txt+28
MANUAL.txt+28
@@ -5359,6 +5359,34 @@ example:
53595359 }
53605360 }
53615361
5362+
5363+## Citations in note styles
5364+
5365+Pandoc's citation processing is designed to allow you to
5366+move between author-date, numerical, and note styles without
5367+modifying the markdown source. When you're using a note
5368+style, avoid inserting footnotes manually. Instead, insert
5369+citations just as you would in an author-date style---for
5370+example,
5371+
5372+ Blah blah [@foo, p. 33].
5373+
5374+The footnote will be created automatically. Pandoc will take
5375+care of removing the space and moving the note before or
5376+after the period, depending on the setting of
5377+`notes-after-punctuation`, as described below in [Other relevant
5378+metadata fields].
5379+
5380+In some cases you may need to put a citation inside a regular
5381+footnote. Normal citations in footnotes (such as `[@foo, p.
5382+33]`) will be rendered in parentheses. In-text citations (such
5383+as `@foo [p. 33]`) will be rendered without parentheses. (A
5384+comma will be added if appropriate.) Thus:
5385+
5386+ [^1]: Some studies [@foo; @bar, p. 33] show that
5387+ frubulicious zoosnaps are quantical. For a survey
5388+ of the literature, see @baz [chap. 1].
5389+
53625390## Raw content in a style
53635391
53645392To include raw content in a prefix, suffix, delimiter, or term,