skylighting: syntax highlighting library

[ gpl, library, text ] [ Propose Tags ]

Skylighting is a syntax highlighting library with support for over one hundred languages. It derives its tokenizers from XML syntax definitions used by KDE's KSyntaxHighlighting framework, so any syntax supported by that framework can be added. An optional command-line program is provided. Skylighting is intended to be the successor to highlighting-kate.


[Skip to Readme]

Flags

Automatic Flags
NameDescriptionDefault
bootstrap

Only build skylighting-extract

Disabled
executable

Build skylighting CLI tool

Disabled

Use -f <flag> to enable a flag, or -f -<flag> to disable that flag. More info

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

Versions [RSS] 0.1.0.0, 0.1.0.1, 0.1.1, 0.1.1.1, 0.1.1.2, 0.1.1.3, 0.1.1.4, 0.1.1.5, 0.2, 0.3, 0.3.1, 0.3.2, 0.3.3, 0.3.3.1, 0.3.4, 0.3.4.1, 0.3.5, 0.4, 0.4.1, 0.4.2, 0.4.3, 0.4.3.1, 0.4.3.2, 0.4.4, 0.4.4.1, 0.5, 0.5.0.1, 0.5.1, 0.6, 0.7, 0.7.0.1, 0.7.0.2, 0.7.1, 0.7.2, 0.7.3, 0.7.4, 0.7.5, 0.7.6, 0.7.7, 0.8, 0.8.1, 0.8.1.1, 0.8.1.2, 0.8.2, 0.8.2.1, 0.8.2.2, 0.8.2.3, 0.8.3, 0.8.3.1, 0.8.3.2, 0.8.3.4, 0.8.4, 0.8.5, 0.9, 0.10, 0.10.0.1, 0.10.0.2, 0.10.0.3, 0.10.1, 0.10.2, 0.10.3, 0.10.4, 0.10.4.1, 0.10.5, 0.10.5.1, 0.10.5.2, 0.11, 0.12, 0.12.1, 0.12.2, 0.12.3, 0.12.3.1, 0.13, 0.13.1, 0.13.1.1, 0.13.1.2, 0.13.2, 0.13.2.1, 0.13.3, 0.13.4, 0.13.4.1, 0.14, 0.14.1, 0.14.1.1 (info)
Change log changelog.md
Dependencies aeson, base (>=4.7 && <5.0), blaze-html (>=0.5), bytestring, case-insensitive, containers, directory, filepath, hxt, mtl, pretty-show, regex-pcre-builtin, safe, skylighting, text, utf8-string [details]
License GPL-2.0-only
Copyright (C) 2016 John MacFarlane
Author John MacFarlane
Maintainer jgm@berkeley.edu
Category Text
Home page https://github.com/jgm/skylighting
Source repo head: git clone https://github.com/jgm/skylighting.git
Uploaded by JohnMacFarlane at 2016-12-23T23:32:09Z
Distributions Arch:0.14, Debian:0.8.5, Fedora:0.13.4.1, LTSHaskell:0.14.1, NixOS:0.14.1, Stackage:0.14.1, openSUSE:0.14.1
Reverse Dependencies 11 direct, 163 indirect [details]
Executables skylighting, skylighting-extract
Downloads 100689 total (849 in the last 30 days)
Rating 2.25 (votes: 2) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2016-12-24 [all 1 reports]

Readme for skylighting-0.1.0.0

[back to package description]

skylighting

license travis build status

A Haskell syntax highlighting library with tokenizers derived from KDE XML syntax highlighting descriptions.

A command-line highlighter, skylighting, is also provided.

Motivation

This library is the successor to highlighting-kate, which had some problems that were difficult to resolve given its architecture.

In highlighting-kate, the XML syntax descriptions were converted into individual parsec parsers, which were then compiled. This made it difficult to handle IncludeRules properly without circular imports. There was also no way to load a syntax description dynamically.

Skylighting, by contrast, parses the XML syntax descriptions into Haskell data structures, which are then interpreted by a "tokenize" function. IncludeRules can now be handled properly, and users can add new syntax descriptions dynamically. It is also now possible to convert .theme files directly into styles.

Installing

To install the latest release from Hackage, do

stack install skylighting

or

cabal install skylighting

If you want the command-line tool, set the executable flag using --flag "skylighting:executable" in stack or -fexecutable in cabal.

The release tarballs include generated files not present in this repository. Building from this repository is a two-step process. In the first step we build a program, skylighting-extract, which reads XML syntax highlighting definitions from the xml directory and writes Haskell source files. In the second we actually build the library.

Using stack:

make bootstrap
make

Using cabal:

cabal install -fbootstrap --disable-optimizations
cabal run skylighting-extract -- xml/*.xml
cabal install -f-bootstrap --disable-optimizations

Command-line tool

A command-line executable, skylighting, is installed if the executable cabal flag is set in building.

For help, skylighting --help.

Adding new syntaxes

To compile with additional syntaxes, simply add the syntax definition (XML) file to the xml directory and repeat the bootstrap build described above.

Note that both the library and the executable can dynamically load syntax definitions, so you may not need to compile them in.

License

Skylighting is licensed under the GPL, because some of the xml syntax descriptions from which its tokenizers are generated are GPL-licensed.

References

Kate syntax highlighting documentation: https://docs.kde.org/stable5/en/applications/katepart/highlight.html

Kate highlighting definitions: https://github.com/KDE/syntax-highlighting/tree/master/data/syntax