jekyll-toc icon indicating copy to clipboard operation
jekyll-toc copied to clipboard

Is Github Pages not supported?

Open Pathsis opened this issue 4 years ago • 3 comments

Oddly, on Github Pages, it doesn't work. When I deployed Github Pages to Vercel simultaneously, it worked. Now, if you open the Github Pages page, there is no TOC, but if you open the Vercel page, there is TOC.

Pathsis avatar Nov 26 '21 08:11 Pathsis

It's been a long while since, but hopefully this helps someone else too

"GitHub Pages cannot build sites using unsupported plugins. If you want to use unsupported plugins, generate your site locally and then push your site's static files to GitHub."

What I've done to use jekyll-toc is that I built locally and deployed on a separate branch with the _site directory as root, it's funky but works perfectly!

chuangcaleb avatar May 30 '22 14:05 chuangcaleb

With GitHub Actions builds in Pages now, this works if you deploy using an actions workflow (e.g. the Jekyll template workflow).

osfanbuff63 avatar Aug 11 '22 19:08 osfanbuff63

Here is a very simple solution: allejo/jekyll-toc

Another solution is through generating the site's static files and pushing them to Github: Use jekyll-toc plugin on Github Pages posted by David Dong.

Deep0Thinking avatar Feb 27 '23 10:02 Deep0Thinking