From mboxrd@z Thu Jan 1 00:00:00 1970 From: Richard Lawrence Subject: Re: Citations, continued Date: Wed, 04 Feb 2015 08:45:20 -0800 Message-ID: <87mw4tk4m7.fsf@berkeley.edu> References: <87vbjmn6wy.fsf@berkeley.edu> <87sieokx8e.fsf@berkeley.edu> <54d04780.cb58460a.5243.2603@mx.google.com> <87h9v3li8t.fsf@berkeley.edu> <54d078ff.b044440a.06ec.3cf6@mx.google.com> <87d25rkmag.fsf@berkeley.edu> <54d1bc7b.c57d440a.3c5d.2dca@mx.google.com> <87vbjh284z.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:34697) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YJ35i-0004o8-GN for emacs-orgmode@gnu.org; Wed, 04 Feb 2015 11:46:15 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YJ35e-0002jp-JE for emacs-orgmode@gnu.org; Wed, 04 Feb 2015 11:46:14 -0500 Received: from plane.gmane.org ([80.91.229.3]:42656) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YJ35e-0002jd-C2 for emacs-orgmode@gnu.org; Wed, 04 Feb 2015 11:46:10 -0500 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1YJ35c-0001TW-4S for emacs-orgmode@gnu.org; Wed, 04 Feb 2015 17:46:08 +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 ; Wed, 04 Feb 2015 17:46:08 +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 ; Wed, 04 Feb 2015 17:46:08 +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 Hi Nicolas, Nicolas Goaziou writes: > Also, AFAIU, the syntax for valid citations is not defined explicitly so > far. For example, I don't think it was discussed if any subset of Org > objects (e.g., macros or bold text) is allowed in a citation. This is a good question that, as you say, deserves more discussion. I am not sure, but I am *thinking* that inline citations are objects (not elements) that can contain some other objects. Specifically I think we need the following categories, all of which would be objects: - key - prefix / pre-text - suffix / post-text - locator - individual citation - bracketed citation - unbracketed citation These should have a grammar like the following, based on my (reverse-engineered) understanding of the Pandoc syntax for citations: - A bracketed citation is a list of one or more individual citations, separated by ';' if there are two or more, and surrounded by '[' ']' - An individual citation is formatted like: PREFIX KEY LOCATOR SUFFIX The key is obligatory, and the prefix, locator and suffix are optional. - A key optionally begins with '-', and obligatorily contains '@' followed by a string of charcters which begins with a letter or '_', and may contain alphanumeric characters and the following internal punctuation characters: :.#$%&-+?<>~/ - A prefix or suffix is a text object (that may contain markup like emphasis or macros) - An unbracketed citation consists of a key, optionally followed by a locator which is enclosed in '[' ']' I am not sure about the syntax of locators. In particular, I do not know if they should allow internal markup, I do not know if they have an internal syntax, and I do not know if a comma is required to separate them from a key in a bracketed citation. Best, Richard