diff options
| -rw-r--r-- | _pandoc.qmd | 43 |
1 files changed, 30 insertions, 13 deletions
diff --git a/_pandoc.qmd b/_pandoc.qmd index 6df5b51..0d3c911 100644 --- a/_pandoc.qmd +++ b/_pandoc.qmd @@ -137,20 +137,37 @@ can become more of an obstacle than an optimization. Some functionalities of Pandoc hook into multiple components of its workflow. -An example of a complex functionality is citation handling. +An example of a complex functionality is citation handling, +which involves two sources, a style guide, and a template. The source text contains citation annotations, -referencing document-wide or externally stored bibliographic metadata. -Rendering consists of up to three compositions from the two sources: -an inline text annotation, -a footnote on the same or a following page, -and an entry in a bibliography chapter often appended the main text. -The style of these up to three renderings vary, -and Pandoc offers several ways to manage the composition, -where the recommended approach is to pick one option -from Citation Style Language, -a collection of more than 10.000 styles, -each containing rules, for example of how to sort and abbreviate -a citation containing multiple authors. +referencing document-wide or externally stored bibliographic metadata, +such as this: + +```markdown +> you can create code span by wrapping text in backtick quotes +> [@Gruber2004] +``` + +Pandoc uses an extension to Markdown to capture `[@Gruber2004]`, +look it up in a bibliographic database +(which might be locally maintained or using a suitable cloud service), +and renders two or three texts: + +1. the replacement text where the citation was written +2. a footnote on the same or a following page +3. an entry in a bibliography chapter at the end of the text + +The style of these renderings, and whether the second one is omitted, +depends on which citation style is chosen, +usually selected from Citation Style Language, +a collection of more than 10.000 styles. +One common style is APA, +that says to include surname and year in the first text, +omit the second text, +and sort the entry in the third text by surname -- +and contains hundreds of other details, +for example on how to abbreviate a citation with 16 authors, +or an entry without an author listed. Ideally, citations can be separated into prose (annotation), structure (bibliographic metadata) |