From mboxrd@z Thu Jan 1 00:00:00 1970 From: Richard Lawrence Subject: Re: Citation syntax: a revised proposal Date: Tue, 17 Mar 2015 09:26:42 -0700 Message-ID: <87twxj1tfh.fsf@berkeley.edu> References: <87k2zjnc0e.fsf@berkeley.edu> <87ioezooi2.fsf@berkeley.edu> <87mw4bpaiu.fsf@nicolasgoaziou.fr> <8761aznpiq.fsf@berkeley.edu> <87twyjnh0r.fsf@nicolasgoaziou.fr> <87oaopx24e.fsf@berkeley.edu> <87k2zd4f3w.fsf@nicolasgoaziou.fr> <87egpkv8g9.fsf@berkeley.edu> <877fv6xfaq.fsf@gmail.com> <87twya2ak0.fsf@berkeley.edu> <87zj81aa97.fsf@nicolasgoaziou.fr> <87ioep2r6p.fsf@berkeley.edu> <87y4ngbgm7.fsf@nicolasgoaziou.fr> <87bnkbi61v.fsf@gmail.com> <87a8zlmujp.fsf@gmail.com> <87ioe8yftp.fsf@berkeley.edu> <871tkwmh87.fsf@gmail.com> <87sidb8mm7.fsf@berkeley.edu> <87lhj07ol0.fsf@berkeley.edu> <87y4mw19yj.fsf@berkeley.edu> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:46144) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YXuLE-00088u-Ky for emacs-orgmode@gnu.org; Tue, 17 Mar 2015 12:27:42 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YXuL9-0001pm-J2 for emacs-orgmode@gnu.org; Tue, 17 Mar 2015 12:27:40 -0400 Received: from plane.gmane.org ([80.91.229.3]:38980) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YXuL9-0001pa-6X for emacs-orgmode@gnu.org; Tue, 17 Mar 2015 12:27:35 -0400 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1YXuL2-0001LR-Vs for emacs-orgmode@gnu.org; Tue, 17 Mar 2015 17:27:29 +0100 Received: from c-67-169-117-151.hsd1.ca.comcast.net ([67.169.117.151]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 17 Mar 2015 17:27:28 +0100 Received: from richard.lawrence by c-67-169-117-151.hsd1.ca.comcast.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Tue, 17 Mar 2015 17:27:28 +0100 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Cc: Andreas Leha --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Hi Andreas, Andreas Leha 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

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 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 --=-=-= Content-Disposition: attachment; filename=citetest.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 --=-=-= Content-Type: text/plain; charset=utf-8 Content-Disposition: attachment; filename=citetest.txt Content-Transfer-Encoding: 8bit ___________________ ORG-CITEPROC TEST Richard Lawrence ___________________ 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. --=-=-= Content-Type: text/html; charset=utf-8 Content-Disposition: attachment; filename=citetest.html Content-Transfer-Encoding: 8bit Org-Citeproc Test

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

--=-=-=--