emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Ihor Radchenko <yantar92@posteo.net>
To: Eric Anderson <kluwak@gmail.com>, Timothy <orgmode@tec.tecosaur.net>
Cc: emacs-orgmode@gnu.org
Subject: [BUG] Footnotes in section titles
Date: Wed, 24 Jan 2024 12:11:21 +0000	[thread overview]
Message-ID: <87sf2ngcd2.fsf@localhost> (raw)
In-Reply-To: <CAE7YrOW5+ZBtsyaVkyJAD9ZEkWsJQ3F0Ut543CSPkqmUTzhLhQ@mail.gmail.com>

Eric Anderson <kluwak@gmail.com> writes:

> The resulting LaTeX code (also attached) uses \footnote inside \section and
> \paragraph macros, producing compiler errors.  A little googling turns up
> the following comp.text.tex usenet post
> https://comp.text.tex.narkive.com/lkZWQYaS/using-footnotes-in-paragraph,
> explaining that \footnote is fragile and cannot be used in those contexts
> without \protect.  Manually adding \protect before \footnote in the
> automatically-generated tex file appears to produce correct results.
>
> I don't know if the best fix is to always \protect \footnotes in LaTeX
> export, or if more contextual smarts are required, but this seems like an
> issue worth addressing.

Confirmed.

\protect is not a good idea. There is a reason why LaTeX refuses
footnotes in titles - titles can appear in multiple places in the
document (TOC, page footer, etc) and thus references to the footnotes
are non-deterministic.

https://texfaq.org/FAQ-ftnsect suggests to use
\usepackage[stable]{footmisc}
or to pass optional argument to \section without footnote
\section[title]{title\footnote{title ftnt}}

The footmisc package is a nice solution, but it has certain requirements
about loading order. In particular, it must be loaded after certain
packages (setspace, memoir). We cannot yet control the \usepackage
ordering in LaTeX preamble and always place default LaTeX packages first
- something we cannot do for footmisc.

The \section[...]{...} approach may work, but it is tricky - it is
completely up to the `org-latex-classes'. So, we may have to use regexp
replacement, which might be fragile.

So, I prefer the first approach with footmisc. But we can only do it
after Timothy's patch introducing more flexible templating system is
landed.

CCing Timothy.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>


  reply	other threads:[~2024-01-24 12:08 UTC|newest]

Thread overview: 24+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-01-22 20:42 Possible LaTeX export bug: Footnotes in items Eric Anderson
2024-01-24 12:11 ` Ihor Radchenko [this message]
2024-01-24 14:14   ` [BUG] Footnotes in section titles Max Nikulin
2024-01-24 15:23     ` Juan Manuel Macías
2024-01-24 15:31       ` Colin Baxter
2024-01-24 15:41         ` Juan Manuel Macías
2024-01-26 12:53           ` Ihor Radchenko
2024-01-26 13:17             ` Juan Manuel Macías
2024-01-26 16:43             ` Max Nikulin
2024-02-01 14:44               ` [DISCUSSION] Allowing footnote-references inside parsed keywords (#+AUTHOR, #+TITLE, etc) (was: [BUG] Footnotes in section titles) Ihor Radchenko
2024-02-01 17:44                 ` [DISCUSSION] Allowing footnote-references inside parsed keywords (#+AUTHOR, #+TITLE, etc) Juan Manuel Macías
2024-02-01 17:57                   ` Marvin Gülker
2024-02-02 17:00                   ` Ihor Radchenko
2024-02-02 17:12                     ` Marvin Gülker
2024-02-02 17:49                       ` Ihor Radchenko
2024-02-02 18:10                     ` Juan Manuel Macías
2024-02-02 20:21                       ` Exporting multiple #+AUTHOR keywords (was: [DISCUSSION] Allowing footnote-references inside parsed keywords (#+AUTHOR, #+TITLE, etc)) Ihor Radchenko
2024-02-02 22:26                         ` Exporting multiple #+AUTHOR keywords Juan Manuel Macías
2024-02-04 15:21                           ` Ihor Radchenko
2024-02-04 16:16                             ` Max Nikulin
2024-02-04 22:13                               ` Juan Manuel Macías
2024-02-05 14:57                               ` Ihor Radchenko
2024-01-26 12:09     ` [BUG] Footnotes in section titles Ihor Radchenko
2024-02-09 16:41       ` Ihor Radchenko

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=87sf2ngcd2.fsf@localhost \
    --to=yantar92@posteo.net \
    --cc=emacs-orgmode@gnu.org \
    --cc=kluwak@gmail.com \
    --cc=orgmode@tec.tecosaur.net \
    /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
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

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