emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* [org-cite] allow citations in captions?
@ 2021-10-10 11:34 Bruce D'Arcus
  2021-10-10 12:00 ` Nicolas Goaziou
  0 siblings, 1 reply; 3+ messages in thread
From: Bruce D'Arcus @ 2021-10-10 11:34 UTC (permalink / raw)
  To: org-mode-email

Is there any technical reason citations aren't allowed in captions?

If not, could that restriction be removed?

I do note LaTeX requires special handling for that though;
\protect\cite{ref} or {\cite{ref}}.

https://stackoverflow.com/questions/4487728/latex-inserting-a-reference-in-a-figures-caption

Bruce


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [org-cite] allow citations in captions?
  2021-10-10 11:34 [org-cite] allow citations in captions? Bruce D'Arcus
@ 2021-10-10 12:00 ` Nicolas Goaziou
  2021-10-10 13:03   ` Bruce D'Arcus
  0 siblings, 1 reply; 3+ messages in thread
From: Nicolas Goaziou @ 2021-10-10 12:00 UTC (permalink / raw)
  To: Bruce D'Arcus; +Cc: org-mode-email

Hello,

"Bruce D'Arcus" <bdarcus@gmail.com> writes:

> Is there any technical reason citations aren't allowed in captions?

Yes, there is. Captions are somewhat fragile: they may or may not be
included in the final output. So this might introduce some subtle bugs,
such as pointers (op. cit., or ibid) to non-existing references. For the
same reason, footnotes references are not allowed in citations either.
I don't know if the benefits outweigh these possible complications.

Regards,
-- 
Nicolas Goaziou


^ permalink raw reply	[flat|nested] 3+ messages in thread

* Re: [org-cite] allow citations in captions?
  2021-10-10 12:00 ` Nicolas Goaziou
@ 2021-10-10 13:03   ` Bruce D'Arcus
  0 siblings, 0 replies; 3+ messages in thread
From: Bruce D'Arcus @ 2021-10-10 13:03 UTC (permalink / raw)
  To: Nicolas Goaziou; +Cc: org-mode-email

On Sun, Oct 10, 2021 at 8:00 AM Nicolas Goaziou <mail@nicolasgoaziou.fr> wrote:
>
> Hello,
>
> "Bruce D'Arcus" <bdarcus@gmail.com> writes:
>
> > Is there any technical reason citations aren't allowed in captions?
>
> Yes, there is. Captions are somewhat fragile: they may or may not be
> included in the final output. So this might introduce some subtle bugs,
> such as pointers (op. cit., or ibid) to non-existing references. For the
> same reason, footnotes references are not allowed in citations either.
> I don't know if the benefits outweigh these possible complications.

I'm not sure either. But they're not uncommon in the wild.

The "subtle bugs" you mention: does that example you note only apply
to output formats that omit the captions?

The important export formats for academic writing are latex, odt, and
(less so) html, all of which do include the captions. Are there others
you are thinking of?

Bruce


^ permalink raw reply	[flat|nested] 3+ messages in thread

end of thread, other threads:[~2021-10-10 13:04 UTC | newest]

Thread overview: 3+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-10-10 11:34 [org-cite] allow citations in captions? Bruce D'Arcus
2021-10-10 12:00 ` Nicolas Goaziou
2021-10-10 13:03   ` Bruce D'Arcus

Code repositories for project(s) associated with this public 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).