wiki:TracSyntaxColoring

Context Navigation

Version 2 (modified by trac, 16 years ago) (diff)
--

ソースコードのシンタックスカラーリング

Trac は wiki プロセッサブロック内の Wiki 形式のテキストとリポジトリブラウザでの、ソースコードの言語特有のシンタックスハイライトに対応しています。

色付けを行うために、 Trac はとても多くのプログラミング言語に対応している外部のライブラリを使用しています。

現在、 Trac は以下にあげる 1 つ以上のパッケージを使用して、シンタックスハイライトを実現しています:

Pygments 最も推奨するシステムです。というのもカバーしているプログラミング言語、構造化テキストが多いこととサポート体制が活発であるからです。
GNU Enscript 通常 UNIX で利用できますが、 Windows ではサポートされていません。
SilverCity レガシーなシステムです。いくつかのバージョンには問題があります

シンタックスカラーリングを有効にするには、これらのパッケージのどれか 1 つまたは 1 つ以上をインストールするだけです ( 下記のその他のソフトウェアを参照 ) もし、これらのパッケージの中で適用できるものがなければ、 Trac はプレーンテキストとしてデータを表示します。

Pygments について

Trac 0.11 以降で、 pygments はデフォルトのハイライトパッケージとなりました。ハイライト用のライブラリがピュアな Python コードで書かれていて、とても速く、拡張しやすくドキュメントが豊富です。

Pygments のデフォルトのスタイルは、 trac.ini の mime-viewer セクションで指定できます。デフォルトのスタイルは、個人設定のシンタックスハイライトタブ上のスタイルを設定することで、オーバーライドされます。

Pygments の構文解析エンジンが対応するリストは毎週のように更新されています。以下のリストが古い可能性は非常に高いです。正確には supported lexers のページを参照してください。

対応しているシンタックスハイライト

対応している MIME タイプ

