Changes between Initial Version and Version 1 of TracSyntaxColoring


Ignore:
Timestamp:
Nov 17, 2012, 6:20:07 PM (12 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracSyntaxColoring

    v1 v1  
     1= ソースコードのシンタックスカラーリング = #SyntaxColoringofSourceCode
     2Trac は [wiki:WikiFormatting Wiki形式] のテキストと [wiki:TracBrowser リポジトリブラウザ] での、ソースコードの言語特有のシンタックスハイライトに対応しています。
     3
     4色付けを行うために、 Trac はとても多くのプログラミング言語に対応している外部のライブラリを使用しています。
     5
     6現在、 Trac は以下にあげる 1 つ以上のパッケージを使用して、シンタックスハイライトを実現しています:
     7
     8 * [http://www.codento.com/people/mtr/genscript/ GNU Enscript]
     9 * [http://silvercity.sourceforge.net/ SilverCity]
     10 * [http://pygments.pocoo.org/ Pygments] (0.10 では対応したプラグインが必要です。 [#AboutPygments 以下] を参照してください。)
     11
     12シンタックスハイライトを有効にするためには、ただこれらのパッケージをインストールするだけです。追加のコンフィグレーションは必要ありませんが、カラーリングを修正するためには、 `trac/htdocs/css/code.css` を参照してください。
     13
     14Trac がインストールされたライブラリを検出できない場合は、 Trac のロギングを使用してみてください。実際に Trac から !SilverCity 0.9.6 が壊れているように見えます。 0.9.7 か 0.9.5 を使用して下さい。 http://trac.edgewall.org/wiki/TracFaq#why-is-my-css-code-not-being-highlighted-even-though-i-have-silvercity-installed
     15
     16シンタックスハイライトを使用するとき、可能な限り Trac は自動的に Enscript よりも !SilverCity のハイライトを優先します (下の注を参照のこと)。
     17
     18どちらのパッケージも使用できないときは、 Trac はプレーンテキストでデータを表示します。
     19
     20'''Note:''' Enscript はとても多くのプログラミング言語に対応しますが、 !SilverCity はライブラリであり、外部プロセスで実行されないので、 Enscript よりも処理が速いです。
     21
     22=== !SilverCity について === #AboutSilverCity
     23!SilverCity は [http://www.scintilla.org/ Scintilla] の構文解析エンジンを使用します。 Scintilla は !SilverCity が実装しているよりもより多くのプログラミング言語に対応しています。もし、 !SilverCity に Scintilla が対応しているプログラミング言語を追加したいならば、そんなに難しいことではありません。どのようにすればいいのかは、 [http://trac.edgewall.org/wiki/SilverCityAddLanguage SilverCityAddLanguage] を参照してください。
     24
     25=== Pygments について === #AboutPygments
     26
     27Trac 0.11 からは [http://pygments.org/ Pygments] が新しいデフォルトのハイライトライブラリになります。 Pygments は Python で実装され、非常に高速で、拡張しやすく、 [http://pygments.org/docs/ 良いドキュメント] があるハイライトライブラリです。 Enscript や Scintilla ほど多くの言語をサポートしませんが総合的な出力品質は、はるかに良いです。
     28
     29Pygments を Trac 0.11 で使用するためには、 Pygments 0.6 以上をインストールしなければなりません。 Trac 0.10 でも Pygments を使用したいのであれば、 trac hacks から [http://trac-hacks.org/wiki/TracPygmentsPlugin TracPygmentsPlugin] をインストールしなければなりません。なんらかのバグを発見した場合は  [http://dev.pocoo.org/projects/pygments/ Pygments の Trac] にチケットを登録してください。
     30
     31Pygments に適用するデフォルトのスタイルは trac.ini の [TracIni#mimeviewer-section mime-viewer] セクションに指定します。デフォルトのスタイルは [/prefs/pygments 個人設定 (英語版では Preferences) ページ] のスタイル設定で上書きできます。
     32
     33Pygments の構文解析エンジンが対応するリストは毎週のように更新されています。以下のリストが古い可能性は非常に高いです。 正確には [http://pygments.org/docs/lexers/ supported lexers] のページを参照してください。
     34
     35
     36== 対応しているシンタックスハイライト == #SyntaxColoringSupport
     37
     38|| || !SilverCity || Enscript || Pygments ||
     39|| Ada      ||   || X || ||
     40|| Asm      ||   || X || ||
     41|| Apache Conf (htaccess)) || || || X ||
     42|| * ASP    || X || X || ||
     43|| * C      || X || X || X ||
     44|| * C#     ||   || X(2) || X ||
     45|| * C++    || X || X || X ||
     46|| * Java   || X(4)|| X || X ||
     47|| Awk      ||   || X || ||
     48|| Boo || || || X ||
     49|| CSS      || X ||   || X ||
     50|| Python Doctests || || || X ||
     51|| Diff     ||   || X || X ||
     52|| Eiffel   ||   || X || ||
     53|| Elisp    ||   || X || ||
     54|| Fortran  ||   || X(3) || X ||
     55|| Haskell  ||   || X || X ||
     56|| Genshi || || || X ||
     57|| HTML     || X || X || X ||
     58|| IDL      ||   || X || ||
     59|| INI || || || X ||
     60|| Javascript || X || X || X ||
     61|| Lua || || || X ||
     62|| m4       ||   || X || ||
     63|| Makefile ||   || X || X ||
     64|| Mako || || || X ||
     65|| Matlab   ||   || X (5) || ||
     66|| Mygthy || || || X ||
     67|| Objective-C|| || X ||X ||
     68|| OCaml    ||   ||   || X ||
     69|| Pascal   ||   || X || X ||
     70|| * Perl   || X || X || X ||
     71|| * PHP    || X ||   || X ||
     72|| PSP      || X ||   || ||
     73|| Pyrex    ||   || X || ||
     74|| * Python || X || X || X ||
     75|| * Ruby   || X || X (1) || X ||
     76|| Scheme   ||   || X || X ||
     77|| Shell    ||   || X || X ||
     78|| Smarty || || || X ||
     79|| SQL      || X || X || X ||
     80|| Troff    ||   || X || X ||
     81|| TCL      ||   || X || ||
     82|| Tex      ||   || X || X ||
     83|| Verilog  || X(4) || X || ||
     84|| VHDL     ||   || X || ||
     85|| Visual Basic |||| X || X ||
     86|| VRML     ||   || X || ||
     87|| XML      || X ||  || X ||
     88
     89''(*) [wiki:WikiFormatting WikiFormatting] の WikiProcessors でシンタックスハイライトが対応しています。''
     90
     91''(1) Enscript では Ruby のハイライトは含まれていません。 Ruby のハイライトルールは [http://neugierig.org/software/ruby/] から入手することができます。''
     92
     93''(2) C# のハイライトは Enscript の配布物には含まれていません。 C# 用のハイライトのルールは http://wiki.hasno.info/index.php/Csharp.st より入手可能です。
     94
     95''(3) Fortran: Enscript ではパッケージ化されている固定のソース形式のみをサポートしています。 Fortran 90x/2003 のハイライトルールは http://wiki.hasno.info/index.php/F90.st から入手することができます。
     96
     97''(4) 2006 年 11 月 23 日にリリースされた Silvercity 0.9.7 以来更新されていません。
     98
     99''(5) デフォルトで `.m` ファイルは Objective-C ファイルとして扱われます。 MATLAB ファイルとして `.m` ファイルを扱うには、 [wiki:TracIni#mimeviewer-section "trac.ini の [mimeviewer] セクション"]の "mime_map" に  "text/x-matlab:m" を追加してください。
     100
     101== その他のソフトウェア == #ExtraSoftware
     102 * GNU Enscript -- http://directory.fsf.org/GNU/enscript.html
     103 * GNU Enscript for Windows -- http://gnuwin32.sourceforge.net/packages/enscript.htm
     104 * !SilverCity -- http://silvercity.sf.net/
     105 * Pygments -- http://pygments.org/
     106
     107----
     108See also: WikiProcessors, WikiFormatting, TracWiki, TracBrowser
     109