emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: "Bruce D'Arcus" <bdarcus@gmail.com>
To: Org Mode List <emacs-orgmode@gnu.org>
Subject: Re: (Not so) Short note about citations in Org
Date: Thu, 22 Apr 2021 08:02:55 -0400	[thread overview]
Message-ID: <CAF-FPGOeP5WrgqBHOnO05tgqdKpSAo29_USevojomWxZii2DPw@mail.gmail.com> (raw)
In-Reply-To: <87pmyn5i1g.fsf@nicolasgoaziou.fr>

On Wed, Apr 21, 2021, 7:34 PM Nicolas Goaziou <mail@nicolasgoaziou.fr> 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


  parent reply	other threads:[~2021-04-22 12:05 UTC|newest]

Thread overview: 24+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-04-21 23:34 Nicolas Goaziou
2021-04-22  0:15 ` Bruce D'Arcus
2021-04-22  0:35   ` Nicolas Goaziou
2021-04-22  0:56     ` Bruce D'Arcus
2021-04-22 12:02 ` Bruce D'Arcus [this message]
2021-04-22 13:14   ` Nicolas Goaziou
2021-04-22 13:23     ` Bruce D'Arcus
2021-04-22 17:47 ` M. ‘quintus’ Gülker
2021-04-22 20:44   ` Bruce D'Arcus
2021-04-24  7:53   ` Nicolas Goaziou
2021-04-24  0:07 ` Bruce D'Arcus
2021-04-24  7:53   ` Nicolas Goaziou
2021-04-24 11:40     ` Bruce D'Arcus
2021-04-25 21:19 ` Denis Maier
2021-04-26 18:36   ` Bruce D'Arcus
2021-04-26 20:02     ` Nicolas Goaziou
2021-04-26 20:13       ` Denis Maier
2021-04-26 20:14       ` Denis Maier
2021-04-26 20:33         ` Nicolas Goaziou
2021-04-26 20:38           ` Denis Maier
2021-04-26 21:11             ` Nicolas Goaziou
2021-04-26 21:52               ` Denis Maier
2021-04-26 21:15             ` Joost Kremers
2021-04-27 12:21       ` Bruce D'Arcus

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=CAF-FPGOeP5WrgqBHOnO05tgqdKpSAo29_USevojomWxZii2DPw@mail.gmail.com \
    --to=bdarcus@gmail.com \
    --cc=emacs-orgmode@gnu.org \
    --subject='Re: (Not so) Short note about citations in Org' \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

Code repositories for project(s) associated with this inbox:

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).