jgm/pandoc

\pno in citations in LaTeX exports

Open

#4,739 opened on Jun 27, 2018

View on GitHub
 (3 comments) (0 reactions) (0 assignees)Haskell (44,133 stars) (3,850 forks)batch import
format:LaTeXgood first issuewriter

Description

When citing a resource with a comment following the page number, e.g. [@Jones_2010, 20, my emphasis], the resulting LaTeX export is \autocite[20, my emphasis]{Jones_2010}. This causes BibLaTeX to treat the entire postnote as raw text without automatic inclusion of a style-dependent page prefix. So when using a citation style that includes e.g. p. before the page number, the final result becomes

See for example (Jones 2010, 20).

while it should be

See for example (Jones 2010, p. 20).

BibLaTeX requires using \pno in such cases in order to trigger the page prefixing manually where the postnote string is too complex for automatic inclusion. Therefore, Pandoc should export such a citation as \autocite[\pno~20, my emphasis]{Jones_2010}. Respectively \ppno should be used for a page range.

Pandoc 2.2.1 with the command: pandoc --read=markdown --write=latex --output=FILENAME --biblatex --top-level-division=chapter --number-sections --standalone --table-of-contents --include-in-header=header-includes.tex --include-before-body=before-body-includes.tex --bibliography=zotero.bib (Note that an input file is missing because I use pandoc-mode in Emacs)

Contributor guide

Tech stack
None
Domain
documentationcli
Issue type
bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
stale
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
clear
Prerequisites
Pandoc basicsLaTeX/BibLaTeX knowledgecitation format understanding
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
30
Research direction
The issue concerns the LaTeX writer in Pandoc, specifically the citation generation in the `Writer.hs` file. Look at how postnotes are currently passed to `\autocite` and modify the code to insert `\pno` or `\ppno` before numeric portions when the postnote contains additional text. The comment by jgm suggests a possible approach. No linked PRs, so the fix is unclaimed.