The highlighting-kate package

[ Tags: deprecated, gpl, library, text ] [ Propose Tags ]
Deprecated. in favor of skylighting

highlighting-kate is a syntax highlighting library with support for over fifty 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

Versions 0.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, 0.6.1, 0.6.2, 0.6.2.1, 0.6.3, 0.6.4
Change log changelog
Dependencies base (<5), containers, filepath, parsec (<3), pcre-light, xhtml [details]
License GPL
Author John MacFarlane
Maintainer jgm@berkeley.edu
Category Text
Home page http://johnmacfarlane.net/highlighting-kate
Uploaded Sat Jul 4 07:21:17 UTC 2009 by JohnMacFarlane
Distributions Debian:0.6.1, Fedora:0.6.4, FreeBSD:0.6, LTSHaskell:0.6.4, NixOS:0.6.4, Stackage:0.6.4, Tumbleweed:0.6.4
Executables Highlight
Downloads 78122 total (392 in the last 30 days)
Rating (no votes yet) [estimated by rule of succession]
Your Rating
  • λ
  • λ
  • λ
Status Docs uploaded by user
Build status unknown [no reports yet]
Hackage Matrix CI

Modules

[Index]

Flags

NameDescriptionDefaultType
splitbase

Choose the new, smaller, split-up base package.

EnabledAutomatic
executable

Build the Highlight executable.

DisabledAutomatic

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

Downloads

Maintainer's Corner

For package maintainers and hackage trustees


Readme for highlighting-kate-0.2.5

[back to package description]
highlighting-kate is a Haskell source code highlighting library, based
on Kate's syntax description files (http://kate-editor.org/).

Currently, the following languages are supported:

Ada, Asp, Awk, Bash, Bibtex, C, Cmake, Coldfusion, Commonlisp, Cpp, Css,
D, Djangotemplate, Doxygen, Dtd, Eiffel, Erlang, Fortran, Haskell,
Html, Java, Javadoc, Javascript, Json, Latex, Lex, LiterateHaskell, Lua,
Makefile, Matlab, Mediawiki, Modula3, Nasm, Objectivec, Ocaml, Pascal,
Perl, Php, Postscript, Prolog, Python, RelaxNG compact, Rhtml, Ruby,
Scala, Scheme, Sgml, Sql, SqlMysql, SqlPostgresql, Tcl, Texinfo, Xml,
Xslt, Yacc

To install:

    runghc Setup.lhs configure
    runghc Setup.lhs build 
    runghc Setup.lhs haddock    # optional, if you want library documentation
    runghc Setup.lhs install    # as root, or specify --user 

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:

    runghc Setup.lhs configure -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:

    runghc ParseSyntaxFiles.hs xml

Note that ParseSyntaxFiles.hs requires the HXT package.

You can browse the available Kate syntax highlighting files at

    http://kate-editor.org/downloads/syntax_highlighting

or retrieve them all using Subversion:

    svn co svn://anonsvn.kde.org/home/kde/trunk/KDE/kdelibs/kate/syntax/data kate-data 

There is information on the syntax highlighting definitions at

    http://kate-editor.org/article/writing_a_kate_highlighting_xml_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):

- javascript.xml:  Fixed regex \s* (which matches empty string) by changes to DetectSpaces
- perl.xml:  Fixed regexes - needed backslash-escapes before ] and ^
- haskell.xml:  Added support for module names
- bash.xml: Changed "\\" to "\" in two Detect2Char rules in FindString
- literate-haskell.xml:  Fixed single line comments and growing context stack

NOTE:  This software is largely untested.  Known bugs are recorded in the file
BUGS. Please send bug reports (or better, patches) to the author (jgm at
berkeley dot edu).