Feature request: "on this page" mini TOC

[noamtamim]

As seen on Leap Day.

I prefer this theme visually, but the on-this-page TOC is a nice touch.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[stale]

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

[jmini]

In the "Leap Day" theme, this is solved with javascript (based on jquery).
Relevant parts:

An empty list is added in the layout file:

https://github.com/pages-themes/leap-day/blob/af5c3638f65f80f9baca1ece30017cf55f91cf1e/_layouts/default.html#L40-L42

And a script loads the TOC and add the list items:

https://github.com/pages-themes/leap-day/blob/af5c3638f65f80f9baca1ece30017cf55f91cf1e/assets/js/main.js#L16-L28

This script is registered in layout:

https://github.com/pages-themes/leap-day/blob/af5c3638f65f80f9baca1ece30017cf55f91cf1e/_layouts/default.html#L9-L10

---

See also this pages-themes/cayman#16 (comment) where {:toc} is mentioned.

[jmini]

I did not managed to use the {:toc} inside the default.html layout file, even with the inputs from jekyll/jekyll#5843

---

At the end I have switched to jekyll-toc, a solution built on top of the liquid templating engine.

This works well on GitHub pages.