Three tiny Ghost plugins: floating TOC, reading progress bar, and giscus comments anywhere

Share & showcase
1

Hi everyone,

I have been building a few small, dependency-free plugins for Ghost that add common niceties with a single line of code injection. No theme editing, no build step, and nothing to self-host since they load from a CDN. They are all open source (MIT), so I wanted to share them here in case they are useful:

  • ghost-toc-plugin adds a floating table of contents that reads your post headings and tracks your scroll position, folding away on narrow screens.

  • ghost-progress-plugin shows a thin reading progress bar at the top (or bottom) of the page, coloured to match your theme accent by default.

  • ghost-giscus-plugin keeps the official giscus script as it is and just lets you choose where comments mount, for example right after the post or in place of the theme’s native comments block.

Each one is a copy-paste snippet under Settings, Code injection. I put everything on one page with live demos, options you can tweak, and the exact install code for all three:

Feedback and bug reports are very welcome. Hope they help someone.

1 Like
2

This is including the previous TOC plugin written here,

3

Couple of notes:

  • I tried the TOC plugin when you first wrote about it, thought it wasn’t working – but turns out, the text in the TOC is the same color as the background. When I highlighted it, I could see it.
  • I went to the demo sites and didn’t see the progress bar. I assume you would have to freeze the top of the window for the bar to show up?

Interested still, though.

4

Thanks for the notes!

I will change the default color and also add a way to custom similar to accent color. For the progress things, a fixed nav could block the progress bar, and also looking for a way what is the best option for this.

1 Like