From: Richard Lawrence <richard.lawrence@berkeley.edu>
To: emacs-orgmode@gnu.org
Subject: Re: current status of citation syntax discussion
Date: Thu, 18 Jun 2015 08:26:50 -0700 [thread overview]
Message-ID: <87381pox51.fsf@berkeley.edu> (raw)
In-Reply-To: 87bngfa0un.fsf@gmx.us
Hi Rasmus and all,
Rasmus <rasmus@gmx.us> writes:
> Matt Price <moptop99@gmail.com> writes:
>
>> Am just wondering what the current status is of the work that was being
>> done earlier this year on improved citation support in org. Has an
>> official syntax been settled on?
>
> AFAIK: No. Some people wanted something like [cite/type: pre @key post].
> Some people wanted additional key-value support, something like
> [cite: pre @key post]{:key val}. Some people wanted @key
> to be able to contain arbitrary characters such as punctuation.
I just wanted to chime in about this. While Rasmus is right that we
didn't reach complete agreement on everything, it seemed to me that we
agreed on quite a lot. As Nicolas notes, the core of what we agreed on
has been implemented in Org syntax in the wip-cite branch. Consensus
seemed to be that we should hold off on adopting any standard syntax for
the points of disagreement Rasmus mentions until we have a greater sense
of what's needed, based on real-world use.
There has also been some work on implementing the semantics for the
citation syntax. Aaron Ecay wrote an org-cite library that uses
citeproc-java to process citations on export. His version is in the
wip-cite-awe branch. I believe (though I don't remember exactly) that
Aaron's version of org-cite doesn't support the full syntax in the
wip-cite branch yet.
I further modified Aaron's org-cite library to support the full syntax
and to do citation processing via pandoc-citeproc, rather than
citeproc-java. My version is in the wip-cite-org-citeproc branch,
available here:
https://github.com/wyleyr/org-mode
To use this code, you also need org-citeproc, a command-line wrapper
around pandoc-citeproc that the org-cite library talks to:
https://github.com/wyleyr/org-citeproc
I got this setup working pretty well with at least Chicago-like citation
styles. More work is needed to make org-citeproc work with footnote or
numeric styles.
Vaidheeswaran also added support for processing citations via JabRef.
His work is here:
http://repo.or.cz/w/org-mode/org-cv.git
I believe that at the moment, Vaidheeswaran's implementation is only
integrated with the ODT exporter, though I am not sure.
AFAIK, that's the state of things. I personally haven't had much time
for hacking on org-cite or org-citeproc, though I hope to get back to it
in a couple of weeks. To be honest, I have been a bit reluctant to
press on with it because at least some people (Aaron, Rasmus) seem to
feel pretty strongly that they don't want Org citation processing to
depend on a Haskell-based tool.
That's fine, but it means we need an alternative. The main non-Haskell
contenders for CSL processing are citeproc-java and citeproc-js. So, if
that's the way we want to go, someone needs to write the equivalent of
org-citeproc for one of these libraries: a wrapper around them that
allows the org-cite library to make use of them during export.
(Unfortunately, that means I am not the man for the job. I don't know
Java or JavaScript, and I am not really interested in learning them just
for the sake of this project.)
I hope I haven't missed anything; those are my impressions of where
we're at!
Best,
Richard
prev parent reply other threads:[~2015-06-18 15:27 UTC|newest]
Thread overview: 8+ messages / expand[flat|nested] mbox.gz Atom feed top
2015-06-15 19:08 current status of citation syntax discussion Matt Price
2015-06-16 19:51 ` Rasmus
[not found] ` <CAN_Dec9TP8BR+ZhF+4GQiDuT+KcotSeiybQ+Bx8Y36=JeaqQNg@mail.gmail.com>
[not found] ` <CAN_Dec_w89fLBLraXLBLju3pxsJtDsBwJvp63mxFi1=jxAawaw@mail.gmail.com>
2015-06-16 20:18 ` Matt Price
2015-06-16 20:29 ` Rasmus
2015-06-16 20:43 ` Nicolas Goaziou
2015-08-18 7:53 ` Joseph Vidal-Rosset
2015-08-18 14:38 ` Joseph Vidal-Rosset
2015-06-18 15:26 ` Richard Lawrence [this message]
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=87381pox51.fsf@berkeley.edu \
--to=richard.lawrence@berkeley.edu \
--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).