Discourse components
These are the Discourse plugins for our Hugo syntax highlighting modules
We wrap the highlighting components in a Discourse theme component - the easiest point to start.
This is a brief overview of the Discourse plugins. For details on the grammars, check the documentation for these.
Disclaimer
The plugins are provided AS-IS and only tested with the below dev installation of Discourse.
If these don’t work for you, we’re most likely not able to support.
- totally bare with anything around Discourse (just an end user). Our full Discourse knowledge is shown within the plugin.
Discourse theme components
We provide ready to use Discourse theme components to load into your Instance.
Installation:
you must have Highlight.js configured in your Instance
create a new Theme Component
either grab the zip from the our Releases page and import.
or
download the above zip and just copy the content of the
theme-initializer.gjsto the JS section of your Theme component.To style the custom scopes add your stylesheet to the CSS section.
Discourse Requirements
Actually No idea - Here’s how we installed a development version:
Windows 11 Professional
WSL2 - Ubuntu 22.04
Installed using this guide: Install a DEV Environment on Windows 11 resulting in a runnable developer installation version 3.6.0.beta3-latest (end Oct 2025)
Add Theme Component add language using theme component to add the plugin
API mentioned here. That’s a post from Jan 2019, so we expect most Instances will support it.
License
This package is released under the MIT License. See LICENSE file for details.
Author & Maintainer
- Irkode irkode@rikode.de
Links
- highlightjs-hugo : The main repository with additional grammars and plugins. Have a look
- Highlight.js : The Internet’s favorite JavaScript syntax highlighter supporting Node.js and the web
- Hugo : The world’s fastest framework for building websites
- Go HTML template : Go’s html template package
- Go TEXT template : Go’s text template package