MIME Types	WikiProcessors
`application/msword`	`doc dot`
`application/pdf`	`pdf`
`application/postscript`	`postscript ps`
`application/rss+xml`	`rss`
`application/rtf`	`rtf`
`application/x-befunge`	`befunge`
`application/x-brainfuck`	`bf brainfuck`
`application/x-clojure`	`clj clojure`
`application/x-coldfusion`	`cfm`
`application/x-csh`	`csh tcsh`
`application/x-cython`	`cython pyx`
`application/x-dos-batch`	`bat`
`application/x-evoque`	`evoque`
`application/x-gooddata-maql`	`maql`
`application/x-httpd-php5`	`html+php`
`application/x-hybris`	`hy hybris`
`application/x-jinja`	`django jinja`
`application/x-jsp`	`jsp`
`application/x-kid`	`genshi kid xml+genshi xml+kid`
`application/x-lua`	`lua`
`application/x-mako`	`mako`
`application/x-mason`	`mason`
`application/x-myghty`	`myghty`
`application/x-perl`	`perl pl`
`application/x-pygments-tokens`	`raw`
`application/x-python`	`py python`
`application/x-python3`	`py3 python3`
`application/x-ruby`	`duby rb ruby`
`application/x-ruby-templating`	`erb`
`application/x-scheme`	`scheme scm`
`application/x-shell-session`	`console`
`application/x-shellscript`	`bash ksh sh`
`application/x-smarty`	`smarty`
`application/x-spitfire`	`cheetah spitfire`
`application/x-ssp`	`ssp`
`application/x-tcl`	`tcl`
`application/x-troff`	`roff troff`
`application/x-yaml`	`yml`
`application/xhtml+xml`	`html`
`application/xml+evoque`	`xml+evoque`
`application/xml+jinja`	`xml+django xml+jinja`
`application/xml+mako`	`xml+mako`
`application/xml+myghty`	`xml+myghty`
`application/xml+php`	`xml+php`
`application/xml+ruby`	`xml+erb xml+ruby`
`application/xml+smarty`	`xml+smarty`
`application/xml+spitfire`	`xml+cheetah xml+spitfire`
`application/xml+velocity`	`xml+velocity`
`application/xquery`	`xquery xqy`
`application/xsl+xml`	`xsl`
`application/xslt+xml`	`xml xslt`
`image/svg+xml`	`svg`
`image/x-icon`	`ico`
`model/vrml`	`vrml wrl`
`text/R`	`r s splus`
`text/actionscript`	`actionscript actionscript3 as as3`
`text/coffeescript`	`coffee-script coffeescript`
`text/css`	`css`
`text/css+genshi`	`css+genshi css+genshitext`
`text/css+jinja`	`css+django css+jinja`
`text/css+mako`	`css+mako`
`text/css+myghty`	`css+myghty`
`text/css+php`	`css+php`
`text/css+ruby`	`css+erb css+ruby`
`text/css+smarty`	`css+smarty`
`text/gettext`	`po pot`
`text/haxe`	`haXe hx`
`text/html`	`htm`
`text/html+evoque`	`html+evoque`
`text/html+genshi`	`html+genshi html+kid`
`text/html+jinja`	`html+django html+jinja`
`text/html+mako`	`html+mako`
`text/html+myghty`	`html+myghty`
`text/html+ruby`	`html+erb html+ruby rhtml`
`text/html+smarty`	`html+smarty`
`text/html+spitfire`	`html+cheetah html+spitfire`
`text/html+velocity`	`html+velocity`
`text/javascript`	`javascript js`
`text/javascript+genshi`	`javascript+genshi javascript+genshitext js+genshi js+genshitext`
`text/javascript+jinja`	`javascript+django javascript+jinja js+django js+jinja`
`text/javascript+mako`	`javascript+mako js+mako`
`text/javascript+mygthy`	`javascript+myghty js+myghty`
`text/javascript+php`	`javascript+php js+php`
`text/javascript+ruby`	`javascript+erb javascript+ruby js+erb js+ruby`
`text/javascript+smarty`	`javascript+smarty js+smarty`
`text/javascript+spitfire`	`javascript+cheetah javascript+spitfire js+cheetah js+spitfire`
`text/matlab`	`matlab octave`
`text/plain`	`AUTHORS COPYING ChangeLog INSTALL README RELEASE TXT text txt`
`text/prs.fallenstein.rst`	`rest restructuredtext rst`
`text/troff`	`groff man nroff`
`text/x-abap`	`abap`
`text/x-ada`	`ada ada95ada2005 adb ads`
`text/x-apacheconf`	`aconf apache apacheconf`
`text/x-asm`	`asm`
`text/x-asp`	`asp`
`text/x-asymptote`	`asy asymptote`
`text/x-autohotkey`	`ahk`
`text/x-awk`	`awk`
`text/x-bbcode`	`bbcode`
`text/x-bmx`	`blitzmax bmax`
`text/x-boo`	`boo`
`text/x-c++hdr`	`H HH c++hdr hh hpp`
`text/x-c++src`	`C C++ CC c++ c++src cc cpp`
`text/x-c-objdump`	`c-objdump`
`text/x-chdr`	`chdr h`
`text/x-cmake`	`cmake`
`text/x-common-lisp`	`cl common-lisp`
`text/x-cpp-objdump`	`c++-objdumb cpp-objdump cxx-objdump`
`text/x-csharp`	`C# c# cs csharp`
`text/x-csrc`	`c csrc xs`
`text/x-d-objdump`	`d-objdump`
`text/x-diff`	`patch`
`text/x-dsrc`	`d`
`text/x-dylan`	`dylan`
`text/x-eiffel`	`e eiffel`
`text/x-elisp`	`el elisp`
`text/x-erl-shellsession`	`erl`
`text/x-erlang`	`erlang`
`text/x-factor`	`factor`
`text/x-felix`	`felix flx`
`text/x-fortran`	`f fortran`
`text/x-gas`	`gas`
`text/x-genshi`	`genshitext`
`text/x-gherkin`	`Cucumber Gherkin cucumber gherkin`
`text/x-glslsrc`	`glsl`
`text/x-gnuplot`	`gnuplot`
`text/x-gooddata-cl`	`gooddata-cl`
`text/x-gosrc`	`go`
`text/x-haml`	`HAML haml`
`text/x-haskell`	`haskell hs`
`text/x-idl`	`ice idl`
`text/x-inf`	`inf`
`text/x-ini`	`cfg ini`
`text/x-iokesrc`	`ik ioke`
`text/x-iosrc`	`io`
`text/x-irclog`	`irc`
`text/x-jade`	`JADE jade`
`text/x-java`	`java`
`text/x-java-properties`	`properties`
`text/x-jbst`	`Duel Engine Duel View JBST JsonML+BST duel jbst`
`text/x-latex`	`latex tex`
`text/x-lighttpd-conf`	`lighttpd lighty`
`text/x-literate-haskell`	`lhs literate-haskell`
`text/x-llvm`	`llvm`
`text/x-logtalk`	`logtalk`
`text/x-m4`	`m4`
`text/x-mail`	`mail`
`text/x-makefile`	`GNUMakefile Makefile bsdmake make makefile mf mk`
`text/x-minidsrc`	`minid`
`text/x-modelica`	`modelica`
`text/x-modula2`	`m2 modula2`
`text/x-moocode`	`moocode`
`text/x-mysql`	`mysql`
`text/x-nasm`	`nasm`
`text/x-newspeak`	`newspeak`
`text/x-nginx-conf`	`nginx`
`text/x-objc`	`m mm`
`text/x-objdump`	`objdump`
`text/x-objective-c`	`obj-c objc objective-c objectivec`
`text/x-objective-j`	`obj-j objective-j objectivej objj`
`text/x-ocaml`	`ml mli ocaml`
`text/x-ooc`	`ooc`
`text/x-pascal`	`delphi objectpascal pas pascal`
`text/x-patch`	`diff udiff`
`text/x-perl`	`PL pm`
`text/x-php`	`php php3 php4 php5`
`text/x-povray`	`pov`
`text/x-prolog`	`prolog`
`text/x-psp`	`psp`
`text/x-pyrex`	`pyrex`
`text/x-python-doctest`	`pycon`
`text/x-python-traceback`	`pytb`
`text/x-python3-traceback`	`py3tb`
`text/x-rebol`	`rebol`
`text/x-rfc`	`rfc`
`text/x-ruby-shellsession`	`irb rbcon`
`text/x-sass`	`SASS sass`
`text/x-scala`	`scala`
`text/x-scaml`	`SCAML scaml`
`text/x-scss`	`scss`
`text/x-smalltalk`	`smalltalk squeak`
`text/x-sql`	`sql`
`text/x-sqlite3-console`	`sqlite3`
`text/x-squidconf`	`squid squid.conf squidconf`
`text/x-textile`	`textile txtl`
`text/x-trac-wiki`	`moin trac-wiki`
`text/x-vala`	`vala vapi`
`text/x-vba`	`bas vb vb.net vba vbnet`
`text/x-verilog`	`v verilog`
`text/x-vhdl`	`vhd vhdl`
`text/x-vim`	`vim`
`text/x-yaml`	`yaml`
`text/x-zsh`	`zsh`

