public inbox archive for pandoc-discuss@googlegroups.com
 help / color / mirror / Atom feed
From: anna ecke <0x616e6e6165636b65-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
To: pandoc-discuss <pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
Subject: Re: Footnotes in revealjs slides
Date: Wed, 16 Sep 2020 01:32:31 -0700 (PDT)	[thread overview]
Message-ID: <80c14e28-b0eb-45f9-bb2b-de429980d60bn@googlegroups.com> (raw)
In-Reply-To: <7c5ae003-b078-442f-b7ac-584614ccdee7n-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>


[-- Attachment #1.1: Type: text/plain, Size: 5241 bytes --]

I'm sorry, but I just realized that the conversation, I stared is a 
duplicate 
<https://groups.google.com/forum/#!searchin/pandoc-discuss/footnotes|sort:date/pandoc-discuss/jtVtYbMNnIw/BgQfdEFvGAAJ>
.

anna ecke schrieb am Dienstag, 15. September 2020 um 23:50:00 UTC+2:

> 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.
>
> 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/80c14e28-b0eb-45f9-bb2b-de429980d60bn%40googlegroups.com.

[-- Attachment #1.2: Type: text/html, Size: 7175 bytes --]

  parent reply	other threads:[~2020-09-16  8:32 UTC|newest]

Thread overview: 7+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2020-09-13 22:00 anna ecke
     [not found] ` <fb3c3c10-e5bb-4a2b-9d26-0a9f358805edo-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
2020-09-14 12:17   ` Benct Philip Jonsson
     [not found]     ` <47eee52e-3d47-7830-97bf-68d21c6c2bf8-Re5JQEeQqe8AvxtiuMwx3w@public.gmane.org>
2020-09-15 21:49       ` anna ecke
     [not found]         ` <7c5ae003-b078-442f-b7ac-584614ccdee7n-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
2020-09-16  8:32           ` anna ecke [this message]
2020-09-16 14:34           ` BPJ
     [not found]             ` <CADAJKhA9m84ZVXUqVjt1Z9CS-6xm6AqjMob0sjg7Z+_rMeD8cw-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org>
2020-09-16 22:36               ` anna ecke
     [not found]                 ` <565a2869-820c-4919-89b9-4f3aa8c5dd31n-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org>
2020-09-17  7:58                   ` Benct Philip Jonsson

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

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=80c14e28-b0eb-45f9-bb2b-de429980d60bn@googlegroups.com \
    --to=0x616e6e6165636b65-re5jqeeqqe8avxtiumwx3w@public.gmane.org \
    --cc=pandoc-discuss-/JYPxA39Uh5TLH3MbocFFw@public.gmane.org \
    /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.
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 NNTP newsgroup(s).