Version 28 (modified by 17 years ago) ( diff ) | ,
---|
This page documents the 1.4 (latest stable) release. Documentation for other releases can be found here.
Syntax Coloring of Source Code
Trac supports language-specific syntax highlighting of source code in wiki formatted text and the repository browser.
To do this, Trac uses external libraries with support for a great number of programming languages.
Currently Trac supports syntax coloring using one or more of the following packages:
To activate syntax coloring, simply install either one (or more) of these packages. No additional configuration is required, however to modify the colors, have a look at trac/htdocs/css/code.css
.
If you don't know why trac isnt detecting an installed library, try turning on Trac logging. It actually appears that Trac is currently broken with SilverCity. You need an older version of SilverCity. http://trac.edgewall.org/wiki/TracFaq#why-is-my-css-code-not-being-highlighted-even-though-i-have-silvercity-installed
Some people also talk about trying this out: http://trac-hacks.org/svn/tracpygmentsplugin/0.11/
When in use, Trac will automatically prioritize SilverCity highlighting over Enscript if possible, (see note below).
If neither package is available, Trac will display the data as plain text.
Note: Enscript supports a greater number of languages, however SilverCity is generally faster since it is a library and isn't executed in an external process.
About SilverCity
SilverCity uses the lexer from Scintilla. Scintilla supports more languages than SilverCity implements. If you want to add a language to SilverCity supported by Scintilla, it's not very difficult. See SilverCityAddLanguage for some information how.
Syntax Coloring Support
SilverCity | Enscript | |
Ada | X | |
Asm | X | |
* ASP | X | X |
* C | X | X |
* C# | X(2) | |
* C++ | X | X |
* Java | X(4) | X |
Awk | X | |
CSS | X | |
Diff | X | |
Eiffel | X | |
Elisp | X | |
Fortran | X(3) | |
Haskell | X | |
HTML | X | X |
IDL | X | |
Javascript | X | X |
m4 | X | |
Makefile | X | |
Matlab | X (5) | |
Objective-C | X | |
Pascal | X | |
* Perl | X | X |
* PHP | X | X |
PSP | X | |
Pyrex | X | |
* Python | X | X |
* Ruby | X | X (1) |
Scheme | X | |
Shell | X | |
SQL | X | X |
Troff | X | |
TCL | X | |
Tex | X | |
Verilog | X(4) | X |
VHDL | X | |
Visual Basic | X | |
VRML | X | |
XML | X |
(*) Supported as inline code blocks in Wiki text using WikiProcessors.
(1) Ruby highlighting is not included in the Enscript distribution. Highlighting rules for Ruby can be obtained from: http://neugierig.org/software/ruby/
(2) C# highlighting is not included in the Enscript distribution. Highlighting rules for C# can be obtained from: http://wiki.hasno.info/index.php/Csharp.st
(3) Fortran: as packaged, Enscript only supports the fixed source form. Highlighting rules for Fortran 90x/2003 can be obtained from: http://wiki.hasno.info/index.php/F90.st
(4) since Silvercity 0.9.7 released on 2006-11-23
(5) By default .m
files are considered Objective-C files. In order to treat .m
files as MATLAB files, edit api.py
and make the necessarily adjustments. Need to map .m
to text/x-matlab
.
Extra Software
- GNU Enscript — http://directory.fsf.org/GNU/enscript.html
- GNU Enscript for Windows — http://gnuwin32.sourceforge.net/packages/enscript.htm
- SilverCity — http://silvercity.sf.net/
See also: WikiProcessors, WikiFormatting, TracWiki, TracBrowser