ionelmc/python-darkslide

footnotes broken

Matthias84 opened this issue · 4 comments

Matthias84 commented

Hi there, I struggeled upon the footnote feature.

If I add it like the readme.md says

.footnote: Slides available at https://blog.ionelmc.ro/presentations/
it is just rendered as ordinary text, even if I enable the extension manually

If I add it like the extension says

Footnotes are awesome 1 ....

Environment

  • Python 2.7.12
  • Darkslide 4.0.1
  • markdown 2.6.9
  • default theme

Footnotes

  1. This is a footnote content.
    The final presentation is broken and doesn't display anything without the blank filled background. ↩

ionelmc commented

So there are two kinds of footnotes, the darkslide footnote macro (.footnote: blabl) and md/rst footnotes.

The macro looks like this: http://ionelmc.github.io/python-darkslide/#slide:1 and it's rendered from this markup:

# Title Slide

.footer: [default theme](.) | [abyss theme](abyss.html) | [void theme](void.html) | [white theme](white.html) | [github](https://github.com/ionelmc/python-darkslide)

---

Now about the md/rst footnote - I must ask: what do you need it for?

Matthias84 commented

hi @ionelmc , thanks for making this clear.

So readme.md should be fixed to .footer: to avoid misunderstandings 😉

My usecase is to add some clearification/description outside of the presentation text (visible to the interested audience, but not interrupting others). So it would be visible on single pages only. I'm not sure how much work is it to implement an nice rendering 😕
I guess I could go an other way to realize this seperation ...

ionelmc commented

Dully noted.

About supporting the rst/md footnotes - how should it look? Just smaller font + bottom align? Should be inside the footer just like the footnote macro?

  • 👍1
Matthias84 commented

IMHO I guess at bottom of the slide would be perfectly ok to underline the reference to the content (within) the slide. IMHO the footer has an (to) global scope.