Re: [O] Citation syntax: a revised proposal

[Richard Lawrence]

Hi Andreas,

Andreas Leha <address@hidden> writes:

> I have been following this thread from (quite) some distance as I am
> very interested in more general citation support from orgmode.  Please
> allow some basic questions:
>
> 1. For the LaTeX user
> This change means that the LaTeX user can use org syntax for citations
> rather than bare LaTeX (or links of some sort)?
>
> And this org syntax could then (I guess is the future) be extended with
> additional link-like functionality (maybe similar to org-ref)?

Yes, exactly.

> 2. The non-LaTeX exports
> These are all treated the same and will contain just text, that is
> produced to mimic LaTeX's output to some extent?

Well, that depends on what you mean by `just' text.  Citations can still
contain or be wrapped in markup that is specific to the output format,
like span tags or anchor tags in HTML.

> I think I read some question about e.g. having zotero handling the
> citations in the odt export.  Are there plans for such thing?

Maybe.  As far as I know, no one has done any work on Zotero integration
yet.  But Vaidheeswaran did some work to make JabRef (a different
reference database) handle citations in ODT export.

> 3. The database
> As I understand the database currently is either bibtex or org?  

Yes.

> But that list could in principle be extended to zotero ... ?

Yes, in principle.  Any database that can export to bibtex format is
supported to some degree, if we support that format.  Whether we want to
integrate with any particular reference database more tightly than that
hasn't really been discussed, as far as I'm aware.  I don't have a good
sense of what other software Org users rely on for this purpose.

> And any other database X (zotero ...) would need translations X ->
> bibtex to make the LaTeX export work with it as well?

Not necessarily.  Obviously, if you want to have bibtex/biblatex do the
processing of the citations and bibliography in the document, that is
required.  But there is another approach, which is the one that Pandoc
takes: directly rendering citations and bibliography into the output
.tex file.  If you're not relying on bibtex/biblatex to do the
rendering, you don't need to have the database in its format.

The org-citeproc tool I've been working on supports reading databases in
any of these formats (via pandoc-citeproc):

Format            File extension
------------      --------------
MODS              .mods
BibLaTeX          .bib
BibTeX            .bibtex
RIS               .ris
EndNote           .enl
EndNote XML       .xml
ISI               .wos
MEDLINE           .medline
Copac             .copac
JSON citeproc     .json 

org-citeproc (via pandoc-citeproc) should already be able to read
databases in these other formats.  It would be trivial to add a LaTeX
writer to org-citeproc that would allow rendering citations and
bibliographies directly, as Pandoc does (since org-citeproc is just a
small wrapper around pandoc and pandoc-citeproc).

> 4. Example
> Could you post one of your examples?  I'd love to see the prototype in
> action to have a proper picture of this.

A couple of other people (Vaidheeswaran, Aaron Ecay) have posted
examples in other messages.  Here's an example of a simple Org document
being processed by org-citeproc:

#+BEGIN_SRC org
    #+OPTIONS: toc:nil todo:t |:t
    #+TITLE: Org-Citeproc Test
    #+AUTHOR: Richard Lawrence
    #+LANGUAGE: en
    #+BIBDB: bibtex ~/Documents/philosophy/dissertation/build/dissertation.bib
    #+CSL_FILE: /tmp/chicago-author-date.csl

    Citations and Bibliography are supported using org-citeproc.

    Here's a couple of them.
    [(cite): @Brandom1994] [(cite): @Russell1919] [(cite): @Vaanaanen2011]

    And one textual cite to throw in the mix:
    [cite: See @Caponigro2003].

    #+BIBLIOGRAPHY: here

#+END_SRC
 
In plain text, the body renders like:

#+BEGIN_QUOTE
    Citations and Bibliography are supported using org-citeproc.

    Here's a couple of them.  (Brandom 1994) (Russell 2001) (Väänäänen 2011)

    And one textual cite to throw in the mix: Caponigro (See 2003).

    Brandom, Robert. 1994. _Making It Explicit_. Harvard University Press.

    Caponigro, Ivano. 2003. “Free Not to Ask: On the Semantics of Free 
Relatives and
    Wh-Words Cross-Linguistically.” PhD thesis, University of California, Los
    Angeles.

    Russell, Bertrand. 2001. “Descriptions.” In _The Philosophy of Language_, 
edited
    by A. P. Martinich, Fourth, 221–27. Oxford University Press.

    Väänäänen, Jouko. 2011. _Models and Games_. Vol. 132. Cambrdige Studies in
    Advanced Mathematics. Cambridge University Press.
#+END_QUOTE

And in HTML, the relevant parts of the body look like this (hopefully,
you can see this unescaped HTML in your mail/news reader):

#+BEGIN_QUOTE
    <p>
    Citations and Bibliography are supported using org-citeproc.
    </p>

    <p>
    Here's a couple of them.
    <span class="citation">(Brandom 1994)</span> <span 
class="citation">(Russell 2001)</span> <span class="citation">(Väänäänen 
2011)</span>
    </p>

    <p>
    And one textual cite to throw in the mix:
    <span class="citation">Caponigro (See 2003)</span>.
    </p>

    <div class="bibliography"><div class="bibliography"><p>Brandom, Robert. 
1994. <em>Making It Explicit</em>. Harvard University Press.</p><p>Caponigro, 
Ivano. 2003. “Free Not to Ask: On the Semantics of Free Relatives and Wh-Words 
Cross-Linguistically.” PhD thesis, University of California, Los 
Angeles.</p><p>Russell, Bertrand. 2001. “Descriptions.” In <em>The Philosophy 
of Language</em>, edited by A. P. Martinich, Fourth, 221–27. Oxford University 
Press.</p><p>Väänäänen, Jouko. 2011. <em>Models and Games</em>. Vol. 132. 
Cambrdige Studies in Advanced Mathematics. Cambridge University Press.</p></div>
    </div>
    </div>
#+END_QUOTE

I've attached the full files, too.

Note that citations containing multiple references are not supported at
the moment, but that is coming soon.

Best,
Richard

citetest.org
Description: Text document

citetest.txt
Description: Text document

Org-Citeproc Test

Citations and Bibliography are supported using org-citeproc.

Here's a couple of them. (Brandom 1994) (Russell 2001) (Väänäänen 2011)

And one textual cite to throw in the mix: Caponigro (See 2003).

Brandom, Robert. 1994. Making It Explicit. Harvard University Press.

Caponigro, Ivano. 2003. “Free Not to Ask: On the Semantics of Free Relatives and Wh-Words Cross-Linguistically.” PhD thesis, University of California, Los Angeles.

Russell, Bertrand. 2001. “Descriptions.” In The Philosophy of Language, edited by A. P. Martinich, Fourth, 221–27. Oxford University Press.

Väänäänen, Jouko. 2011. Models and Games. Vol. 132. Cambrdige Studies in Advanced Mathematics. Cambridge University Press.

Author: Richard Lawrence

Created: 2015-03-17 Tue 09:20

Emacs 24.4.91.1 (Org mode 8.3beta)

Validate