| 8 | | * [http://www.codento.com/people/mtr/genscript/ GNU Enscript] |
| 9 | | * [http://silvercity.sourceforge.net/ SilverCity] |
| | 12 | * '''[http://pygments.org/ Pygments]''', the preferred system, as it covers a wide range of programming languages and other structured texts and is actively supported. |
| | 13 | * [http://www.codento.com/people/mtr/genscript/ GNU Enscript], commonly available on Unix, and has an [http://gnuwin32.sourceforge.net/packages/enscript.htm unsupported version] on Windows; use is deprecated. |
| | 14 | * [http://silvercity.sourceforge.net/ SilverCity], legacy system, some versions can be problematic; use is deprecated. |
| 19 | | === About SilverCity === |
| 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. |
| | 24 | The list below contains only the most commonly used processors and the [http://pygments.org/docs/lexers/ list of supported Pygments lexers] is growing weekly. |
| | 25 | |
| | 26 | == Syntax Coloring Support |
| | 27 | |
| | 28 | === Known MIME Types |
| | 29 | |
| | 30 | [[KnownMimeTypes]] |
| | 31 | |
| | 32 | Note that the rich content may be directly //rendered// instead of syntax highlighted. This usually depends on which auxiliary packages are installed and on which components are activated in your setup. For example a `text/x-rst` document will be rendered via `docutils` if it is installed and the `trac.mimeview.rst.ReStructuredTextRenderer` is not disabled, and will be syntax highlighted otherwise. |
| | 33 | |
| | 34 | Similarly, a document with the mimetype `text/x-trac-wiki` is rendered using the Trac wiki formatter, unless the `trac.mimeview.api.WikiTextRenderer` component is disabled. |
| | 35 | |
| | 36 | HTML documents are directly rendered only if the `render_unsafe_html` settings are enabled in your TracIni file. Those settings are present in multiple sections, as there are different security concerns depending where the document comes from. If you want to ensure that an HTML document gets syntax highlighted and not rendered, use the `text/xml` mimetype. |
| | 37 | |
| | 38 | If a mimetype property such as `svn:mime-type` is set to `text/plain`, there is no coloring even if the file is of a known type, like `java`. |
| | 39 | |
| | 40 | === List of Languages Supported, by Highlighter #language-supported |
| | 41 | |
| | 42 | This list is only indicative. |
| | 43 | |
| | 44 | || ||= !SilverCity =||= Enscript =||= Pygments =|| |
| | 45 | || Ada || || ✓ || || |
| | 46 | || Asm || || ✓ || || |
| | 47 | || Apache Conf || || || ✓ || |
| | 48 | || ASP || ✓ || ✓ || || |
| | 49 | || C || ✓ || ✓ || ✓ || |
| | 50 | || C# || || ✓ ^[#a1 (1)]^ || ✓ || |
| | 51 | || C++ || ✓ || ✓ || ✓ || |
| | 52 | || CMake || ? || ? || ✓ || |
| | 53 | || Java || ✓ ^[#a2 (2)]^ || ✓ || ✓ || |
| | 54 | || Awk || || ✓ || || |
| | 55 | || Boo || || || ✓ || |
| | 56 | || CSS || ✓ || || ✓ || |
| | 57 | || Python Doctests || || || ✓ || |
| | 58 | || Diff || || ✓ || ✓ || |
| | 59 | || Eiffel || || ✓ || || |
| | 60 | || Elisp || || ✓ || || |
| | 61 | || Fortran || || ✓ ^[#a1 (1)]^ || ✓ || |
| | 62 | || Haskell || || ✓ || ✓ || |
| | 63 | || Genshi || || || ✓ || |
| | 64 | || HTML || ✓ || ✓ || ✓ || |
| | 65 | || IDL || || ✓ || || |
| | 66 | || INI || || || ✓ || |
| | 67 | || Javascript || ✓ || ✓ || ✓ || |
| | 68 | || Lua || || || ✓ || |
| | 69 | || m4 || || ✓ || || |
| | 70 | || Makefile || || ✓ || ✓ || |
| | 71 | || Mako || || || ✓ || |
| | 72 | || Matlab ^[#a3 (3)]^ || || ✓ || ✓ || |
| | 73 | || Mygthy || || || ✓ || |
| | 74 | || Objective-C || || ✓ || ✓ || |
| | 75 | || OCaml || || || ✓ || |
| | 76 | || Pascal || || ✓ || ✓ || |
| | 77 | || Perl || ✓ || ✓ || ✓ || |
| | 78 | || PHP || ✓ || || ✓ || |
| | 79 | || PSP || ✓ || || || |
| | 80 | || Pyrex || || ✓ || || |
| | 81 | || Python || ✓ || ✓ || ✓ || |
| | 82 | || Ruby || ✓ || ✓ ^[#a1 (1)]^ || ✓ || |
| | 83 | || Scheme || || ✓ || ✓ || |
| | 84 | || Shell || || ✓ || ✓ || |
| | 85 | || Smarty || || || ✓ || |
| | 86 | || SQL || ✓ || ✓ || ✓ || |
| | 87 | || Troff || || ✓ || ✓ || |
| | 88 | || TCL || || ✓ || || |
| | 89 | || Tex || || ✓ || ✓ || |
| | 90 | || Verilog || ✓ ^[#a2 (2)]^ || ✓ || || |
| | 91 | || VHDL || || ✓ || || |
| | 92 | || Visual Basic || || ✓ || ✓ || |
| | 93 | || VRML || || ✓ || || |
| | 94 | || XML || ✓ || || ✓ || |
| 66 | | ''(*) Supported as inline code blocks in [wiki:WikiFormatting Wiki text] using WikiProcessors.'' |
| 67 | | |
| 68 | | ''(1) Ruby highlighting is not included in the Enscript distribution. Highlighting rules for Ruby can be obtained from: http://neugierig.org/software/ruby/ |
| 69 | | |
| 70 | | ''(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 |
| 71 | | |
| 72 | | == Extra Software == |
| 73 | | * GNU Enscript -- http://directory.fsf.org/GNU/enscript.html |
| 74 | | * GNU Enscript for Windows -- http://gnuwin32.sourceforge.net/packages/enscript.htm |
| 75 | | * !SilverCity -- http://silvercity.sf.net/ |
| | 104 | ''[=#a3 (3)] By default `.m` files are considered Objective-C files. In order to treat `.m` files as MATLAB files, add "text/matlab:m" to the "mime_map" setting in the [wiki:TracIni#mimeviewer-section "[mimeviewer] section of trac.ini"]. |
