pandoc syntax: corrections & improvements

[njbart]

When picking a citation via the RStudio "AddIns" menu -> "RBBT/Insert Zotero citation", the pandoc syntax inserted into the document isn’t always correct, and some aspects could be improved.

First, a suggested improvement: So-called author-in-narrative citations ("Doe says foo (2019).") are required much less frequently than parenthetical citations ("Foo is bar (Doe 2019)."), so I’d prefer a default (if pandoc syntax is used) of:

[@author:2016title]

with prefix and suffix (in pandoc syntax, the latter includes both locator(s) and any other suffix):

[prefix @author:2016title, 12-34, suffix]

Apart from that

• @author:2016title, p. 12 should be @author:2016title [p. 12] or just @author:2016title [12]
  • or even better: [@author:2016title, 12]
• @author:2016title, ch. 7 should be @author:2016title [chap. 7]
  • or even better: [@author:2016title, chap. 7]

[paleolimbot]

Unfortunately this is a better bibtex issue...all I do is call the REST API. The scope of this package is limited to that API, mostly because it's all I have time to maintain. I beleive the citr package attempts to have a larger scope than this package, which may be worth a look.

[bwiernik]

@njbart You can set pandoc citations to include brackets in the Better BibTeX settings. Support in BBT for placing the locators in brackets for narrative citations will need to wait until Zotero implements narrative citations into its word processors, as BBT just calls Zotero's citation picker interface.