Adaptation of ideas described by Michiel Borkent in "Writing a Clojure Highlighter from Scratch". Uses rewrite-clj to parse Clojure source code and forms, and leverages multimethods to allow for user-extensibility.

If you want to add syntax highlighting to your project without using a JavaScript library like Prism or Highlight.js and you use Hiccup to generate HTML, this library might help you. I wrote it in part because I wanted more control over how my source code was displayed in HTML and CSS while developing fabricate - which this code was factored out of - than was allowed by other tools.

More broadly, I don't think Clojure should have to rely on other language ecosystems for good display of our source code. I think it can be done better in Clojure, because Clojure code is Clojure data and we have powerful facilities for working with it, especially with the widespread use of the excellent rewrite-clj library.

• Glow is another server-side syntax highlighting library for Clojure. It only runs on the JVM because it uses ANTLR to parse Clojure. It also uses Enlive instead of Hiccup for its intermediate representation of parsed Clojure code.
• Clygments wraps the Pygments Python library, which obviously means this library introduces a dependency on Python.

Pre-alpha. Moving towards a stable API, but does not yet have clearly defined contracts.

The site.fabricate.adorn.forms namespace has a fairly complete set of functions that are used as building blocks.

• CLJC compatibility; generation of Hiccup forms using:
  • Clojure
  • ClojureScript
  • Babashka
• provide sensible defaults and an example of styling using plain CSS
  • including at least one useful Flexbox example
• provide an override mechanism for users who want to display particular forms in special ways
• provide an extension mechanism for special symbols (e.g. def, defn, def-my-custom-def)
• compatibility across Hiccup implementations

• Conversion of Hiccup to HTML. While this conversion will be necessary in order to verify the output of adorn, this will strictly be a dev-time dependency. What generates HTML from the Hiccup produced by adorn is up to the user.
• Validation of output HTML.
• Support for other languages.

Licensed under the MIT license.

Assuming that the Clojure CLI is installed:

To execute the project's tests:

clojure -X:dev:test

Assuming that npm (globally) and shadow-cljs (locally) are installed:

To execute the project's tests:

npx shadow-cljs compile test

• Thanks to (Michiel Borkent)[https://github.com/borkdude] for the initial idea and excellent writeup
• Thanks to (Lee Read)[https://github.com/lread], Michiel Borkent and the other contributors to rewrite-clj for such an excellent library, and for answering my questions about it - this library wouldn't be possible without the well-designed machinery that rewrite-clj provides.
• Thanks to John Newman for answering my novice questions about CLJS.
• Oleksandr Yakushev has written a plethora of invaluable tools and information that helped me measure the performance of this code in a rigorous way.