From: Richard Lawrence <richard.lawrence@berkeley.edu>
To: emacs-orgmode@gnu.org
Cc: Andreas Leha <andreas.leha@med.uni-goettingen.de>
Subject: Re: Citation syntax: a revised proposal
Date: Tue, 17 Mar 2015 09:26:42 -0700 [thread overview]
Message-ID: <87twxj1tfh.fsf@berkeley.edu> (raw)
In-Reply-To: olu4mpkm0sp.fsf@med.uni-goettingen.de
[-- Attachment #1: Type: text/plain, Size: 6040 bytes --]
Hi Andreas,
Andreas Leha <andreas.leha@med.uni-goettingen.de> 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
[-- Attachment #2: citetest.org --]
[-- Type: text/plain, Size: 467 bytes --]
#+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
[-- Attachment #3: citetest.txt --]
[-- Type: text/plain, Size: 826 bytes --]
___________________
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.
[-- Attachment #4: citetest.html --]
[-- Type: text/html, Size: 3512 bytes --]
next prev parent reply other threads:[~2015-03-17 16:27 UTC|newest]
Thread overview: 163+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-02-15 2:29 Citation syntax: a revised proposal Richard Lawrence
2015-02-15 2:45 ` Richard Lawrence
2015-02-15 3:57 ` Thomas S. Dye
2015-02-15 16:40 ` Richard Lawrence
2015-02-15 19:43 ` Thomas S. Dye
2015-02-16 3:34 ` Matt Price
2015-02-16 8:56 ` Nicolas Goaziou
2015-02-16 9:57 ` Rasmus
2015-02-17 17:18 ` Richard Lawrence
2015-02-17 18:11 ` Rasmus
2015-02-18 0:44 ` Matt Price
2015-02-18 3:38 ` Richard Lawrence
2015-02-18 2:24 ` Thomas S. Dye
2015-02-18 4:03 ` Richard Lawrence
2015-02-18 9:00 ` Stefan Nobis
2015-02-18 10:11 ` Eric S Fraga
2015-02-18 14:19 ` Nicolas Goaziou
2015-02-18 16:38 ` Richard Lawrence
2015-02-18 18:44 ` Samuel Wales
2015-02-18 18:46 ` Samuel Wales
2015-02-18 20:54 ` Aaron Ecay
2015-02-18 21:21 ` Samuel Wales
2015-02-18 21:24 ` John Kitchin
2015-02-18 19:42 ` Nicolas Goaziou
2015-02-18 20:47 ` Aaron Ecay
2015-02-18 22:43 ` Rasmus
2015-02-18 22:35 ` Rasmus
2015-02-19 17:06 ` Richard Lawrence
2015-02-20 0:10 ` Nicolas Goaziou
2015-02-20 16:44 ` Richard Lawrence
2015-02-20 19:45 ` Samuel Wales
2015-02-20 20:01 ` Rasmus
2015-02-20 22:33 ` Samuel Wales
2015-02-21 11:58 ` Rasmus
2015-02-21 17:25 ` Thomas S. Dye
2015-02-27 0:56 ` Samuel Wales
2015-02-27 8:55 ` Stefan Nobis
2015-02-27 9:56 ` Rasmus
2015-02-21 3:12 ` Richard Lawrence
2015-02-21 12:00 ` Rasmus
2015-02-21 20:19 ` Samuel Wales
2015-02-21 20:36 ` Samuel Wales
2015-02-25 13:59 ` Aaron Ecay
2015-02-25 16:57 ` Richard Lawrence
2015-02-25 22:37 ` Nicolas Goaziou
2015-02-26 5:10 ` Richard Lawrence
2015-03-01 20:35 ` Nicolas Goaziou
2015-03-01 21:31 ` Rasmus
2015-03-02 0:24 ` Thomas S. Dye
2015-03-02 8:57 ` Eric S Fraga
2015-03-02 1:37 ` Thomas S. Dye
2015-03-02 9:23 ` Rasmus
2015-03-02 19:11 ` Aaron Ecay
2015-03-02 20:15 ` Rasmus
2015-03-03 3:14 ` Richard Lawrence
2015-03-03 5:33 ` Avram Lyon
2015-03-03 17:27 ` Richard Lawrence
2015-03-03 17:56 ` Avram Lyon
2015-03-04 16:41 ` Richard Lawrence
2015-03-03 9:24 ` Rasmus
2015-03-03 9:39 ` Rasmus
2015-03-03 14:12 ` Aaron Ecay
2015-03-02 18:50 ` Richard Lawrence
2015-03-02 20:14 ` Nicolas Goaziou
2015-03-02 20:34 ` Rasmus
2015-03-02 22:17 ` Nicolas Goaziou
2015-03-02 22:33 ` Rasmus
2015-03-02 22:45 ` Nicolas Goaziou
2015-03-02 23:05 ` Rasmus
2015-03-02 23:27 ` Nicolas Goaziou
2015-03-02 23:42 ` Rasmus
2015-03-03 2:48 ` Richard Lawrence
2015-03-03 8:43 ` Nicolas Goaziou
2015-03-03 16:59 ` Richard Lawrence
2015-03-04 0:43 ` Matt Price
2015-03-08 0:16 ` Nicolas Goaziou
2015-03-03 14:23 ` Aaron Ecay
2015-03-02 18:54 ` Aaron Ecay
2015-03-02 20:26 ` Nicolas Goaziou
2015-03-03 2:53 ` Richard Lawrence
2015-03-03 8:38 ` Nicolas Goaziou
2015-03-03 9:13 ` Rasmus
2015-03-03 16:12 ` Richard Lawrence
2015-03-03 14:25 ` Aaron Ecay
2015-03-02 20:53 ` Rasmus
2015-03-03 14:57 ` Aaron Ecay
2015-03-03 15:41 ` Rasmus
2015-03-03 15:58 ` Ken Mankoff
2015-03-03 16:08 ` Rasmus
2015-03-03 17:13 ` Richard Lawrence
2015-03-10 3:44 ` Aaron Ecay
2015-03-10 9:49 ` Rasmus
2015-03-11 1:51 ` Aaron Ecay
2015-03-11 6:04 ` Thomas S. Dye
2015-03-10 16:31 ` Richard Lawrence
2015-03-11 2:21 ` Aaron Ecay
2015-03-11 17:33 ` Richard Lawrence
2015-03-13 18:13 ` Richard Lawrence
2015-03-17 5:15 ` Richard Lawrence
2015-03-17 9:27 ` Andreas Leha
2015-03-17 16:26 ` Richard Lawrence [this message]
2015-03-17 20:42 ` Andreas Leha
2015-03-17 21:34 ` Richard Lawrence
2015-03-18 1:12 ` Matt Price
2015-03-18 15:19 ` Richard Lawrence
2015-02-25 18:08 ` Thomas S. Dye
2015-02-26 21:30 ` Aaron Ecay
2015-02-26 23:50 ` Thomas S. Dye
2015-02-27 8:49 ` Stefan Nobis
2015-02-27 16:35 ` Richard Lawrence
2015-02-27 10:09 ` Rasmus
2015-03-02 5:48 ` Thomas S. Dye
2015-03-02 12:22 ` Aaron Ecay
2015-03-02 13:53 ` Thomas S. Dye
2015-03-02 19:02 ` Aaron Ecay
2015-02-20 5:27 ` Melanie Bacou
2015-02-20 16:49 ` Richard Lawrence
2015-02-24 7:08 ` Vaidheeswaran C
2015-02-25 4:29 ` Richard Lawrence
2015-02-25 5:57 ` Vaidheeswaran C
2015-02-15 11:17 ` Tory S. Anderson
2015-02-15 11:57 ` Rasmus
2015-02-15 17:05 ` Richard Lawrence
2015-02-16 8:53 ` Stefan Nobis
2015-02-16 17:52 ` Thomas S. Dye
2015-02-15 17:23 ` Nicolas Goaziou
2015-03-09 10:40 ` Sebastien Vauban
2015-03-09 10:50 ` Vaidheeswaran C
2015-02-15 17:19 ` Nicolas Goaziou
2015-02-15 17:37 ` Rasmus
2015-02-15 17:55 ` Nicolas Goaziou
2015-02-15 19:30 ` John Kitchin
2015-02-15 18:07 ` Richard Lawrence
2015-02-15 18:25 ` Nicolas Goaziou
2015-02-15 19:05 ` Aaron Ecay
2015-02-15 19:18 ` Nicolas Goaziou
2015-02-15 19:38 ` Aaron Ecay
2015-02-15 20:13 ` Nicolas Goaziou
2015-02-15 20:23 ` Rasmus
2015-02-16 9:07 ` Stefan Nobis
2015-02-16 16:59 ` Richard Lawrence
2015-02-16 17:43 ` Nicolas Goaziou
2015-02-16 18:39 ` Rasmus
2015-02-16 19:16 ` Thomas S. Dye
2015-02-16 19:40 ` Rasmus
2015-02-15 20:49 ` John Kitchin
2015-02-16 16:18 ` Richard Lawrence
2015-02-16 18:21 ` John Kitchin
2015-02-16 12:05 ` Eric S Fraga
2015-02-16 13:10 ` William Denton
2015-02-16 13:42 ` John Kitchin
2015-02-16 16:19 ` Nicolas Goaziou
2015-02-16 17:28 ` John Kitchin
2015-02-16 18:49 ` Rasmus
2015-02-16 19:16 ` John Kitchin
2015-02-23 7:26 ` Vaidheeswaran
2015-02-16 16:35 ` Jorge A. Alfaro-Murillo
2015-02-16 17:56 ` Stefan Nobis
2015-02-16 18:24 ` John Kitchin
2015-02-16 18:39 ` Jorge A. Alfaro-Murillo
2015-02-16 19:19 ` Jorge A. Alfaro-Murillo
2015-02-17 6:47 ` Stefan Nobis
2015-02-16 16:45 ` Richard Lawrence
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: https://www.orgmode.org/
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87twxj1tfh.fsf@berkeley.edu \
--to=richard.lawrence@berkeley.edu \
--cc=andreas.leha@med.uni-goettingen.de \
--cc=emacs-orgmode@gnu.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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).