Re: Footnotes in revealjs slides

[BPJ <bpj-J3H7GcXPSITLoDKTGw+V6w@public.gmane.org>]

[-- Attachment #1: Type: text/plain, Size: 6803 bytes --]

Den tis 15 sep. 2020 23:50anna ecke <0x616e6e6165636b65-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org> skrev:

> Thank you BP for your input. But I think, we have a small misunderstanding
> here. I was referring to footnotes
> <https://pandoc.org/MANUAL.html#footnotes>, which is a special type of
> references, I think, not speaker notes.
>

I too was about *foot*notes, albeit "faked" ones not using Pandoc's native
footnotes. If you test my setup filter and all and look at my example HTML
you will see that. By having the filter replace native Pandoc divs with the
class `notes` with raw HTML for div tags I managed to get an actual div,
rather than an aside/speaker notes, so that I could style the list inside.
Did you perhaps not get the zip archive?

It may be possible to write a Lua filter so that native notes within each
slide/section can be converted to my "faked" format, but I'm afraid that a
Lua filter would not visit the native note elements in say a section
container as created by `make_sections()` in linear order, so they might
end up in the wrong order in a generated list. Albert can probably answer
whether that problem is still there, or if there is a workaround. Anyway I
tried to convert footnote markers in a paragraph to empty spans with a
`note` class and a sequence of reference footnotes into an ordered list
with Vim `s///` commands and it worked well, so it shouldn't be too hard to
convert existing native notes to my "faked" version with a decent editor or
a text filter script.



> BP schrieb am Montag, 14. September 2020 um 14:17:49 UTC+2:
>
>> On 2020-09-14 00:00, anna ecke wrote:
>> > At the moment, the location where footnotes are rendered into can be
>> > configured with the option reference-location
>> > <https://pandoc.org/MANUAL.html#option--reference-location>.
>> Unfortunately,
>> > it only takes effect when rendering markdown. I'd like to get my
>> footnotes
>> > rendered into the same slide it was mentioned/written in.
>> >
>> > My question is now, would it make sense to propose this on github as a
>> > feature request, or should I just go ahead and write a filter for this?
>> I'm
>> > not an Haskell expert and I haven't checked out the code base to look
>> what
>> > needs to be changed to make that kind of behaviour work or what amount
>> of
>> > effort it might take.
>> >
>> > Happy to hear any opinion or even receive links the code responsible
>> for
>> > this or to projects that have solved this already.
>> >
>> > cheers,
>> > ae
>> >
>>
>> Nothing prevents you from constructing your notes manually, placing note
>> references as sequential numbers in the text and a list with each note
>> text at the appropriate list number at the bottom of each slide.
>> Presumably no links between note markers and notes would be needed in a
>> slide show, which makes things easier, although you might want to wrap
>> the note numbers in the text in spans with a class and the lists with
>> notes in divs with another class for styling.
>>
>> Using a little CSS magic and a Lua filter you can both get note
>> references and note list numbers styled and colored appropriately, *and*
>> reveal yourself of the need to insert note numbers manually, although
>> you still need to insert divs with an appropriate class where you want a
>> note reference to appear, and need to make sure that the notes in the
>> list come in the right order relative to the note references in the text
>> of each slide.
>>
>> Something like this:
>>
>> ``````markdown
>> ## Slide heading
>>
>> The text [mentioning]{.note} some [thing]{.note} or [other]{.note} goes
>> here.
>>
>> :::notes
>>
>> 1. Text for note.
>> 2. Text for note.
>> 3. Text for note.
>>
>> :::
>> ``````
>>
>> and then in some appropriate place some custom CSS:
>>
>> ``````css
>> span.note:after {
>> content: counter(note-ref-counter);
>> vertical-align: super;
>> color: blue;
>> font-size: 50%;
>> }
>>
>> div.notes ol {
>> list-style: none;
>> font-size: 50%;
>> }
>>
>> section.slide, section.title-slide {
>> counter-reset: note-ref-counter note-counter;
>> }
>>
>> div.notes ol li:before {
>> content: counter(note-counter);
>> vertical-align: super;
>> color: blue;
>> display: inline-block;
>> width: 1em;
>> margin-left: -1em;
>> }
>>
>> span.note {
>> counter-increment: note-ref-counter;
>> }
>>
>> div.notes ol li {
>> counter-increment: note-counter;
>> }
>> ``````
>>
>> This should give you blue superscript note markers and blue superscript
>> list markers without any trailing dot, automatically numbered
>> sequentially for each slide.
>> I tried to make the count be for the whole file rather than for each
>> slide, but Chrome insists on resetting the counters to 1 when they have
>> reached 9. Perhaps someone who understands CSS counters better than I do
>> knows how to fix that.
>>
>> Finally you need to apply the following Lua filter when running Pandoc,
>> so that the `<div>` elements wrapping the note lists really are divs and
>> not `<aside>` elements, or else the notes will not be visible.
>>
>> ``````lua
>> local insert = table.insert
>> local begin_notes = pandoc.RawBlock('html', '<div class="notes">')
>> local end_notes = pandoc.RawBlock('html', '</div>')
>>
>> function Div(div)
>> if not div.classes:includes('notes') then return nil end
>> local content = div.content
>> insert(content, 1, begin_notes)
>> insert(content, end_notes)
>> return content
>> end
>> ``````
>>
>> The command for running pandoc should then look something like this
>> (adjusted for the version of reveal.js your version of Pandoc needs):
>>
>> ``````shell
>> pandoc notes.md -L notes.lua -t revealjs -so notes.html --css notes.css
>> -V revealjs-url=https://unpkg.com/reve...@3.9.2/
>> <https://unpkg.com/reveal.js@3.9.2/>
>> ``````
>>
>> Archive with files attached!
>>
>>
>> --
> You received this message because you are subscribed to the Google Groups
> "pandoc-discuss" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
> To view this discussion on the web visit
> https://groups.google.com/d/msgid/pandoc-discuss/7c5ae003-b078-442f-b7ac-584614ccdee7n%40googlegroups.com
> <https://groups.google.com/d/msgid/pandoc-discuss/7c5ae003-b078-442f-b7ac-584614ccdee7n%40googlegroups.com?utm_medium=email&utm_source=footer>
> .
>

-- 
You received this message because you are subscribed to the Google Groups "pandoc-discuss" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pandoc-discuss+unsubscribe-/JYPxA39Uh5TLH3MbocFF+G/Ez6ZCGd0@public.gmane.org
To view this discussion on the web visit https://groups.google.com/d/msgid/pandoc-discuss/CADAJKhA9m84ZVXUqVjt1Z9CS-6xm6AqjMob0sjg7Z%2B_rMeD8cw%40mail.gmail.com.

[-- Attachment #2: Type: text/html, Size: 8849 bytes --]