Re: org-cite citation commands

["András Simonyi" <andras.simonyi@gmail.com>]

Dear Vikas,

the CSL-based processor is in a bit of a flux in this respect, but as
for the natbib and biblatex processors I've extracted these
correspondences from the oc source code, which you might find useful.
(With the exception of the first, "fully nil" styles, one always has
to use the "/" separator between "cite" and the listed combinations,
for the default styles this means a double slash, e.g.,  [cite//b@key]
leads to  \citealp{key} using the natbib processor.

* Natbib

;; default style.
                                --> \citep
/ [bare|b]                      --> \citealp
/ [caps|c]                      --> \Citep
/ [full|f]                      --> \citep*
/ [bare-caps|bc]                --> \Citealp
/ [bare-full|bf]                --> \citealp*
/ [caps-full|cf]                --> \Citep*
/ [bare-caps-full|bcf]          --> \Citealp*

;; author style.
[author|a] / [caps|c]           --> \Citeauthor
[author|a] / [full|f]           --> \citeauthor*
[author|a]                      --> \citeauthor

;; noauthor style
[noauthor|na] / [bare|b]        --> \citeyear
[noauthor|na]                   --> \citeyearpar

;; nocite style.
[nocite|n]                      --> \nocite

;; text style.
[text|t] / [bare|b]             --> \citealt
[text|t] / [caps|c]             --> \Citet
[text|t] / [full|f]             --> \citet*
[text|t] / [bare-caps|bc]       --> \Citealt
[text|t] / [bare-full|bf]       --> \citealt*
[text|t] / [caps-full|cf]       --> \Citet*
[text|t] / [bare-caps-full|bcf] --> \Citealt*
[text|t]                        --> \citet

* biblatex

;; Default nil style.
                              --> autocite
/ [bare|b]                    --> cite
/ [caps|c]                    --> Autocite
/ [bare-caps|b]               --> Cite

;; author style.
[author|a] / [caps|c])        --> Citeauthor*
[author|a] / [full|f])        --> citeauthor
[author|a] / [caps-full|cf]   --> Citeauthor
[author|a]                    --> citeauthor*

;; locators style.
[locators|l] / [bare|b]       --> notecite
[locators|l] / [caps|c]       --> Pnotecite
[locators|l] / [bare-caps|bc] --> Notecite
[locators|l]                  --> pnotecite

;; noauthor style.
[noauthor|na]                 --> autocite*

;; nocite style.
[nocite|n]                    --> nocite

;; text style.
[text|t] / [caps|c])          --> Textcite
[text|t]                      --> textcite

best regards,
András


On Sat, 17 Jul 2021 at 13:41, Vikas Rawal <vikasrawal@gmail.com> wrote:
>
> I have been a long time user of org-ref and am excited to see the
> development of org-cite. Thanks a lot for this, Nicholas and others
> who have been working on this. I have been wanting to give it a spin
> for the last few days and finally got down to doing it.
>
> I am aware that the documentation is still in the works and therefore
> my apologies in advance if asking these questions is premature. I have
> looked at Nicholas' mails which provide basic documentation and have
> been trying to follow these.
>
> What is the equivalent here of the various citation commands that something like biblatex or bibtex provide? The two most common citation commands I use are citet and citep (or parencite). These are used to produce the following kind of output using org-ref/biblatex:
>
>
> -----
> * citet
>
> citet:john is an excellent resource.
>
> will be exported as:
>
> John (1990) is an excellent resource.
>
> * citep
>
> This is an excellent resource citep:john.
>
> will be exported as
>
> This is an excellent resource (John, 1990).
>
> ----
>
> How does one achieve this using org-cite?
>
> I am a bit lost with the citation styles that are inbuilt in oc-biblatex.el. Is it expected that we will have to write additional citation styles for getting these kinds of output?
>
> Apologies if this is a naive or a premature question.
>
> Many thanks to everyone.
>
> Vikas
>