ハイライトパッケージがサポートする言語

このリストはほんの一例です:

	SilverCity	Enscript	Pygments
Ada		✓
Asm		✓
Apache Conf			✓
ASP	✓	✓
C	✓	✓	✓
C#		✓ ⁽¹⁾	✓
C++	✓	✓	✓
Java	✓ ⁽²⁾	✓	✓
Awk		✓
Boo			✓
CSS	✓		✓
Python Doctests			✓
Diff		✓	✓
Eiffel		✓
Elisp		✓
Fortran		✓ ⁽¹⁾	✓
Haskell		✓	✓
Genshi			✓
HTML	✓	✓	✓
IDL		✓
INI			✓
Javascript	✓	✓	✓
Lua			✓
m4		✓
Makefile		✓	✓
Mako			✓
Matlab ⁽³⁾		✓	✓
Mygthy			✓
Objective-C		✓	✓
OCaml			✓
Pascal		✓	✓
Perl	✓	✓	✓
PHP	✓		✓
PSP	✓
Pyrex		✓
Python	✓	✓	✓
Ruby	✓	✓ ⁽¹⁾	✓
Scheme		✓	✓
Shell		✓	✓
Smarty			✓
SQL	✓	✓	✓
Troff		✓	✓
TCL		✓
Tex		✓	✓
Verilog	✓ ⁽²⁾	✓
VHDL		✓
Visual Basic		✓	✓
VRML		✓
XML	✓		✓

(1) Enscript のパッケージには含まれていません。以下のハイライトルールを追加することが可能です。 Ruby, C#, Fortran 90x/2003

(2) Silvercity 0.9.7 は 2006-11-23 にリリースされました。

(3) デフォルトで、 .m ファイルは Objective-C のファイルだと解釈されます。 .m ファイルを MATLAB ファイルとして扱うためには、 "text/matlab:m" を trac.ini の [mimeviewer] セクション内、 "mime_map" の設定に追加してください。

その他のソフトウェア

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/
Pygments -- http://pygments.org/

See also: WikiProcessors, WikiFormatting, TracWiki, TracBrowser

Download in other formats:

Plain Text