search

ionelmc / python-darkslide

Generate HTML5 slideshows from markdown, ReST, or textile
http://ionelmc.github.io/python-darkslide/
Apache License 2.0
98 stars 22 forks source link

footnotes broken #3

Open Matthias84 opened 7 years ago

Matthias84 commented 7 years ago

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] .... [^1]: This is a footnote content. The final presentation is broken and doesn't display anything without the blank filled background.

Environment

ionelmc commented 7 years ago

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 7 years ago

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 7 years ago

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?

Matthias84 commented 7 years ago

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.