The highlighting-kate package

[Tags: gpl, library]

highlighting-kate is a syntax highlighting library with support for nearly one hundred languages. The syntax parsers are automatically generated from Kate syntax descriptions (http://kate-editor.org/), so any syntax supported by Kate can be added. An (optional) command-line program is provided, along with a utility for generating new parsers from Kate XML syntax descriptions.


[Skip to ReadMe]

Properties

Versions0.2, 0.2.1, 0.2.3, 0.2.4, 0.2.5, 0.2.5.1, 0.2.6, 0.2.6.1, 0.2.6.2, 0.2.7, 0.2.7.1, 0.2.8.1, 0.2.8.2, 0.2.9, 0.2.10, 0.3, 0.3.1, 0.4, 0.5, 0.5.0.1, 0.5.0.2, 0.5.0.3, 0.5.0.4, 0.5.0.5, 0.5.0.6, 0.5.1, 0.5.2, 0.5.3, 0.5.3.1, 0.5.3.2, 0.5.3.3, 0.5.3.4, 0.5.3.5, 0.5.3.6, 0.5.3.7, 0.5.3.8, 0.5.3.9, 0.5.4, 0.5.5, 0.5.5.1, 0.5.6, 0.5.6.1, 0.5.7, 0.5.7.1, 0.5.8, 0.5.8.1, 0.5.8.2, 0.5.8.3, 0.5.8.4, 0.5.8.5, 0.5.9, 0.5.10, 0.5.11, 0.5.11.1, 0.5.12, 0.5.13, 0.5.14, 0.5.15, 0.6
Change logchangelog
Dependenciesbase (<5), blaze-html (>=0.4.2 && <0.8), containers, filepath, highlighting-kate, mtl, parsec, pcre-light (==0.4.*), regex-pcre-builtin (>=0.94.4.8.8.35), utf8-string [details]
LicenseGPL
AuthorJohn MacFarlane
Maintainerjgm@berkeley.edu
CategoryText
Home pagehttp://github.com/jgm/highlighting-kate
Source repositoryhead: git clone git://github.com/jgm/highlighting-kate.git
ExecutablesHighlight
UploadedThu Jun 19 18:51:03 UTC 2014 by JohnMacFarlane
DistributionsDebian:0.6, Fedora:0.5.11.1, FreeBSD:0.6, LTSHaskell:0.6, NixOS:0.6, Stackage:0.6
Downloads68294 total (1271 in last 30 days)
Votes
0 []
StatusDocs available [build log]
Successful builds reported [all 1 reports]

Modules

[Index]

Flags

NameDescriptionDefaultType
splitbaseChoose the new, smaller, split-up base package.EnabledAutomatic
executableBuild the Highlight executable.DisabledAutomatic
pcre-lightUse the pcre-light library instead of regex-pcre-builtinDisabledAutomatic

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

Downloads

Maintainers' corner

For package maintainers and hackage trustees

Readme for highlighting-kate-0.5.8.3

highlighting-kate

A Haskell source code highlighting library, based on Kate's syntax description files (http://kate-editor.org/). It can produce both HTML and LaTeX output.

Currently, the following languages/formats are supported:

To install, use the cabal tool:

cabal install

Note: If you have checked out the source from the darcs repository, you will first need to do:

make prep

which generates some of the needed source files from xml syntax definitions.

If you get a linking error with GHC 7 on Mac OS X, "scattered reloc r_address too large for inferred architecture i386," the workaround is to use the flag --disable-library-for-ghci when you cabal install.

To generate the documentation:

cabal haddock

For an example of the use of the library, see Highlight.hs. To compile this program along with the library, specify the 'executable' flag in the configure step above:

cabal install -fexecutable

To run Highlight, specify the language name using -s:

Highlight -s haskell Highlight.hs > example.html

If you don't specify a language name, Highlight will try to guess it from the file extension. Highlight can also be used as a pipe, reading input from STDIN. For other options,

Highlight --help

Styling is done using span tags. The Highlight program will include default styles in the generated HTML, unless a link to a CSS file is provided using the '--css' option. Some sample CSS files can be found in the css directory. These use generic class names (Normal, Keyword, DataType, DecVal, BaseN, Float, Char, String, Comment, Function, Others, Alert, Error). For more fine-grained highlighting, users may wish to create their own CSS files that use language-specific classes.

The parsers in Text/Highlighting/Kate/Syntax were automatically generated from the Kate syntax definitions in the xml directory. You may modify the xml files in this directory, or add new ones, and then regenerate the parsers by doing:

make prep

or

runghc ParseSyntaxFiles.hs xml

Note that ParseSyntaxFiles.hs requires the HXT package (>= 9.0.0).

To get the current Kate syntax highlighting files, clone the kate repository:

git clone git://anongit.kde.org/kate

The syntax definitions can then be found in

kate/part/syntax/data

There is information on the syntax highlighting definitions at http://docs.kde.org/stable/en/applications/kate/highlight.html. See also http://kate-editor.org/2005/03/24/writing-a-syntax-highlighting-file/.

Thanks are due to all the authors of these syntax definitions.

Changes have been made to the following xml files (the originals have been left in the directory, with .bkp extensions):