Multi-line content (e.g. source blocks) inside a footnote

Previous Topic Next Topic
 
classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

Multi-line content (e.g. source blocks) inside a footnote

polettix
Hi! First and foremost, thank you all for asciidoctor!

I need to add code blocks in footnotes and I'm running short of ideas, because it seems that it's not possible to put multi-line content inside a footnote.

This is what I tried:

See source below.footnote:[
[source]
----
hello
----
]


See something below.footnote:[
----
hello
----
]


Salutation below.footnote:[Hello

all]

and this is what I obtained:

footnote outcome

In all cases, the footnote: text appears in the generated stuff, instead of triggering the processing as I was naively expecting.

Is there any workaround that can be adopted? Thanks!

Reply | Threaded
Open this post in threaded view
|

Re: Multi-line content (e.g. source blocks) inside a footnote

polettix
A similar issue is answered here: http://discuss.asciidoctor.org/footnotes-with-paragraph-breaks-tp4130.html

I wonder what was wrong with the question... too detailed?
Reply | Threaded
Open this post in threaded view
|

Re: Multi-line content (e.g. source blocks) inside a footnote

mojavelinux
Administrator
Code blocks don't belong in footnotes and are therefore not allowed. A footnote is a note, it is not content. If you need to do something more elaborate, then it is very likely a sidebar (or some other structural problem in the content itself that is necessitating such an arrangement of information).

I'm fairly firm about footnotes because there is a tendency to want to use them for the wrong purpose, and I want to guide authors to create documents with good semantics.

-Dan

On Sun, Jan 3, 2016 at 4:49 PM, polettix [via Asciidoctor :: Discussion] <[hidden email]> wrote:
A similar issue is answered here: http://discuss.asciidoctor.org/footnotes-with-paragraph-breaks-tp4130.html

I wonder what was wrong with the question... too detailed?



If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Multi-line-content-e-g-source-blocks-inside-a-footnote-tp4024p4140.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen
Reply | Threaded
Open this post in threaded view
|

Re: Multi-line content (e.g. source blocks) inside a footnote

mojavelinux
Administrator
In reply to this post by polettix
To clarify, footnotes are for inline text only. They cannot hold blocks (even though I have shown a workaround for multiple paragraphs, which I think is the absolute extreme of what should be allowed).

Cheers,

-Dan

On Sun, Jan 3, 2016 at 5:28 PM, Dan Allen <[hidden email]> wrote:
Code blocks don't belong in footnotes and are therefore not allowed. A footnote is a note, it is not content. If you need to do something more elaborate, then it is very likely a sidebar (or some other structural problem in the content itself that is necessitating such an arrangement of information).

I'm fairly firm about footnotes because there is a tendency to want to use them for the wrong purpose, and I want to guide authors to create documents with good semantics.

-Dan

On Sun, Jan 3, 2016 at 4:49 PM, polettix [via Asciidoctor :: Discussion] <[hidden email]> wrote:
A similar issue is answered here: http://discuss.asciidoctor.org/footnotes-with-paragraph-breaks-tp4130.html

I wonder what was wrong with the question... too detailed?



If you reply to this email, your message will be added to the discussion below:
http://discuss.asciidoctor.org/Multi-line-content-e-g-source-blocks-inside-a-footnote-tp4024p4140.html
To start a new topic under Asciidoctor :: Discussion, email [hidden email]
To unsubscribe from Asciidoctor :: Discussion, click here.
NAML



--
Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen



--
Dan Allen | @mojavelinux | http://google.com/profiles/dan.j.allen