From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id wDeJBqBh5mDrBQEAgWs5BA (envelope-from ) for ; Thu, 08 Jul 2021 04:23:28 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id kKM9AqBh5mAfWQAA1q6Kng (envelope-from ) for ; Thu, 08 Jul 2021 02:23:28 +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 351A220984 for ; Thu, 8 Jul 2021 04:23:27 +0200 (CEST) Received: from localhost ([::1]:58190 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1m1JhF-0003U6-HE for larch@yhetil.org; Wed, 07 Jul 2021 22:23:25 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:51454) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1m1Jgs-0003Tv-HT for emacs-orgmode@gnu.org; Wed, 07 Jul 2021 22:23:02 -0400 Received: from gateway31.websitewelcome.com ([192.185.143.47]:19563) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1m1Jgq-0001tF-Iw for emacs-orgmode@gnu.org; Wed, 07 Jul 2021 22:23:02 -0400 Received: from cm11.websitewelcome.com (cm11.websitewelcome.com [100.42.49.5]) by gateway31.websitewelcome.com (Postfix) with ESMTP id 6204A6E2F for ; Wed, 7 Jul 2021 21:12:49 -0500 (CDT) Received: from box2035.bluehost.com ([74.220.219.237]) by cmsmtp with SMTP id 1JWzmHucjK61i1JWzmgMpJ; Wed, 07 Jul 2021 21:12:49 -0500 X-Authority-Reason: nr=8 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=tsdye.online; s=default; h=Content-Transfer-Encoding:Content-Type: MIME-Version:Message-ID:Date:In-reply-to:Subject:To:From:References:Sender: Reply-To:Cc:Content-ID:Content-Description:Resent-Date:Resent-From: Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help: List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=ne2wuBTuzO44cuuqkJdfvYLyBddoEPHCGoeXDZLNVuw=; b=ynsbs8gkRH4XPhv4G41PEeIMHT R5DhUpjWc24btLimhwUC3N87aZoVWQFbOsOmb89gZxEtbxLeRNXeq4XUToknSS34Os6b0T77tPTYs JWPYpUfHjrn0f0Na6nSt2WUqJAIZLz7pSGq32/7Zg7O9N8FYZLEssSiRtcjB9v9Z73zoiTYgxymaR KKFWUtrwKwwS7HpU6TymB57eU/KyHVhjm+HgXNREiz+hdlpJ1Xx/B+/63SUil2MYjPTz2Wy6hO/ip 2lkN26aqvLkDPUeYFYkuDeSj40k1P4flvtXzpZ8FkCgJ5U86I/yscpKAU7UUgaok1KsnTET632O+4 resrQKIA==; Received: from cpe-50-113-36-248.hawaii.res.rr.com ([50.113.36.248]:55470 helo=poto-foou.tsdye.online) by box2035.bluehost.com with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.94.2) (envelope-from ) id 1m1JWy-002nvp-MY for emacs-orgmode@gnu.org; Wed, 07 Jul 2021 20:12:48 -0600 References: <87lf6hr74u.fsf@nicolasgoaziou.fr> User-agent: mu4e 1.2.0; emacs 26.3 From: "Thomas S. Dye" To: emacs-orgmode@gnu.org Subject: Re: [wip-cite-new] Merging tomorrow? In-reply-to: <87lf6hr74u.fsf@nicolasgoaziou.fr> Date: Wed, 07 Jul 2021 16:12:47 -1000 Message-ID: <87wnq1tuxs.fsf@tsdye.online> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: quoted-printable X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - box2035.bluehost.com X-AntiAbuse: Original Domain - gnu.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - tsdye.online X-BWhitelist: no X-Source-IP: 50.113.36.248 X-Source-L: No X-Exim-ID: 1m1JWy-002nvp-MY X-Source: X-Source-Args: X-Source-Dir: X-Source-Sender: cpe-50-113-36-248.hawaii.res.rr.com (poto-foou.tsdye.online) [50.113.36.248]:55470 X-Source-Auth: tsd@tsdye.online X-Email-Count: 1 X-Source-Cap: dHNkeWVvbmw7dHNkeWVvbmw7Ym94MjAzNS5ibHVlaG9zdC5jb20= X-Local-Domain: yes Received-SPF: pass client-ip=192.185.143.47; envelope-from=tsd@tsdye.online; helo=gateway31.websitewelcome.com X-Spam_score_int: 4 X-Spam_score: 0.4 X-Spam_bar: / X-Spam_report: (0.4 / 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, FROM_SUSPICIOUS_NTLD=0.5, PDS_OTHER_BAD_TLD=1.999, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=no autolearn_force=no X-Spam_action: no action 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-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1625711007; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=ne2wuBTuzO44cuuqkJdfvYLyBddoEPHCGoeXDZLNVuw=; b=sNYY6l632F8XoIGlCir47pXiIdQpLyV+soy2fPAHyY3BckaB427Kt2TOc9yv+p3pxM1sSg uFs9+B9DMWcCxIFSjai5X7xrIpGgqiEnSHT8XiinKw15uBUAeTdHhoXm3LBgzu1BUAPHyt FvVfyUx+RaQSQynjzwbV5xp/DZuoVLFbxdELiSCzkUqSOln49I2+L4e22kZYJhK0nuQzmR K1oy3fjkz81jlyB9NW66/n7GHcSqkqjgmn+LhtACKwSq4FuhfAPglodI3qh1bTWcEAgn4n w3LSMjro06KTnHlfKLsjv3JcjWBLLtnROB+rDlFptbRMh0RDoK8Hr1NopMnmCg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1625711007; a=rsa-sha256; cv=none; b=Rj1c9AuvZMG3Xaulhl0xQySR1QiK5oNbLwPfQA8rLLd2NlCUK3vuMGucJv4noV3ln8aD1u zIwerA7cdvrx9ien/X/ZQaothalvnbAuFnjG3/e8lespR/pwTWj3HlHAajtuw9XK5reLei 87Lg8HgC+fV/H0T1fuHq9o/PGHMvD0b4uLQHjJggkNksn8AeiuPM1LHwbBnsyZLw2fRrak D+Nslw9mXXsiomm5EbHSEfcoMODQxC9QDZP700kSuHJolx+EQGtAnIQMYeXqmXRHRavL19 f4tYxzh18NrTp2nnQBqDhGvEN23t0TTrnC7wIZjvy+sVVVhhUJq2s9pH3w0WnQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=tsdye.online header.s=default header.b=ynsbs8gk; 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-Migadu-Spam-Score: -0.41 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=tsdye.online header.s=default header.b=ynsbs8gk; dmarc=none; 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-Migadu-Queue-Id: 351A220984 X-Spam-Score: -0.41 X-Migadu-Scanner: scn0.migadu.com X-TUID: sP12BK6oaZzP Aloha Nicolas, Good news! I'm looking forward to using this facility. Thanks to all the contributors. All the best, Tom Nicolas Goaziou writes: > Hello, > > I think the "wip-cite-new" branch is in good shape now. As > a consequence, I'd like to merge it tomorrow. > > It is documented, but the documentation is scattered across the=20 > various > "oc" libraries, and some threads in the mailing list. I'll do a=20 > summary > here, from a user point of view. > > --8<---------------cut=20 > here---------------start------------->8--- > Basically, in order to use it, you need to first set-up a=20 > bibliography, > using one or more "bibliography" keywords. on such a=20 > keyword > visits the related file. Out of the box, Org supports JSON-CSL=20 > and > BibTeX (or biblatex) bibliographies. > > Then, citations can be inserted with the following syntax: > > [cite/style:common prefix ;prefix @key suffix; ... ; common=20 > suffix] > > Spaces are meaningful except those after the initial colon and=20 > before > the closing bracket. > > Every part of the syntax is optional, except the brackets,=20 > "cite" and > the colon. Also the citation must contain at least a key. So its=20 > minimal > form is: > > [cite:@key] > > The "style" part is detailed below, in the part related to=20 > export. > > Org can insert or edit citations with (and delete=20 > them with > ), follow them with , fontify them, and=20 > export > them. These four actions (insert, follow, activate, and export)=20 > are > called capabilities. Libraries responsible for these=20 > capabilities are > called citation processors. > > You can select one citation processor for each capability,=20 > independently > on the others, through the following variables: > > - org-cite-activate-processor > - org-cite-export-processors > - org-cite-follow-processor > - org-cite-insert-processor > > Out of the box, Org provides the "basic" (in "oc-basic.el")=20 > processor > for all of these tasks. It also boasts processors dedicated for=20 > export: > "csl", "natbib" and "biblatex". > > During export, output for citations is controlled by their=20 > style, which > is an Org label that the export processor may recognize and=20 > associate to > a specific display, or fall-back to a default style (called=20 > "nil"). For > example, most processors support "noauthor" and "text" styles. > > Some styles can accept a variant, with the syntax=20 > "style/variant". > Again, it's up to the processor to associate it to a specific=20 > display. > Common variants include "bare", "caps" or "full". They also=20 > accept > short-hands, like "b", "c" and "f". Please refer to the export > processors' libraries ("oc-basic.el", "oc-csl.el", =E2=80=A6) for more=20 > information. > > It is possible to define a default style for a whole document=20 > (with > "cite_export"), or for all documents (with=20 > `org-cite-export-processors'). > > References are displayed with the "print_bibliography" keyword.=20 > It is > possible to add parameters to its value, as some export=20 > processors could > make use of them. > --8<---------------cut=20 > here---------------end--------------->8--- > > Please let me know if there are any objections to the merge. > > Regards, -- Thomas S. Dye https://tsdye.online/tsdye