emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: "András Simonyi" <andras.simonyi@gmail.com>
To: emacs-orgmode@gnu.org
Subject: Re: Org citations, CSL and citeproc-el
Date: Sun, 07 Jan 2018 12:15:34 +0100	[thread overview]
Message-ID: <87k1wtor6x.fsf@gmail.com> (raw)
In-Reply-To: <87fu7k45a8.fsf@aquinas.i-did-not-set--mail-host-address--so-tickle-me>

Dear All,

thanks a lot for the helpful responses!

Richard Lawrence <richard.lawrence@berkeley.edu> wrote:
> I don't know if you are aware, but we had discussed the possibility
  > of building something like this on the list a few years back. [...]
  > And here is how I summarized the state of that discussion in June:
  > https://lists.gnu.org/archive/html/emacs-orgmode/2015-06/msg00426.html
  > The upshot was that we came to agreement on quite a few points about what
  > citation syntax should look like, and those points have been implemented in Org
  > syntax in the wip-cite branch of the Org repo.

I found some of the discussion, but not your summary and the
cite-related branches -- these are very useful.

  > 1) BibLaTeX support.
  > 2) org-bibtex support.

I'll have to look into BibLaTeX more but I suspect that both of these
should be doable relatively easily on the basis of the already existing
(albeit by no means complete) BibTeX support in citeproc-el. I'll create
corresponding enhancement issues in the github repo. A related thought:
was there any initiative to create something like org-bibtex but for CSL
bibliography descriptions? It could be an interesting alternative to
citeproc-YAML (see
http://blog.martinfenner.org/2013/07/30/citeproc-yaml-for-bibliographies/).

I've checked the citation/cite syntax in the wip-cite branch and it
seems to be a good starting point for trying to use citeproc-el to
render the citations. As a first step I could simply abstract away the
syntax and add a switch in citeproc-orgref to choose between the org-ref
and the the org-mode citation syntax (as it is in the wip-cite branch),
without touching other parts of the code. Currently citation rendering
is done (following org-ref's citeproc) by means of the
`org-export-before-parsing-hook' -- all citations are replaced with
their rendered versions before parsing. I'm not familiar enough with
org-mode's internals to assess how hackish this solution is, maybe there
is a much better way. One thing to consider is that I need all citations
together with their positional information (order, footnote number etc.)
for rendering in order to deal with disambiguation, ibid. forms etc.

Another question is the syntax for specifying the bibliography to be
used and, maybe, the location where the bibliography should be placed.
Org-ref (ab)uses links for these purposes as well. Was there a syntax
proposal for these things too?

Christian Moe <mail@christianmoe.com> wrote:
  > Not many people liked my proposal: a link-based syntax similar to yours
  > but also including author and date in the link description. The idea was
  > to have descriptions that are both (1) human-readable even though the
  > citekeys are hidden away in the link path and (2) machine-readable to
  > determine the form of the citation (parenthetical or not, date-only or
  > not, etc.).

This is an interesting proposal -- I like the idea of human readable
citations in the unexported org-mode documents but I'm not sure what
would be the best way to achieve them. citeproc-el can render isolated
references on the fly so they could be perhaps used as tool-tips or
overlays? Another difficulty I see is the generation of this added
information -- would it be automatic? What happens if the author or the
year is missing, or is ambiguous etc. If I could get hold of your parser
then perhaps this could also be added as an alternative citation syntax
in citeproc-orgref. Another option could be to normalize the keys to a
disambiguated author-year format, but this would modify the bibliography
file which is not necessarily a good idea...

thanks again and best regards,

András

  parent reply	other threads:[~2018-01-07 11:15 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2018-01-05 15:06 Org citations, CSL and citeproc-el Simonyi András
2018-01-05 16:52 ` Richard Lawrence
2018-01-05 17:02   ` Tory S. Anderson
2018-01-05 17:53   ` Eric S Fraga
2018-01-05 21:57   ` Nicolas Goaziou
2018-01-07 11:15   ` András Simonyi [this message]
2018-01-10 23:53     ` Richard Lawrence
2018-01-05 17:02 ` Christian Moe

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=87k1wtor6x.fsf@gmail.com \
    --to=andras.simonyi@gmail.com \
    --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).