emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: John Kitchin <jkitchin@andrew.cmu.edu>
To: Joseph Vidal-Rosset <joseph@vidal-rosset.net>
Cc: org-mode-email <emacs-orgmode@gnu.org>
Subject: Re: org-ref 2 vs org-ref 3
Date: Wed, 20 Oct 2021 08:48:00 -0400	[thread overview]
Message-ID: <CAJ51ETp0Ot=QYrdfdyv04UgAZUfbavcHsfRbg+-2svH2fACF=w@mail.gmail.com> (raw)
In-Reply-To: <f5b1cde8-b340-8f28-bdeb-3d024e94ec79@vidal-rosset.net>

[-- Attachment #1: Type: text/plain, Size: 2110 bytes --]

All the breaking changes are documented at

You can find configuration details at

On Wed, Oct 20, 2021 at 2:59 AM Joseph Vidal-Rosset <joseph@vidal-rosset.net>

> Dear John,
> I upgraded org-ref to get org-ref 3 and I met the following difficulties:
> - my shortcut to get the list of my bib file did not work, and I have to
> use the emacs menu,

If you mean keyboard shortcuts (like C-c ]), you should define these in
your init files as described in the configuration above. org-ref does not
do this automatically anymore.

> - I did not get  via org-ref  a pdf file of any paper,

I can't help you on this with so little information. is there some error?

> - cite links with the page(s) via "description" show only the page but
> the reference is hidden,

I consider the syntax of pre/postnote in the description to be deprecated
(but still supported). I pushed a fix to show the full links with a
description for the version 2 syntax. The preferred way to do pre/post
notes now is like:

version 3 syntax (keys are prefixed by &, and prenote is before the key,
postnote is after the key.

[[cite:&xiao-2006-size-effec 45]]

[[cite:see &xiao-2006-size-effec 45]]

These export to:



version 2 syntax still works, (the two key differences are there is no &
prefixing the citation key, and the pre/post note is in the description.

These citations



export to:

version 2 syntax



> at the moment, I downgraded to org-ref 2 and everything works fine.
> I imagine that all is in the documentation you wrote to solve these
> problems, but I wanted to point out them, in order to solve them easily
> and to contribute to the improvement of this terrific tool you gave to
> us. I do not imagine now writing without org-ref.
> Thanks !
> Jo.

[-- Attachment #2: Type: text/html, Size: 3567 bytes --]

  reply	other threads:[~2021-10-20 12:49 UTC|newest]

Thread overview: 3+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-10-20  6:58 org-ref 2 vs org-ref 3 Joseph Vidal-Rosset
2021-10-20 12:48 ` John Kitchin [this message]
2021-10-20 18:46   ` Joseph Vidal-Rosset

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:

  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='CAJ51ETp0Ot=QYrdfdyv04UgAZUfbavcHsfRbg+-2svH2fACF=w@mail.gmail.com' \
    --to=jkitchin@andrew.cmu.edu \
    --cc=emacs-orgmode@gnu.org \
    --cc=joseph@vidal-rosset.net \


* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox


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).