Pagedown: Footnote in the TOC (html_paged)

Created on 26 Jan 2019  路  6Comments  路  Source: rstudio/pagedown

It is exciting to start a new book with pagedown! Many thanks! I found a small issue: when footnotes are inserted in the chapter or section titles, they are supposed to appear only in the body. How could they avoid appearing at the bottom margins of the TOC pages?

Furthermore, it seems that the texts in the footnotes occupy some space in the TOC before rendered into the foot, resulting in large spaces in TOC pages.

An example could be found in my book; https://www.pzhao.org/book/r100q/

Most helpful comment

@jdbarillas @pzhaonet I guess nobody wants duplicated footnotes in table of contents.
I've pushed https://github.com/rstudio/pagedown/commit/e7d8b07caef91eea43f1af01b3e439e95def792a to remove them.

Sorry for the delay.

All 6 comments

Thanks for opening this issue. As stated in the documentation, the footnotes support is still experimental and your feedback is extremely useful.
Is the Rmd source file available? It would help us to find a solution.

Thanks for the fast response. The Rmd source is here: https://www.pzhao.org/book/r100q/r100q.rmd. BTW, the page numbers of the titles with footnotes in TOC are wrong as well.

Please don't be too stressed about this issue. I don't think people often write books like this. Maybe footnotes in titles is not a good style. I will move them away from titles.

In case of the updates of my book, here is a screenshot showing the problems, including the wrong page number, the large blank area, and the footnotes which should appear only in the body rather than in TOC.

2019-01-27-001

  • The wrong page numbers is a duplicate of #35
  • The large blank area is a side-effect of the experimental footnotes support we introduced in pagedown (paged.js does not support footnotes for now). The footnotes handler used in pagedown is a dirty hack and is far from perfect: I will write a technical post for pagedmedia.org to detail its mechanism and its side-effects. Introducing a native support is on the roadmap of the paged.js project. However, it is a huge technical challenge.
  • It would be easy to detect and remove footnotes in TOC. Would it be OK for you?

I'm running into the same issue of the footnote being in the TOC. What would be the easiest way to detect and remove it?

@jdbarillas @pzhaonet I guess nobody wants duplicated footnotes in table of contents.
I've pushed https://github.com/rstudio/pagedown/commit/e7d8b07caef91eea43f1af01b3e439e95def792a to remove them.

Sorry for the delay.

Was this page helpful?
0 / 5 - 0 ratings

Related issues

lgnbhl picture lgnbhl  路  4Comments

filippogambarota picture filippogambarota  路  3Comments

mr-illington picture mr-illington  路  3Comments

AnabelleLaurent picture AnabelleLaurent  路  4Comments

xf15 picture xf15  路  3Comments