emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* org-cite: make 'suppress-author' a citation 'style'
@ 2021-04-24 10:52 Bruce D'Arcus
  2021-04-24 12:28 ` Bruce D'Arcus
  2021-04-24 17:08 ` Nicolas Goaziou
  0 siblings, 2 replies; 21+ messages in thread
From: Bruce D'Arcus @ 2021-04-24 10:52 UTC (permalink / raw)
  To: org-mode-email

Hi Nicolas,

As I was working on adding a function to generate the new cite syntax,
an idea occurred to me that I'd like to raise, that would simplify
this model and syntax.

I ran the idea by the pandoc list just to confirm my thinking was
reasonable, since that has a lot of experience using these plain-text
citations.

https://groups.google.com/g/pandoc-discuss/c/zbntclaBWDc/m/DCx-mpfcDQAJ

Let's review:

In org-cite, we have citations, and citation items.

Citations may have optional styles.

Citation items may have an optional "suppress-author" "variant",
indicated with a "-". So:

[cite:-doe19;doe20]

The idea:

This distinction is wrong, and we should treat "suppress-author" as a
citation style instead.

The result would be:

[cite/supress-author:doe19;doe20]

Or even can keep the shorthand:

[cite/-:doe19;doe20]

In fact, with the change, could even remove it entirely

If you read the discussion in the pandoc list, there is mild, but I
don't think convincing, pushback.

Part of that pushback is an artifact of the fact that pandoc citations
don't have a notion of citation style, where you specify things like

OTOH, pandoc and (haskell) citeproc author John MacFarlane agrees that
in retrospect the pandoc decision was probably wrong, in part because
of another related issue.

Supress-author is a convention that CSL implementations settled on,
arguably a hack, to get around lack of explicit support for natbib
citet-like citations (though this is being added in the next version).

So to get "Doe (2019) argues" you would need to write "Doe [@doe19]"
in pandoc, for example.

But if you can do this in org-cite, "suppress-author" is no longer needed:

"[cite/text:@doe19] argues ..."

Both should probably be possible, but the textual (aka narrative)
style is what most users are looking for there IMO.

I think a positive side-effect is this model would match better LaTeX
output models (natbib and biblatex namely).

WDYT?

Bruce


^ permalink raw reply	[flat|nested] 21+ messages in thread

end of thread, other threads:[~2021-04-27 10:06 UTC | newest]

Thread overview: 21+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-04-24 10:52 org-cite: make 'suppress-author' a citation 'style' Bruce D'Arcus
2021-04-24 12:28 ` Bruce D'Arcus
2021-04-24 17:08 ` Nicolas Goaziou
2021-04-24 17:28   ` Bruce D'Arcus
2021-04-24 19:36     ` Bruce D'Arcus
2021-04-24 20:09       ` Nicolas Goaziou
2021-04-24 22:51         ` Bruce D'Arcus
2021-04-25  5:55           ` András Simonyi
2021-04-25 12:50             ` Bruce D'Arcus
2021-04-25 19:48               ` András Simonyi
2021-04-25 20:12                 ` Bruce D'Arcus
2021-04-26  7:53                   ` Denis Maier
2021-04-26  9:05                     ` Denis Maier
2021-04-26  9:34                     ` Joost Kremers
2021-04-26 11:36                       ` Bruce D'Arcus
2021-04-26  7:51     ` Richard Lawrence
2021-04-26  9:33       ` Bruce D'Arcus
2021-04-27  7:36         ` Richard Lawrence
2021-04-27  7:52           ` Denis Maier
2021-04-27  8:24             ` Richard Lawrence
2021-04-27 10:05             ` Bruce D'Arcus

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).