From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id aEsFM39mgWCZUgEAgWs5BA (envelope-from ) for ; Thu, 22 Apr 2021 14:05:19 +0200 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 oM/ALn9mgWDzLAAA1q6Kng (envelope-from ) for ; Thu, 22 Apr 2021 12:05:19 +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 26C50E9DC for ; Thu, 22 Apr 2021 14:05:18 +0200 (CEST) Received: from localhost ([::1]:40292 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1lZY54-0008Q3-Jm for larch@yhetil.org; Thu, 22 Apr 2021 08:05:14 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:46310) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1lZY35-0007qZ-9v for emacs-orgmode@gnu.org; Thu, 22 Apr 2021 08:03:14 -0400 Received: from mail-vs1-xe2d.google.com ([2607:f8b0:4864:20::e2d]:35484) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1lZY30-0006s9-3V for emacs-orgmode@gnu.org; Thu, 22 Apr 2021 08:03:11 -0400 Received: by mail-vs1-xe2d.google.com with SMTP id g20so22764586vst.2 for ; Thu, 22 Apr 2021 05:03:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to; bh=l9RZeO2pE1sh2kMdKJ9LNxVn3wO2dLRGF/B6zOm6y5I=; b=WlsJTMW2u9xc4eOxnuIY7Tf77KaTh9sgv9CR7/DcHAjdpZdNlDh9R5ZvI9lryvzcRe WuGTRrS40rZprYZ4CxCTQS4udzQgLpdye/rGI8rs5ITWIycxhpFA5RKKvHkXTZMfarlT haGND37bjxZled0ktfk4QJN+g9rxlareBd+hQphGTCXUNeCPmijbflPR+rA+iND08/3R ZnwGKqtiplWLZEuFhjVPEs3xzruezoKc/b6H06oIjpcshMiX+KpzFBfS4900om/RvWhW wynwRXGHjKra5iivYkrTlkDgqbsuy8y1cBl2o1lVb52EVXx4rXxNqnaDs3f9n8Pf/1oO YhBA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to; bh=l9RZeO2pE1sh2kMdKJ9LNxVn3wO2dLRGF/B6zOm6y5I=; b=pq0wZ85/1pKxc6h06LC9zMm59KTXEKGNV9oi8lW0i7oXU7SC+8aXajdaPXLv7Tljv5 VuTuO5qmKnIW0PTrudibKWhJq3Xys88mHxwdTH+XVrkYYTXJO6HcI+KeWTOiHHDgQBqA /YpSQAcUFf+/NKLmEyYGkNlwt4Nm0zQxLfjdLqaDsjzerKyo2Zpy7DXKa6qaV4/5uoF0 w4yQyWz/HZCt3sFiXK95f582OyNF0QPZrj/v4NElc+Eec1T4PHorOfaH1r1keNHvCqIh u7Jv8GJyXTDSJEz0hRX9Vqaq6Eybuk04LfR7E4rP+LubnkuWGKotMUu2TqwJnXKPEeH7 uXRg== X-Gm-Message-State: AOAM533xG6kLPdHyczwraBkXR/bmNGfThytz0yxSwqVCesP+byPLUrkG aA50cYNzSs+FqbLEvIGx3A3Zzx7ozGVAq1OX+XZ3f3F4Uwk= X-Google-Smtp-Source: ABdhPJypmCWQoFZFr1k0BCnLUvOEbXue4sxMBWlB945BxFxdxaYxAOf+y4A3m50fRXjwPPNaWx0nl3CTH71Ys1OLuS8= X-Received: by 2002:a67:c98b:: with SMTP id y11mr2231877vsk.2.1619092984211; Thu, 22 Apr 2021 05:03:04 -0700 (PDT) MIME-Version: 1.0 References: <87pmyn5i1g.fsf@nicolasgoaziou.fr> In-Reply-To: <87pmyn5i1g.fsf@nicolasgoaziou.fr> From: "Bruce D'Arcus" Date: Thu, 22 Apr 2021 08:02:55 -0400 Message-ID: Subject: Re: (Not so) Short note about citations in Org To: Org Mode List Content-Type: text/plain; charset="UTF-8" Received-SPF: pass client-ip=2607:f8b0:4864:20::e2d; envelope-from=bdarcus@gmail.com; helo=mail-vs1-xe2d.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham 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=1619093119; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=l9RZeO2pE1sh2kMdKJ9LNxVn3wO2dLRGF/B6zOm6y5I=; b=qm/baAt6U0ofGU6MXAf8ZMuTik67IOXZ+RRKqio+nvly0jpNQzk8SdYXRpHVL1tWX6AE+x x5cnFFruyx/iJ0PS6FvRMpAeV63lWk79P1iO0XjvV56MMeJwDK25OrGPJTveBSXdiBgZqo eCVQ/huSIKQSKx6wgI7o9afihg709/Ml7t2kJB4TIn9+Ji5KzwjiF3VUbv7mKnl4Qlzkc+ 0njrmtICPwAj6X5Lc7t2COZPClGyXMp/KKkVl+dDg1czktp2BZ8adM1kMRtl9puymIan7U NWN1CwZPdTuKvID/zAW/h9KHgDCbvfdCGm61iN5bozjgmIOnjFL7zKKPCRkpyw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1619093119; a=rsa-sha256; cv=none; b=AfYP+sgroF3QOuoAj4hujNiFFeTSD+b7p8+j17OvO+ui/YhCNLfpWod5IrHKoHzuBSFfbk B+43ydcszjgZdwn8IOjKiZC4Wr67EYq3j0pynkNSYKngSTBVwoPl4qd1dAY+2KE4NSnnsq iYGoK2Z+K2lXax5rtSn/1HadeNNe4Z5fwy38a3ArG5Lw5175MpJo4POZJo2VSPklegtsRb d6BY6fd2DHWgJVzuqDYNiey8Dr5ZMxxciopuJT69hgAtf0cH5P6mukR1/L6CEW5rH3/f0r IRqlL+rnpDva3/8QoLdx4/dXqreBU5eL8hKmH0LAf4cAjmBVbvXVqd5nK1Rvsg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=WlsJTMW2; dmarc=pass (policy=none) header.from=gmail.com; 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: -3.77 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20161025 header.b=WlsJTMW2; dmarc=pass (policy=none) header.from=gmail.com; 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: 26C50E9DC X-Spam-Score: -3.77 X-Migadu-Scanner: scn0.migadu.com X-TUID: S783N4fFT16Q On Wed, Apr 21, 2021, 7:34 PM Nicolas Goaziou wrote: > `:export-bibliography' > > Function rendering a bibliography. It is called with five arguments: a list > of citations, a list of bibliography files, the style, as a string or nil, > the export back-end, as a symbol, and the communication channel, as a > property list. > > It is called at each \"print_bibliography\" keyword in the parse tree. > It may return a string or nil. When it returns nil, the keyword is ignored. > Otherwise, the string it returns replaces the keyword in the export output. > > `:export-citation' (mandatory for \"export\" capability) > > Function rendering citations. It is called with four arguments: a citation > object, the style, as a string or nil, the export back-end, as a symbol, > and the communication channel, as a property list. > > It is called on each citation object in the parse tree. It may return > a string or nil. When it returns nil, the citation is ignored. Otherwise, > the string it returns replaces the citation object in the export output. > > `:export-finalizer' > > Function called at the end of export process. It must accept five > arguments: the output, as a string, a list of citations, a list of > bibliography files, a list of bibliography styles requested by various > \"print_bibliography\" keywords in the document, as strings or nil, and the > export back-end, as a symbol. The haskell citeproc library has this: "a CiteprocOptions structure (which currently just allows you to set whether citations are hyperlinked to the bibliography)" Would something like that make sense as an optional argument somewhere here? Or would details like that get set somewhere else? BTW, on the demo, the "help echo" on my machine (a very recent Emacs 28) only flickers briefly, so I can't actually see it. But I like how this is all looking; curious what others say. Bruce