Hackage :: [Package]

highlighting-kate: Syntax highlighting

[ deprecated, library, text ] [ Propose Tags ] [ Report a vulnerability ]
Deprecated in favor of skylighting

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]

Flags

Automatic Flags
NameDescriptionDefault
splitbase

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

Enabled
executable

Build the highlighting-kate executable.

Disabled
pcre-light

Use the pcre-light library instead of regex-pcre-builtin

Disabled

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

Downloads

Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 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 (<3 || >=4.4 && <5), blaze-html (>=0.4.2 && <0.9), containers, filepath, highlighting-kate, mtl, parsec, pcre-light (>=0.4 && <0.5), regex-pcre-builtin (>=0.94.4.8.8.35), utf8-string [details]
License LicenseRef-GPL
Author John MacFarlane
Maintainer jgm@berkeley.edu
Revised Revision 1 made by AdamBergmark at 2015-06-15T14:17:01Z
Category Text
Home page http://github.com/jgm/highlighting-kate
Source repo head: git clone git://github.com/jgm/highlighting-kate.git
Uploaded by JohnMacFarlane at 2015-05-27T00:01:40Z
Distributions Debian:0.6.4, FreeBSD:0.6
Reverse Dependencies 14 direct, 163 indirect [details]
Executables highlighting-kate
Downloads 123710 total (18 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2015-05-27 [all 1 reports]

Readme for highlighting-kate-0.6

[back to package description]

highlighting-kate

A Haskell source code highlighting library, based on Kate's syntax description files (http://kate-editor.org/), now part of the KDE Framework's "KTextEditor" component. It can produce both HTML and LaTeX output.

Currently, the following languages/formats are supported:

  • Abc
  • Actionscript
  • Ada
  • Agda
  • Apache
  • Asn1
  • Asp
  • Awk
  • Bash
  • Bibtex
  • Boo
  • C
  • Changelog
  • Clojure
  • Cmake
  • Coffeescript
  • Coldfusion
  • Commonlisp
  • Cpp
  • Cs
  • Css
  • Curry
  • D
  • Diff
  • Djangotemplate
  • Dockerfile
  • Dot
  • Doxygen
  • Dtd
  • Eiffel
  • Email
  • Erlang
  • Fasm
  • Fortran
  • Fsharp
  • Gcc
  • Glsl
  • Gnuassembler
  • Go
  • Haskell
  • Haxe
  • Html
  • Idris
  • Ini
  • Isocpp
  • Java
  • Javadoc
  • Javascript
  • Json
  • Jsp
  • Julia
  • Latex
  • Lex
  • Lilypond
  • LiterateCurry
  • LiterateHaskell
  • Lua
  • M4
  • Makefile
  • Mandoc
  • Markdown
  • Mathematica
  • Matlab
  • Maxima
  • Mediawiki
  • Metafont
  • Mips
  • Modula2
  • Modula3
  • Monobasic
  • Nasm
  • Noweb
  • Objectivec
  • Objectivecpp
  • Ocaml
  • Octave
  • Opencl
  • Pascal
  • Perl
  • Php
  • Pike
  • Postscript
  • Prolog
  • Pure
  • Python
  • R
  • Relaxng
  • Relaxngcompact
  • Rest
  • Rhtml
  • Roff
  • Ruby
  • Rust
  • Scala
  • Scheme
  • Sci
  • Sed
  • Sgml
  • Sql
  • SqlMysql
  • SqlPostgresql
  • Tcl
  • Tcsh
  • Texinfo
  • Verilog
  • Vhdl
  • Xml
  • Xorg
  • Xslt
  • Xul
  • Yacc
  • Yaml
  • Zsh

To install, use the cabal tool:

cabal install

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

make prep

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

To generate the documentation:

cabal haddock

To run the test suite:

cabal test

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

cabal install -fexecutable

To run highlighting-kate, specify the language name using -s:

highlighting-kate -s haskell highlighting-kate.hs > example.html

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

highlighting-kate --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 ktexteditor repository:

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

The syntax definitions can then be found in

src/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 (diffs have been left in the directory, with .patch extensions):

  • haskell.xml: Small changes to mapping of styles to token types.

  • lua.xml: Variables and constants highlighted as "normal", not keywords.

  • perl.xml: Small regex change due to differences in regex engines.

  • php.xml: Added fallthrough so <?php prefix not needed.

  • tcsh.xml: Replace invalid character assignment(?) of regex '\s' with ' '.

  • base report bugs on the GitHub issue tracker: https://github.com/jgm/highlighting-kate/issues.