From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: Citation syntax: a revised proposal Date: Sun, 15 Feb 2015 18:55:34 +0100 Message-ID: <87k2zjjbzd.fsf@nicolasgoaziou.fr> References: <87k2zjnc0e.fsf@berkeley.edu> <87zj8fjdnv.fsf@nicolasgoaziou.fr> <87twynjctj.fsf@gmx.us> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:58897) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YN3Op-0006BE-Hx for emacs-orgmode@gnu.org; Sun, 15 Feb 2015 12:54:36 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1YN3Ok-00077H-Ma for emacs-orgmode@gnu.org; Sun, 15 Feb 2015 12:54:31 -0500 Received: from relay6-d.mail.gandi.net ([2001:4b98:c:538::198]:46236) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1YN3Ok-000778-Gj for emacs-orgmode@gnu.org; Sun, 15 Feb 2015 12:54:26 -0500 In-Reply-To: <87twynjctj.fsf@gmx.us> (rasmus@gmx.us's message of "Sun, 15 Feb 2015 18:37:28 +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: Rasmus Cc: emacs-orgmode@gnu.org Rasmus writes: > Nicolas Goaziou writes: >> I think it would be nicer to differentiate between in-text and >> parenthetical citations at the type level, e.g.: >> >> >> [cite: this @key citation is in-text] >> [(cite): this @key citation is parenthetical] >> >> or, as already suggested >> >> [citet: ...] >> [citep: ...] >> >> I prefer the former. > > I prefer the latter. OK. > It's explicit, No, sir. (cite) is explicit. It means "a citation enclosed within parenthesis". citep is only explicit if you come from LaTeX world. > shorter cite and (cite) have the same mean length! > and doesn't hitting shift for '()' (on my kb). OK. "Rasmus' keyboard" (aka. a Rk) is a decent unit of measurement for syntax quality, I guess. ;) > No voodoo. I don't mind either, though. What colour are voodoo sheds these days? >> As pointed out, this is very odd. But I cannot see any clean solution. >> However, it would be nice to integrate it somehow with the syntax. Maybe >> something like >> >> [cite: ... @key ...; ... @key2 ... |latex: :prop val |html: :prop val] > > I prefer to have more expressive keys, e.g. the 'cite' part. Please don't touch (too much) the "cite" part. This is for Org, not for export back-ends. > But perhaps it's a good way express extra properties. The thing is, > for latex the extra property is a citation type. Then [cite: ... |latex: :type citedwim] How many "Rk" does this score? >> AFAIU, when using in-text citation, only the first key is extracted >> out of the parenthesis, so >> >> [cite: @Doe99 p. 34; see also @DoeRoe2000] >> >> should really render like >> >> Doe (1999, p. 34; see also Doe and Roe 2000). >> >> IOW, why do you think that "a citation is in-text or parenthetical as >> a whole"? > > No! I believe (but correct me if I'm wrong) that neither John, Eric, Tom > nor myself have seen a citation like this in the wild. If you have I > might be wrong. It's no easily supported in latex. The latex equivalent > of the above is: > > \citeauthor{doe} (\citeyear[p.\ 34]{doe}; see also \textcite*{roe}) > > Or something like that. > > AFAIK,=20 > [cite: @Doe99 p. 34; see also @DoeRoe2000] > =E2=86=92 Doe (1999, p. 34) and see also Doe et al (2000) > or maybe > Doe (1999, p. 34) and Doe et al (see also 2000). > > I don't remember. OK. Then let's forget about my remark. Regards,