From: Aaron Ecay <aaronecay@gmail.com>
To: Nicolas Goaziou <mail@nicolasgoaziou.fr>,
Richard Lawrence <richard.lawrence@berkeley.edu>
Cc: emacs-orgmode@gnu.org
Subject: Re: Citation syntax: a revised proposal
Date: Tue, 10 Mar 2015 00:44:45 -0300 [thread overview]
Message-ID: <87a8zlmujp.fsf@gmail.com> (raw)
In-Reply-To: <87bnkbi61v.fsf@gmail.com>
[-- Attachment #1: Type: text/plain, Size: 4009 bytes --]
Hello all,
I’ve pushed an update to my branch. The major change is to use
citeproc-java for the generation of the bibliography and the parsing of
names. The former is straightforward. For the latter, I have created a
CSL file which outputs author-year citations in an easy-to-parse format.
These are then slurped by org, and used to fill in printf-style
templates. Some people mentioned using citations as generated by
citeproc-java directly. However, I don’t believe this is reliable since
(as also mentioned), it is difficult to control whether a certain style
uses parentheses around a citation or not, whether the citation is
capitalized*, the insertion of prefixes/suffixes within the parentheses,
etc. So I think the only solution is to implement the formatting of the
in-text portion of citations ourselves, and use citeproc-java only to
extract authors and years.
* NB neither my branch nor the parser currently handles capitalized
citations either.
Using citeproc gives us for free sophisticated disambiguation of authors
that share a last name (by adding first initial) or works by the same
author in the same year (by adding a letter suffix to the year).
My code still does not implement numeric or footnote citations.
It’s hard to keep straight all of the traffic in citation-related
threads. I’ll try to respond to what I see as the major points raised,
but I apologize if I inadvertently skip something.
Some people have talked about supporting other CSL processors. I don’t
see much utility in that, since CSL is a standard that all processors
should implement faithfully. I judge the java implementation to be the
most complete and cross-platform. With respect to Zotero, it is possible,
through the “lookup” facility I’ve implemented, to implement fetching of
bibliography data from Zotero. I merely do not want to talk to Zotero (or
other tools) for the *formatting* of the data.
Rasmus <http://mid.gmane.org/87r3sxubgl.fsf@gmx.us> writes about the
insertion of punctuation by biblatex. I’ve noticed it too, and it’s a
thorny problem. Perhaps the best and easiest solution is to say that
org-latex documents must do \renewcommand{\postnotedelim}{} in their
preamble. (Thanks also to Rasmus for discussion of points I raised in
previous mails about reftex and org syntax. I have no specific reply
but the responses were all extremely helpful. I haven’t had time to act
on any of them because I’ve been concentrating on citeproc support.)
I haven’t updated the branch to the new multicitation syntax yet, but
thanks as always to Nicolas for working on it. I think that is next on
my list, along with getting biblatex support completely ironed out.
I have not had much time to study Vaidheeswaran’s jabref integration
code. In any case I would be hesitant to do so until there is
confirmation of the code’s copyright status, since he(?) sometimes posts
to the mailing list using an email address belonging to Jambunathan,
who at some points in the past was not willing to provide copyright
assignment. However, it would be good to know:
1. Is any important functionality lost by using citeproc-java as the CSL
processor, rather than jabref?
2. Is it possible to support for implement importing citations from
jabref through the “lookup types” facility in my code?
3. How are citations formatted for export to ODT? An example of the
ODT/XML code for something like “as demonstrated by Smith (2015)”,
where “Smith (2015)” has whatever fancy formatting a citation is
expected to have in ODT, would be helpful.
I’m sorry that I do not have enough time to both work on the code and
participate very much in the discussion. But reading it has been quite
helpful to me in creating the code, so thank you all.
Finally, the attachments demonstrate the output from ascii export of a
sample document + bibliography (in org-bibtex format).
[-- Attachment #2: doc.txt --]
[-- Type: text/plain, Size: 736 bytes --]
Aaron Ecay
1 Section one
=============
Here is a citation (Smith 2015) .
Here is another with parens J. Doe (2016b).
Here is one with a prefix and suffix (see Smith 2015 and other such
works).
Here is one with a prefix and suffix and parens see Smith (2015 and
other such works).
Here’s a citation to demonstrate the disambiguation of names: (B. Doe
2016) .
And the disambiguation of years: (J. Doe 2016a) .
2 Bibliography
==============
Currently the bibliography keyword doesn’t create its own section.
- Doe, Bill. 2016. “Work Three.”
- Doe, Jane. 2016a. “Work Two Bis.”
- ———. 2016b. “Work Two.”
- Smith, John. 2015. “Work One.”
[-- Attachment #3: doc.org --]
[-- Type: application/vnd.lotus-organizer, Size: 595 bytes --]
[-- Attachment #4: bib.org --]
[-- Type: application/vnd.lotus-organizer, Size: 526 bytes --]
[-- Attachment #5: Type: text/plain, Size: 15 bytes --]
--
Aaron Ecay
next prev parent reply other threads:[~2015-03-10 3:45 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 [this message]
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
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=87a8zlmujp.fsf@gmail.com \
--to=aaronecay@gmail.com \
--cc=emacs-orgmode@gnu.org \
--cc=mail@nicolasgoaziou.fr \
--cc=richard.lawrence@berkeley.edu \
/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).