emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* HTML Export - Footnotes inconcistency
@ 2018-09-28 12:39 Matthias Paulmier
  2018-10-01 17:39 ` Nicolas Goaziou
  0 siblings, 1 reply; 4+ messages in thread
From: Matthias Paulmier @ 2018-09-28 12:39 UTC (permalink / raw)
  To: emacs-orgmode

Hello,

I came across this problem today (or maybe it is intended but I couldn't
find any explanation in the docs). There is an inconsistency on how
inline/anonymous and named footnotes are exported in HTML. For example,
with the following source:

--8<---------------cut here---------------start------------->8---
#+TITLE: Testing footnotes
#+LANGUAGE: en

Testing[fn::test1] footnotes[fn:2]

[fn:2] test2
--8<---------------cut here---------------end--------------->8---

Exports to this :

--8<---------------cut here---------------start------------->8---
<h2 class="footnotes">Footnotes: </h2>
<div id="text-footnotes">

<div class="footdef"><sup><a id="fn.1" class="footnum"
href="#fnr.1">1</a></sup> <div class="footpara">test1</div></div>

<div class="footdef"><sup><a id="fn.2" class="footnum"
href="#fnr.2">2</a></sup> <div class="footpara"><p class="footpara">
test2 </p></div></div>
--8<---------------cut here---------------end--------------->8---

We can see here that the named footnote creates a paragraph of the same
class as the parent container "footpara" whereas the inlined one doesn't
create this.  If this is intended, why?  If not, which is the intended
one?

Reagards.
-- 
Matthias Paulmier

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

* Re: HTML Export - Footnotes inconcistency
  2018-09-28 12:39 HTML Export - Footnotes inconcistency Matthias Paulmier
@ 2018-10-01 17:39 ` Nicolas Goaziou
  2018-10-01 19:06   ` Matthias Paulmier
  0 siblings, 1 reply; 4+ messages in thread
From: Nicolas Goaziou @ 2018-10-01 17:39 UTC (permalink / raw)
  To: Matthias Paulmier; +Cc: emacs-orgmode

Hello,

Matthias Paulmier <matthias.paulmier@etu.u-bordeaux.fr> writes:

> I came across this problem today (or maybe it is intended but I couldn't
> find any explanation in the docs). There is an inconsistency on how
> inline/anonymous and named footnotes are exported in HTML. For example,
> with the following source:
>
> #+TITLE: Testing footnotes
> #+LANGUAGE: en
>
> Testing[fn::test1] footnotes[fn:2]
>
> [fn:2] test2
>
>
> Exports to this :
>
> <h2 class="footnotes">Footnotes: </h2>
> <div id="text-footnotes">
>
> <div class="footdef"><sup><a id="fn.1" class="footnum"
> href="#fnr.1">1</a></sup> <div class="footpara">test1</div></div>
>
> <div class="footdef"><sup><a id="fn.2" class="footnum"
> href="#fnr.2">2</a></sup> <div class="footpara"><p class="footpara">
> test2 </p></div></div>
>
> We can see here that the named footnote creates a paragraph of the same
> class as the parent container "footpara" whereas the inlined one doesn't
> create this.  If this is intended, why?  If not, which is the intended
> one?

This is intended, in a way, since the inline footnote is not a paragraph
by itself. It is contained within a paragraph. This explains why you
cannot have blank lines within an inline footnote. 

OTOH, a footnote definition can contain multiple paragraphs.

I don't know if that's a good thing, but these differences at the Org
level are translated into the HTML output.

Regards,

-- 
Nicolas Goaziou

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

* Re: HTML Export - Footnotes inconcistency
  2018-10-01 17:39 ` Nicolas Goaziou
@ 2018-10-01 19:06   ` Matthias Paulmier
  2018-10-03 13:38     ` Nicolas Goaziou
  0 siblings, 1 reply; 4+ messages in thread
From: Matthias Paulmier @ 2018-10-01 19:06 UTC (permalink / raw)
  To: Nicolas Goaziou; +Cc: emacs-orgmode

Hello,

Nicolas Goaziou <mail@nicolasgoaziou.fr> writes:
> This is intended, in a way, since the inline footnote is not a paragraph
> by itself. It is contained within a paragraph. This explains why you
> cannot have blank lines within an inline footnote.

I think I get the logic behind it. The problem is the inconsistency it
creates for the viewer. Does it really matter for them if I wrote my
footnote inline or not?

Thanks for your answer.
--
Matthias Paulmier

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

* Re: HTML Export - Footnotes inconcistency
  2018-10-01 19:06   ` Matthias Paulmier
@ 2018-10-03 13:38     ` Nicolas Goaziou
  0 siblings, 0 replies; 4+ messages in thread
From: Nicolas Goaziou @ 2018-10-03 13:38 UTC (permalink / raw)
  To: Matthias Paulmier; +Cc: emacs-orgmode

Hello,

Matthias Paulmier <matthias.paulmier@etu.u-bordeaux.fr> writes:

> I think I get the logic behind it. The problem is the inconsistency it
> creates for the viewer. Does it really matter for them if I wrote my
> footnote inline or not?

Inline footnotes are now wrapped within a paragraph. Thank you.

Regards,

-- 
Nicolas Goaziou

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

end of thread, other threads:[~2018-10-03 13:38 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2018-09-28 12:39 HTML Export - Footnotes inconcistency Matthias Paulmier
2018-10-01 17:39 ` Nicolas Goaziou
2018-10-01 19:06   ` Matthias Paulmier
2018-10-03 13:38     ` Nicolas Goaziou

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