Jekyll Anchor Headings

Overview

The article discusses a solution for generating static heading anchors for Jekyll websites. It explains that while Jekyll websites can't run custom plugins on GitHub pages, users can still use JavaScript solutions to inject anchors for headings. However, this may not work if users have JavaScript disabled on their browsers. As an alternative, the article presents a Liquid snippet that modifies the generated HTML to inject anchors directly. It also highlights several websites that are already using this solution.

Features

• Generates static heading anchors for Jekyll websites without relying on JavaScript
• Allows users to include a Table of Contents in their Jekyll layouts without JavaScript or a plugin
• Highly customizable with available parameters to change the behavior of the snippet
• Does not force any specific method of handling accessibility, allowing developers to handle it as they prefer
• Can be configured to be accessible as seen in examples in the wiki
• Can be customized to add icons or screen reader-friendly markup to the anchors

Summary

This article presents a solution for generating static heading anchors for Jekyll websites without relying on JavaScript. It provides a Liquid snippet that modifies the HTML output to include anchors directly. The solution is highly customizable and can be used to include a Table of Contents without JavaScript or a plugin. Developers have the flexibility to handle accessibility in their preferred way using this solution. The article also highlights several websites that are already using this approach.