From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id QOsHDjWzOGJcqAAAgWs5BA (envelope-from ) for ; Mon, 21 Mar 2022 18:17:41 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id QD25CjWzOGIgSQAAauVa8A (envelope-from ) for ; Mon, 21 Mar 2022 18:17:41 +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 4B8E617079 for ; Mon, 21 Mar 2022 18:17:40 +0100 (CET) Received: from localhost ([::1]:48224 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nWLf1-0004mb-Dr for larch@yhetil.org; Mon, 21 Mar 2022 13:17:39 -0400 Received: from eggs.gnu.org ([209.51.188.92]:45746) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nWLe5-0004hI-1H for emacs-orgmode@gnu.org; Mon, 21 Mar 2022 13:16:41 -0400 Received: from [2607:f8b0:4864:20::732] (port=38566 helo=mail-qk1-x732.google.com) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nWLe1-0007Wq-Uk for emacs-orgmode@gnu.org; Mon, 21 Mar 2022 13:16:40 -0400 Received: by mail-qk1-x732.google.com with SMTP id q194so12158898qke.5 for ; Mon, 21 Mar 2022 10:16:37 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=sender:references:user-agent:from:to:cc:subject:date:in-reply-to :message-id:mime-version; bh=SZyJtV2TSXhTMtnMscpO7DobgvbbbvNYWcQzBIgiESQ=; b=TGRj1uJflxKlOOUDQf3142XJ2+NVi0ICPCXp4lsIg30TvtSrv/GnWdwY8BGciQCRBl OibLec27SWgHA1IRyclg3BmSz3HcESaeP4jbgOuJ9ienCqBFNvqKaT0kPLXM2whGgpN5 DxagngvN/KdquGYTIGN6BvAHHZtbj/ecuTTs3/0sEA0rQAlRMmxFdPSpKSNyEI1hcv4y D8Nrzjh8CaVqzQS4QLqnZZwUzKFAlG5JiPer1Mhgzylm6JvMYOe2/mXDU5OJXK08Mssx EQ9hEeUQKb6mgnOCZ3jIkU6Qni8aMnlVN+v0jDPV9zSxY6oefyh2eF1Y1Xlqf43nhyze kGIg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:sender:references:user-agent:from:to:cc:subject :date:in-reply-to:message-id:mime-version; bh=SZyJtV2TSXhTMtnMscpO7DobgvbbbvNYWcQzBIgiESQ=; b=d/stejWmlTvzYlfLMP8ggN+MYkzfWw2xBrZhXZcq49bScoiZXbkuobZjymaEYLCMio eqNDuzcqGwj6lk9E7MeKkYZyXABRsmimi08lSdkADvafBnL8BgMvsKVtRC2muER/VBsC PP50dbEXNSZ1oRqdu+bLMxtlomsnL6hgbCVkLNVSKqrdkcu+dHYL9Tw75FAL1nyWbny8 vLLEyg0QQG0/5nZu+/dhVHqzAbZjejSPLnEI4hVGFEi/v7wlWeQz1rXedYH5HoHK/vmJ O6UPy0OUBs/SXZ6e01ELOa2byI7dP7cBq5z0Ejg4rg75pRC6vRHLD08HvSEBFJ3RUQCW M7EQ== X-Gm-Message-State: AOAM532r9WRPYHT++eYUGT98Mu8b5pCLMWuXBQHE9y2pD4ggEq2pA4AX WkPS+Fpe9eUhDAM4Gpyd2rC8DqTVa2g= X-Google-Smtp-Source: ABdhPJxqTvvboKc1QWb33MH0zEr3wnUCkUB6ddzXmOqQSQc0V+lYjlAR8XVSFRBiIrT2XcMj12KstQ== X-Received: by 2002:a37:aa8d:0:b0:67e:5fe9:60ee with SMTP id t135-20020a37aa8d000000b0067e5fe960eemr8105330qke.73.1647882996109; Mon, 21 Mar 2022 10:16:36 -0700 (PDT) Received: from Johns-iMac.local ([2601:547:901:82e0:15dd:d6d8:2808:7987]) by smtp.gmail.com with ESMTPSA id w8-20020ac87e88000000b002e1cdc11203sm12134006qtj.18.2022.03.21.10.16.35 (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Mon, 21 Mar 2022 10:16:35 -0700 (PDT) References: <87wngosqvm.fsf@nicolasgoaziou.fr> User-agent: mu4e 1.6.10; emacs 28.0.90 From: John Kitchin To: Bruce D'Arcus Subject: Re: citations: org-cite vs org-ref 3.0 Date: Mon, 21 Mar 2022 13:00:11 -0400 In-reply-to: Message-ID: MIME-Version: 1.0 Content-Type: text/plain X-Host-Lookup-Failed: Reverse DNS lookup failed for 2607:f8b0:4864:20::732 (failed) Received-SPF: pass client-ip=2607:f8b0:4864:20::732; envelope-from=johnrkitchin@gmail.com; helo=mail-qk1-x732.google.com X-Spam_score_int: 0 X-Spam_score: -0.1 X-Spam_bar: / X-Spam_report: (-0.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FORGED_FROMDOMAIN=0.249, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.249, 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: Max Nikulin , emacs-orgmode@gnu.org 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=1647883061; 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=SZyJtV2TSXhTMtnMscpO7DobgvbbbvNYWcQzBIgiESQ=; b=XBARTlZy4PVuC3ZJXA+ri+AWmHzZJWUXhXAgCrs/dkJpxv1EfB9PrhuPdR+aN19LPE0loV EpjlV2MjAZrZuTNdYO3b8fkRJRpJ5qS0QkgfnCEYzPX5niOqhwjBltQxaQsKD1gtviiRD5 StLA7jeiDGcdjww80PDHGxMSMCXINVaEdYGwc17jtXfWR7uGPdmZfjRm2Wz3cVLLgLYHsv It++mLocVi7WbvOn778GHp1xPtJOZppIjhVfpw+HS2lrKWJN6RlLPbAQmAzo/ByHWsnrrl HL/kJcr/XRPWGjPJlSsbCYMPHlvjOi8MENxfnZRJotNVDMiEZqG+vds6io9VjQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1647883061; a=rsa-sha256; cv=none; b=P535U/9w8jYvyRXczGDYOhuAU877Aas1MTi1uQzhxNg1CMaBGHX/TZTQXLrabrQLWPa/Ka gX0DT901+BElPStLb4PssFie6OhVXywk3JMzxZHcIO9L/WJZ9gDpRv9XYEf2/Auom58Xrz iQBjXVGJe6n9OBUVM3q/67xCJnZe4jvgd4SqP7lASaBzBDLd2D9KBM5Yg90Afrr35E/oN4 YhS9CHGS/FufxcTDyKIxupIotGWq27QjG+DGYg5siRZ+TD8+rhbrna3QYwHDRAuzdK1XsL MKx8vdrR7OQQX7jUAhIr8rVdPRMbmPLBP1hYrjkVdSlSwdAHgQONpH0upd/8+w== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=TGRj1uJf; dmarc=fail reason="SPF not aligned (relaxed)" header.from=andrew.cmu.edu (policy=none); 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: 6.08 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20210112 header.b=TGRj1uJf; dmarc=fail reason="SPF not aligned (relaxed)" header.from=andrew.cmu.edu (policy=none); 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: 4B8E617079 X-Spam-Score: 6.08 X-Migadu-Scanner: scn1.migadu.com X-TUID: 3YPCs0Aqv3ye "Bruce D'Arcus" writes: > 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. > >> - improve documentation, e.g. to make backend choice more conscious. > > This is the bigger user-facing issue that could use attention. > >> Another point is more serious. Besides citations there are internal >> cross-references. Org supports them but only in a rudimentary form. > > Indeed, the question of how to better support cross-references in org > is an important one. > > I don't really use them much, and so am still unsure if this could be > addressed with incremental improvements in existing org link support, > or if it would require more significant enhancements. No incremental improvement is required IMO, regular links are sufficient. org-ref has handled these with regular links from the beginning. It even has an org-ref-refproc now for non-LaTeX exports that has some support for things like sorting, grouping and cleveref. You can find an example org file at https://github.com/jkitchin/org-ref/blob/master/examples/refproc.org, and see it in action at https://www.youtube.com/watch?v=rRR-5NSpKyE the video has some rough spots, but you can get the idea. You can support all kinds of things in these links (for example, I now support pre/post note text in the cite link paths), really anything you want to parse out of the path. > > Perhaps we need the community to itemize what the gaps and limitations > are there? > > > Bruce > >> Actually cross-references are similar to citations in the sense that >> they can have style, prefixes and suffixes, and their appearance depends >> on target properties. Another feature is grouping. However >> cross-references should not be handled by citation backends, they >> require different handlers. Unfortunately there is no way to define >> custom "citation" type e.g. "[ref:...]" in addition to "[cite:...]". >> >> I can not judge if uniform UI issues are really severe and if it would >> be convenient if depending on prefix argument either org-cite or org-ref >> command would be called for a citation or for a reference. >> >> Actually "[cite:...]" construct is a kind of link with additional >> flexibility missed for regular links. Anything besides target and >> description requires some workarounds. Usual approach is proliferation >> of link types. E.g. inline source blocks allows almost arbitrary extra >> parameters. Citation syntax is rather domain specific, it allows more >> than regular links, but for convenience the set of properties is fixed: >> style, prefixes, locators, suffixes. It is impossible to add extra one. >> >> To assign additional properties, info "(org) Links in HTML export" >> https://orgmode.org/manual/Links-in-HTML-export.html recommends usage of >> "#+ATTR_HTML", but such technique has several issues: >> - attributes becomes specific to the export backend >> - the same attributes are added to the enclosing paragraph >> https://linevi.ch/en/org-link-extra-attrs.html >> - a paragraph may have more than one link. >> It is possible to use link target similar to form values encoded into >> URI, but it hardly can be considered as convenient for editing. >> >> Custom citation types may alleviate the issue with cross-references. It >> would be great to have more flexible links with arbitrary properties >> (and it would allow to consider citations and cross-references as >> special cases of links), but it does not fit into the Org syntax. >> >> P.S. John has a valid complain but it hardly relates to the "cite vs. >> cross-reference" topic. When some package is not loaded and link type is >> undefined then the link becomes a fuzzy one leading to user confusion. >> >> -- Professor John Kitchin Doherty Hall A207F Department of Chemical Engineering Carnegie Mellon University Pittsburgh, PA 15213 412-268-7803 @johnkitchin http://kitchingroup.cheme.cmu.edu Pronouns: he/him/his