From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id EG5QCaAFOmKvxwAAgWs5BA (envelope-from ) for ; Tue, 22 Mar 2022 18:21:36 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id SLq7BaAFOmJu1gAAauVa8A (envelope-from ) for ; Tue, 22 Mar 2022 18:21:36 +0100 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 02BB81D6BF for ; Tue, 22 Mar 2022 18:21:34 +0100 (CET) Received: from localhost ([::1]:58310 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nWiCL-0004JB-8z for larch@yhetil.org; Tue, 22 Mar 2022 13:21:33 -0400 Received: from eggs.gnu.org ([209.51.188.92]:37552) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nWiBW-0004HG-PO for emacs-orgmode@gnu.org; Tue, 22 Mar 2022 13:20:43 -0400 Received: from [2a00:1450:4864:20::32f] (port=45610 helo=mail-wm1-x32f.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nWiBU-0001Sq-Tr for emacs-orgmode@gnu.org; Tue, 22 Mar 2022 13:20:42 -0400 Received: by mail-wm1-x32f.google.com with SMTP id 123-20020a1c1981000000b0038b3616a71aso2371383wmz.4 for ; Tue, 22 Mar 2022 10:20:39 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=nt0QyuKFRzWGP6Q+FTisG8ma0becsSymIsK2t+Q3SBM=; b=k+xnEYA0W8Cwy0zRNs3i4Lk5bnJAStzPrR9JpNEFxH9OCk1vkGFkrysZ2O76xbHypa 2juf8wciuvIOF0JnMFiU7a+KM58WdapqeOdWZJ/IseoXjQxdQPLhPon32wduV4DcAijf yc3H/8aCIZqZ0iLLKjoiAcJ6Q+gHbs1vvT53/dv+zbPHDZ57TCoDfwmbYx0cGbtVY3uf Uues6u61cefP8DIy0Thdi1jNnAxHBsM9y0L5dLAwncza/RLl8vLNrip16wPAsAtitFA7 jkLFT0OBvK39GapUvS7Iroosf+7iPDmdghYSwXDbMU3Lhyase0gypMRz9U5PrOf0OwQg bi6g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=nt0QyuKFRzWGP6Q+FTisG8ma0becsSymIsK2t+Q3SBM=; b=hcfqsG57vVOpher63m3KKhpf/bCWtmnOfd50RuDSwaoC4VnQc7ItGUVuj98JRx85Rp YklBHSaLb4rmeDY1VNhCpoB8i4oZBGZshVAr57RUAmi62CqgpedNcZ0w5QpbQIfAQxuI OosoRf5wwc3NCCEG4mjMAypkEkU+K+XcEPCmU1poITsLs7BGHNZ2AYwCXoFEdBWG6gyS bIShMqEM8yoKuflKH/w4/VzivcC0Blr6LLW52AgbC9vOjqwPVWPDHUUDhYmHlHOWVDSw owB1L4MVF505Fl6eBy7p5iy9qLY1G8dNrk8EG/1VngvJRjhCCcVvJj/yCDMwZ+SZqT4j FNEA== X-Gm-Message-State: AOAM532ORSJrzTMuNDUim3+VUackfe56Z9qFGy6JNp+9lVbPIoIvYjK3 9JGiP43h7shj0BciTRMicrz6LDsUEaen9rCW7td7+hgp X-Google-Smtp-Source: ABdhPJxgHYsMv22V4k2jReJWxgULE2WXwRIC7cWafieO8OEKOkDzvYw24ZDrW3UiTo/01CxPSXnpeV5rypnhgwF5bp4= X-Received: by 2002:a1c:c907:0:b0:37b:f983:5d4e with SMTP id f7-20020a1cc907000000b0037bf9835d4emr4838678wmb.174.1647969637877; Tue, 22 Mar 2022 10:20:37 -0700 (PDT) MIME-Version: 1.0 References: <87wngosqvm.fsf@nicolasgoaziou.fr> In-Reply-To: From: "Bruce D'Arcus" Date: Tue, 22 Mar 2022 13:20:56 -0400 Message-ID: Subject: Re: citations: org-cite vs org-ref 3.0 To: Max Nikulin Content-Type: text/plain; charset="UTF-8" X-Host-Lookup-Failed: Reverse DNS lookup failed for 2a00:1450:4864:20::32f (failed) Received-SPF: pass client-ip=2a00:1450:4864:20::32f; envelope-from=bdarcus@gmail.com; helo=mail-wm1-x32f.google.com X-Spam_score_int: -6 X-Spam_score: -0.7 X-Spam_bar: / X-Spam_report: (-0.7 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, PDS_HP_HELO_NORDNS=0.659, RCVD_IN_DNSWL_NONE=-0.0001, RDNS_NONE=0.793, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: org-mode-email Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: "Emacs-orgmode" X-Migadu-Flow: FLOW_IN X-Migadu-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1647969695; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=nt0QyuKFRzWGP6Q+FTisG8ma0becsSymIsK2t+Q3SBM=; b=q5jLq84K8N2Lbn+9vBDSh0GpeHbjrp52d3/HRvmXyBz9sCkXSiZNkvpSgA8FWYI+36jyr1 KglKdtdUFzI+IK3sO1Ftb2+xxrQwsVKf3KHHWJh2srcjq93MG/Xc1b5EXhyZE5FFWEZe2y ViBV1oPLOPPBV4W80hVoGFDbpD9tZ8RoOm19t7FvgH1mx8rlM3k6reLJM7WfrU/b9CD1u3 anvwwXuE663FudW3rS0vqZVwuTdK2Qliwd2fv7p56AjD9Qu284nEUV9zAcr7AFaBF78e3F okruJyb8wafPccLLm3tiAdpasCdsDq8JTWoTZ/Wu7KnWMoq1tEjxcvTe+koN6Q== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1647969695; a=rsa-sha256; cv=none; b=or2JmJjvnYRwLa7p9PDp2jqlnXOmTIwmq8QKSeiCjfbysD0gutjY37k0CcBUZZlcaPyDIC yGSe21/YgHPTPKrWhQeThhNlJgYw4YEUTyOxxFZWCCrSwplwLtNeS1WVLPl+FLSKGtDVdX z/81dAEcAgXUc3iO5Xil1RL0xwp4vf+ViqP9oE6CYW9cOPWvbtlO3woPsBVGJTZkWLV22c lYvzx1NoXOj9wxvJHmrc5TS66l+ZfdbItoOxAJ7IovYbZo7iiXKEuIeicurxMjYXZISn9U VmhBEfjS6DZ63+zEjj+y1pT7eAFSxLt8NWJW393rZ6aRjYG/4VceWNUGTZTMZg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=k+xnEYA0; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -8.91 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20210112 header.b=k+xnEYA0; dmarc=pass (policy=none) header.from=gmail.com; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 02BB81D6BF X-Spam-Score: -8.91 X-Migadu-Scanner: scn0.migadu.com X-TUID: M3dgSIy+ocPX On Tue, Mar 22, 2022 at 10:42 AM Max Nikulin wrote: > > On 21/03/2022 22:19, Bruce D'Arcus wrote: > > On Mon, Mar 21, 2022 at 10:41 AM Max Nikulin wrote: > > > >> A bit of routine work will alleviate some user issues: > >> - add missed styles > > > > The initial list of style-command mappings was pretty comprehensive, > > but we left out some of the more obscure biblatex commands because > > unsure if they were needed, or how best to add them (conceptually > > there's a mix of different kinds of commands in biblatex, which are > > hard to fit into a more general style system, for example). > > > > Since then: > > > > - people have occasionally asked to add new mappings, and Nicolas has added them > > - he's also added the styles defcustoms for biblatex, so users can do > > this themselves > > > > In short, I think we're good on this actually. > > John Kitchin, this thread, Sun, 20 Mar 2022 20:31:29 -0400. > https://list.orgmode.org/m2sfrc149c.fsf@andrew.cmu.edu: > > > I don't know the equivalent of \citenum in CSL. Right; so John or someone else should send a message to the list requesting it specifically? That's how we've done it so far anyway. Not sure what the practical alternative is. I will say that much of this discussion is not about org-cite per se, but rather implementation decisions in the specific bundled processors. I fear these conversations get hard to track if we aren't precise about what we're talking about; citation syntax, included processor functionality or style mappings, documentation, etc. > From my point of view it may be a reason to add a new style to > defaults. It is important whether a tool works out of the box. But the question here becomes "works for whom?" Citations practices vary a fair bit by field. Primarily LaTeX/natbib users like John and other science folks, biblatex users primarily coming from the humanities as near as I can tell? Or people coming from markdown and pandoc (which has an excellent citation system that clearly inspired org-cite) and needing Word-ready documents for journals etc? The style system in the bundled processors is designed to work for all of them, and not privilege one or another. It does this by creating a new, more general, org-cite style and variant system, which then maps to different targets. That approach has obvious advantages: citations are (mostly) decoupled from particular export processors. One can write a document with these styles, and get PDF citation and bibliographic output via biblatex, for example, similar to the HTML or ODT output from the CSL export processor. And that also has advantages beyond org. For example, pandoc recently added support for org-cite, and that includes mapping between the two style/command systems. So in theory you could convert an org file to docx, letting pandoc process the citations along the way, and the result would more than acceptable. > Custom variables make a document less portable unless they are specified as > file-local ones. Indeed! Or more specifically here, it ties the citations to the export processor. But maybe for some or many people that's perfectly fine. One possible idea to consider is to allow two systems in each of LaTeX-oriented processors: what we might call a default "org-cite" one, and an optional "literal" one. So if you only use oc-natbib, and you want the natbib commands directly, you might change a variable to get that. I really don't know if that's a good idea or not, but I raise it to emphasize there's a lot of flexibility with the org-cite design, and so it's just a question of how we make use of it. > I think, the goal may be formulated as "John can not > say the following any more" (at least in respect to citations leaving > aside cross-references): > > > I simply cannot > > compromise on the capability org-ref provides me, or wait for an > > alternative complete solution in org-mode. I don't really see why these are the two choices. > On the other hand I do not consider the following argument as a strong one > > > I do not like the abstraction away from LaTeX cite commands in org-cite. > > This is an example of a compromise between LaTeX and CSL. > > despite I believe that convenience and habits are important. Mapping of > styles to commands is just a piece of knowledge. Yes. > I have no particular opinion if enough efforts should be invested from > both sides to allow mixing on both citation syntax constructs (org-cite > and org-ref) in the same document. Bruce, you made a lot for support of > CSL in org-cite, so I will stressed another direction of feature > comparison since Bib(La)TeX users should feel themselves first-class > citizens. Absolutely! In fact, Denis Meier, who has extensive biblatex knowledge, helped a lot with the initial mapping there, and some other biblatex users have contributed feedback along the way. Bruce > The choice between org-ref and org-cite, when the former can do its job, > should be matter of taste and personal preferences unrelated to > technical limitations. > >