annotate examples/trac/wiki-default/TracSyntaxColoring @ 39:93b4dcbafd7b trunk

Copy Trac to main branch.
author cmlenz
date Mon, 03 Jul 2006 18:53:27 +0000
parents
children
rev   line source
39
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
1 = Syntax Coloring of Source Code =
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
2 Trac supports language-specific syntax highlighting of source code in [wiki:WikiFormatting wiki formatted] text and the [wiki:TracBrowser repository browser].
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
3
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
4 To do this, Trac uses external libraries with support for a great number of programming languages.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
5
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
6 Currently Trac supports syntax coloring using one or more of the following packages:
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
7
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
8 * [http://people.ssh.fi/mtr/genscript/ GNU Enscript]
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
9 * [http://silvercity.sourceforge.net/ SilverCity]
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
10
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
11 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`.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
12
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
13 When in use, Trac will automatically prioritize !SilverCity highlighting over Enscript if possible, (see note below).
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
14
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
15 If neither package is available, Trac will display the data as plain text.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
16
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
17 '''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.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
18
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
19 === About SilverCity ===
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
20 !SilverCity uses the lexer from [http://www.scintilla.org/ 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 [http://projects.edgewall.com/trac/wiki/SilverCityAddLanguage SilverCityAddLanguage] for some information how.
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
21
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
22
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
23 == Syntax Coloring Support ==
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
24
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
25 || || !SilverCity || Enscript ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
26 || Ada || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
27 || Asm || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
28 || * ASP || X || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
29 || * C || X || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
30 || * C++ || X || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
31 || * Java || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
32 || Awk || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
33 || CSS || X || ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
34 || Diff || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
35 || Eiffel || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
36 || Elisp || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
37 || Fortran || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
38 || Haskell || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
39 || HTML || X || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
40 || IDL || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
41 || Javascript || X || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
42
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
43 || m4 || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
44 || Makefile || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
45 || Matlab || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
46 || Objective-C|| || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
47 || Pascal || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
48 || * Perl || X || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
49 || * PHP || X || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
50 || PSP || X || ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
51 || Pyrex || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
52 || * Python || X || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
53 || * Ruby || X || X (1) ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
54 || Scheme || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
55 || Shell || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
56 || SQL || X || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
57 || Troff || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
58 || TCL || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
59 || Tex || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
60 || Verilog || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
61 || VHDL || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
62 || Visual Basic |||| X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
63 || VRML || || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
64 || XML || X || X ||
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
65
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
66 ''(*) Supported as inline code blocks in [wiki:WikiFormatting Wiki text] using WikiProcessors.''
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
67
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
68 ''(1) Ruby highlighting is not included in the Enscript distribution. Highlighting rules for Ruby can be obtained from: http://neugierig.org/software/ruby/
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
69
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
70 == Extra Software ==
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
71 * GNU Enscript -- http://people.ssh.fi/mtr/genscript/
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
72 * !SilverCity -- http://silvercity.sf.net/
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
73
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
74 ----
93b4dcbafd7b Copy Trac to main branch.
cmlenz
parents:
diff changeset
75 See also: WikiProcessors, WikiFormatting, TracWiki, TracBrowser
Copyright (C) 2012-2017 Edgewall Software