From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms11 with LMTPS id 8OyDIcA6lF4wXQAA0tVLHw (envelope-from ) for ; Mon, 13 Apr 2020 10:11:12 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id kEnPAcM6lF5XSgAA1q6Kng (envelope-from ) for ; Mon, 13 Apr 2020 10:11:15 +0000 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id F184C942C89 for ; Mon, 13 Apr 2020 10:11:12 +0000 (UTC) Received: from localhost ([::1]:42454 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jNw3c-0000ye-07 for larch@yhetil.org; Mon, 13 Apr 2020 06:11:12 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:53476) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jNw2z-0000wI-CG for emacs-orgmode@gnu.org; Mon, 13 Apr 2020 06:10:34 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jNw2y-00053N-5Y for emacs-orgmode@gnu.org; Mon, 13 Apr 2020 06:10:33 -0400 Received: from wout5-smtp.messagingengine.com ([64.147.123.21]:54515) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1jNw2x-00052F-OM for emacs-orgmode@gnu.org; Mon, 13 Apr 2020 06:10:32 -0400 Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.west.internal (Postfix) with ESMTP id 59B6E351 for ; Mon, 13 Apr 2020 06:10:29 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute1.internal (MEProxy); Mon, 13 Apr 2020 06:10:29 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.fm; h= references:from:to:subject:in-reply-to:date:message-id :mime-version:content-type; s=fm2; bh=otkkKWrr/nAR7x3bPlPzwKvo3S hH3LNxHobrp7xdUnc=; b=ZT/Gm+Eh/eqOgPtGnxXcXTNGzta4OhYv3nXkGrvyEH 5FNR4F3fHedo/yXRL+4nNGrJniD/02LP1v1F1mpIl++3WF0t+xao9Fpmv0wtqDHr d0XJf8OqQcA+drRfHmLJCNZRgUZ4p7roaDWY5hVpBQM2c9RvXKB1yMqOO5B78WNa aSNysqsFwIuRMjxE8O+HMInz+Af+p4xKJW15z1KorXFpaUm/vfA5Qj8xbFbfUU07 tQ9CX/YDfOLWJL9b6Oww+vznBImBHb5xG69GTjQbrRA1HhXNpQYMEP41Np3Va3s7 yiRpVUjDccW1ABJccBMYVCVLmfMQAMnyXRj4w4YK9vsA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm2; bh=otkkKW rr/nAR7x3bPlPzwKvo3ShH3LNxHobrp7xdUnc=; b=tY7QmMCbEPOp2L/2rXVrkQ 5P2V1ETPAAyb9+6pXHdbRpSIoccWMs+NZG6LRGQ23vQ3SAvi86ho+bAJxd5oP5Hb /GUWyiq6m1VNrN7Zrzss3ccFIbzYQNTPqrLvkGbPQ7zYiuvJMRWC6lZFPKT3J1Dc fmKiD2pDwctgTIAV1oY6khNGiVLxTfLYucugY5+MYvh+Q3RlfogCKhN5kykz6gU7 eMvVsEzoMbdW7OUHGQ2Pkr/eVS5EDNsjTz0Ei6FdnL0ewCf06Do5S7MqfCGB1opg 5lMBWbjuyuhVdNEBiEzYEjaLoKHPju3IID3xrXpgswvzeAZ6xuVq0BVoMgC3/5GQ == X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduhedrvdelgddvjecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhepfhgfhffvufgjfffkgggtsehttdertd dtredtnecuhfhrohhmpeflohhoshhtucfmrhgvmhgvrhhsuceojhhoohhsthhkrhgvmhgv rhhssehfrghsthhmrghilhdrfhhmqeenucffohhmrghinhepnhgrmhgvshdrohhrghenuc fkphepleehrdeltddrvddtuddriedvnecuvehluhhsthgvrhfuihiivgeptdenucfrrghr rghmpehmrghilhhfrhhomhepjhhoohhsthhkrhgvmhgvrhhssehfrghsthhmrghilhdrfh hm X-ME-Proxy: Received: from Lenovo.fastmail.com (ip5f5ac93e.dynamic.kabel-deutschland.de [95.90.201.62]) by mail.messagingengine.com (Postfix) with ESMTPA id 75DF53280060 for ; Mon, 13 Apr 2020 06:10:28 -0400 (EDT) References: <777184861.71192.1586510991834@office.mailbox.org> <87imi72bn0.fsf@nicolasgoaziou.fr> <1016821769.78551.1586641375789@office.mailbox.org> <87h7xp0z1y.fsf@nicolasgoaziou.fr> <874kto245n.fsf@nicolasgoaziou.fr> <87sgh8zpmg.fsf@nicolasgoaziou.fr> <1084456979.81820.1586724551265@office.mailbox.org> <877dykz6ri.fsf@nicolasgoaziou.fr> User-agent: mu4e 1.3.10; emacs 27.0.90 From: Joost Kremers To: emacs-orgmode@gnu.org Subject: Re: wip-cite status question and feedback In-reply-to: <877dykz6ri.fsf@nicolasgoaziou.fr> Date: Mon, 13 Apr 2020 12:10:25 +0200 Message-ID: <87r1wrwvam.fsf@fastmail.fm> MIME-Version: 1.0 Content-Type: text/plain; format=flowed X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 64.147.123.21 X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Scanner: scn0 X-Spam-Score: -1.71 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=fastmail.fm header.s=fm2 header.b=ZT/Gm+Eh; dkim=pass header.d=messagingengine.com header.s=fm2 header.b=tY7QmMCb; dmarc=pass (policy=none) header.from=fastmail.fm; spf=pass (aspmx1.migadu.com: domain of emacs-orgmode-bounces@gnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom=emacs-orgmode-bounces@gnu.org X-Scan-Result: default: False [-1.71 / 13.00]; RCVD_VIA_SMTP_AUTH(0.00)[]; GENERIC_REPUTATION(0.00)[-0.57735137104902]; R_SPF_ALLOW(-0.20)[+ip4:209.51.188.0/24:c]; FREEMAIL_FROM(0.00)[fastmail.fm]; TO_DN_NONE(0.00)[]; IP_REPUTATION_HAM(0.00)[asn: 22989(0.28), country: US(-0.01), ip: 209.51.188.17(-0.58)]; MX_GOOD(-0.50)[cached: eggs.gnu.org]; DKIM_TRACE(0.00)[fastmail.fm:+,messagingengine.com:+]; DMARC_POLICY_ALLOW(-0.50)[fastmail.fm,none]; MAILLIST(-0.20)[mailman]; FORGED_RECIPIENTS_MAILLIST(0.00)[]; MIME_TRACE(0.00)[0:+]; RCVD_TLS_LAST(0.00)[]; ASN(0.00)[asn:22989, ipnet:209.51.188.0/24, country:US]; MID_RHS_MATCH_FROM(0.00)[]; TAGGED_FROM(0.00)[larch=yhetil.org]; FROM_NEQ_ENVFROM(0.00)[joostkremers@fastmail.fm,emacs-orgmode-bounces@gnu.org]; ARC_NA(0.00)[]; R_DKIM_ALLOW(-0.20)[fastmail.fm:s=fm2,messagingengine.com:s=fm2]; FROM_HAS_DN(0.00)[]; MIME_GOOD(-0.10)[text/plain]; PREVIOUSLY_DELIVERED(0.00)[emacs-orgmode@gnu.org]; HAS_LIST_UNSUB(-0.01)[]; RCPT_COUNT_ONE(0.00)[1]; RCVD_COUNT_SEVEN(0.00)[8]; FORGED_SENDER_MAILLIST(0.00)[] X-TUID: ENbg4RU02XoA On Mon, Apr 13 2020, Nicolas Goaziou wrote: > denis.maier.lists@mailbox.org writes: >> What about allowing something more verbose? Perhaps >> "cite-intext:" or "cite:intext:"? [...] >> The simple syntax is great for most cases, but if you want to >> support >> some of those not so common biblatex commands, this might be >> better. > > Alphanumeric suffix provides 62 combinations, which should > hopefully be > enough for any citation back-end out there (I'm looking at you > biblatex). It's not terribly readable, tho, as you point out. 62 combinations might sound like a lot, but if you want your cite commands to be mnemonic, you'll run out of options much more quickly. > This is a conciseness versus readability problem, not a > technical one, > as long as we do not allow too much, from a parser point of > view. > > I have no strong opinion on the topic. It would be more valuable > to hear > from actual citations users. What would they prefer? Not sure if my opinion counts, given that I mainly use LaTeX + biblatex to write my texts, but I would definitely allow more than one character. The more common commands (=citep=, =citet=) can still use a single character (and thus remain concise), but for less common commands, the ability to have more descriptive names is to be preferred. Imagine looking at a document you wrote a few years back and having to figure out what =citeQ= or =cite7= was meant for again, or finding that =citeF= was changed from =\fullcite= to =\footfullcite= because at some point the developers figured the latter would be used more often. I don't think it's necessary to use a dash (or any other character) in longer cite commands, though. =citeintext= isn't that much more difficult to read than =cite-intext=. (Biblatex does just fine without dashes, and there's always camelCase if you're so inclined.) >> 1. For the bibliography: >> >> #+bibliography: something.bib >> (Could this be a list containing multiple files?) > > Multiple keywords may be more appropriate, particularly if you > need to > spell out absolute file names. > > Org can provide a function listing all of them anyway. Yes, and please make it a public (one-dash) function. :-) >> 2. Placing the bibliography with: >> >> #+bibliography: here >> (Ideally, it would be possible to have this multiple times, >> perhaps >> with some filters, like printing only the works of a certain >> author, >> or with certain keywords, or so. But that's, of course >> something for >> later...) > > It is smart, but I'm not sure I like using the same keyword for > two > different things. OTOH, I don't have a better idea. As someone already suggested, using something like =#+printbibliography:= would work. And if that is too biblatex-like, you could instead opt for e.g. =#+list-of-references:=. (Output formats such as HTML or epub don't involve any printing anyway, so... ;-) -- Joost Kremers Life has its moments