Changes between Version 2 and Version 3 of TracSyntaxColoring


Ignore:
Timestamp:
Oct 1, 2012 9:35:34 AM (12 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • TracSyntaxColoring

    v2 v3  
    1 = ソースコードのシンタックスカラーリング = #SyntaxColoringofSourceCode 
    2 Trac は [WikiProcessors#CodeHighlightingSupport wiki プロセッサ] ブロック内の Wiki 形式のテキストと [wiki:TracBrowser リポジトリブラウザ] での、ソースコードの言語特有のシンタックスハイライトに対応しています。 
     1= Syntax Coloring of Source Code = 
     2Trac supports language-specific syntax highlighting of source code within wiki formatted text in [WikiProcessors#CodeHighlightingSupport wiki processors] blocks and in the [TracBrowser repository browser]. 
    33 
    4 色付けを行うために、 Trac はとても多くのプログラミング言語に対応している外部のライブラリを使用しています。 
     4To do this, Trac uses external libraries with support for a great number of programming languages. 
    55 
    6 現在、 Trac は以下にあげる 1 つ以上のパッケージを使用して、シンタックスハイライトを実現しています: 
     6Currently Trac supports syntax coloring using one or more of the following packages: 
    77 
    8  * [http://pygments.pocoo.org/ Pygments] 最も推奨するシステムです。というのもカバーしているプログラミング言語、構造化テキストが多いこととサポート体制が活発であるからです。 
    9  * [http://www.codento.com/people/mtr/genscript/ GNU Enscript] 通常 UNIX で利用できますが、 Windows ではサポートされていません。 
    10  * [http://silvercity.sourceforge.net/ SilverCity] レガシーなシステムです。いくつかのバージョンには [http://trac.edgewall.org/wiki/TracFaq#why-is-my-css-code-not-being-highlighted-even-though-i-have-silvercity-installed 問題があります] 
     8 * [http://pygments.pocoo.org/ Pygments], by far the preferred system, as it covers a wide range of programming languages and other structured texts and is actively supported 
     9 * [http://www.codento.com/people/mtr/genscript/ GNU Enscript], commonly available on Unix but somewhat unsupported on Windows 
     10 * [http://silvercity.sourceforge.net/ SilverCity], legacy system, some versions can be [http://trac.edgewall.org/wiki/TracFaq#why-is-my-css-code-not-being-highlighted-even-though-i-have-silvercity-installed problematic] 
    1111 
    1212 
    13 シンタックスカラーリングを有効にするには、これらのパッケージのどれか 1 つまたは 1 つ以上をインストールするだけです ( 下記の [#ExtraSoftware その他のソフトウェア] を参照 ) 
    14 もし、これらのパッケージの中で適用できるものがなければ、 Trac はプレーンテキストとしてデータを表示します。 
     13To activate syntax coloring, simply install either one (or more) of these packages (see [#ExtraSoftware] section below). 
     14If none of these packages is available, Trac will display the data as plain text.  
    1515 
    1616 
    17 === Pygments について === #AboutPygments 
     17=== About Pygments === 
    1818 
    19 Trac 0.11 以降で、 [http://pygments.org/ pygments] はデフォルトのハイライトパッケージとなりました。ハイライト用のライブラリがピュアな Python コードで書かれていて、とても速く、拡張しやすく [http://pygments.org/docs/ ドキュメントが豊富です] 。 
     19Starting with trac 0.11 [http://pygments.org/ pygments] will be the new default highlighter. It's a highlighting library implemented in pure python, very fast, easy to extend and [http://pygments.org/docs/ well documented]. 
    2020 
    21 Pygments のデフォルトのスタイルは、 trac.ini の [TracIni#mimeviewer-section mime-viewer] セクションで指定できます。デフォルトのスタイルは、 [/prefs/pygments 個人設定のシンタックスハイライトタブ] 上のスタイルを設定することで、オーバーライドされます。 
     21The Pygments default style can specified in the [TracIni#mimeviewer-section mime-viewer] section of trac.ini. The default style can be overridden by setting a Style preference on the [/prefs/pygments preferences page].  
    2222 
    23 Pygments の構文解析エンジンが対応するリストは毎週のように更新されています。以下のリストが古い可能性は非常に高いです。 正確には [http://pygments.org/docs/lexers/ supported lexers] のページを参照してください。 
     23It's very likely that the list below is outdated because the list of supported pygments lexers is growing weekly. Just have a look at the page of [http://pygments.org/docs/lexers/ supported lexers] on the pygments webpage. 
    2424 
    2525 
    26 == 対応しているシンタックスハイライト == #SyntaxColoringSupport 
     26== Syntax Coloring Support == 
    2727 
    28 === 対応している MIME タイプ ===#KnownMIMETypes 
     28=== Known MIME Types 
    2929 
    3030[[KnownMimeTypes]] 
    3131 
     32Note 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. 
    3233 
    33 === ハイライトパッケージがサポートする言語 #language-supported 
     34In a similar way, 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. 
    3435 
    35 このリストはほんの一例です: 
     36HTML documents are directly rendered only if the `render_unsafe_html` settings are enabled in the TracIni (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 
     38If mimetype such as 'svn:mime-type' is set to 'text/plain', there is no coloring even if file is known type like 'java'. 
     39 
     40=== List of Languages Supported, by Highlighter #language-supported 
     41 
     42This list is only indicative. 
    3643 
    3744||                 ||= !SilverCity   =||= Enscript      =||= Pygments =|| 
    … …  
    4350|| C#              ||                 ||  ✓ ^[#a1 (1)]^  ||  ✓  || 
    4451|| C++             ||  ✓              ||  ✓              ||  ✓  || 
     52|| CMake           ||  ?              ||  ?              ||  ✓  || 
    4553|| Java            ||  ✓ ^[#a2 (2)]^  ||  ✓              ||  ✓  || 
    4654|| Awk             ||                 ||  ✓              ||     || 
    … …  
    8896 
    8997 
    90 ''[=#a1 (1)] Enscript のパッケージには含まれていません。  以下のハイライトルールを追加することが可能です。 
     98''[=#a1 (1)] Not included in the Enscript distribution.  Additional highlighting rules can be obtained for 
    9199[http://neugierig.org/software/ruby/ Ruby], 
    92100[http://wiki.hasno.info/index.php/Csharp.st C#], 
    93101[http://wiki.hasno.info/index.php/F90.st Fortran 90x/2003] 
    94102 
    95 ''[=#a2 (2)] Silvercity 0.9.7 は 2006-11-23 にリリースされました。 
     103''[=#a2 (2)] since Silvercity 0.9.7 released on 2006-11-23 
    96104 
    97 ''[=#a3 (3)] デフォルトで、 `.m` ファイルは Objective-C のファイルだと解釈されます。 `.m` ファイルを MATLAB ファイルとして扱うためには、 "text/matlab:m" を [wiki:TracIni#mimeviewer-section "trac.ini の [mimeviewer] セクション"] 内、 "mime_map" の設定に追加してください。 
     105''[=#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"]. 
    98106 
    99  
    100 == その他のソフトウェア == #ExtraSoftware 
    101  * GNU Enscript -- http://directory.fsf.org/GNU/enscript.html 
    102  * GNU Enscript for Windows -- http://gnuwin32.sourceforge.net/packages/enscript.htm 
    103  * !SilverCity -- http://silvercity.sf.net/ 
    104  * Pygments -- http://pygments.org/ 
     107== Extra Software == 
     108 * GNU Enscript — http://directory.fsf.org/GNU/enscript.html 
     109 * GNU Enscript for Windows — http://gnuwin32.sourceforge.net/packages/enscript.htm 
     110 * !SilverCity — http://silvercity.sf.net/ 
     111 * **Pygments — http://pygments.org/** 
    105112 
    106113----