TracSyntaxColoring のバージョン 1 とバージョン 2 との変更
- 日時:
- 2015/05/27 0:24:03 (11年前)
凡例:
- 変更なし
- 追加
- 削除
- 更新
-
TracSyntaxColoring
v1 v2 1 = Syntax Coloring of Source Code =2 Trac supports language-specific syntax highlighting of source code within wiki formatted text in [WikiProcessors#CodeHighlightingSupport wiki processors] blocks and in the [TracBrowser repository browser].1 = ソースコードのシンタックスカラーリング = #SyntaxColoringofSourceCode 2 Trac は [WikiProcessors#CodeHighlightingSupport wiki プロセッサ] ブロック内の Wiki 形式のテキストと [wiki:TracBrowser リポジトリブラウザ] での、ソースコードの言語特有のシンタックスハイライトに対応しています。 3 3 4 T o do this, Trac uses external libraries with support for a great number of programming languages.4 Trac では色付けを行うために、とても多くのプログラミング言語に対応している外部ライブラリを使用しています。 5 5 6 Currently Trac supports syntax coloring using one or more of the following packages:6 現在、 Trac は以下にあげるパッケージを 1 つ以上使用して、シンタックスハイライトを実現しています: 7 7 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 supported9 * [http://www.codento.com/people/mtr/genscript/ GNU Enscript] , commonly available on Unix but somewhat unsupported on Windows10 * [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]8 * [http://pygments.pocoo.org/ Pygments] 最も推奨するシステムです。というのもカバーしているプログラミング言語、構造化テキストが多いこととサポート体制が活発であるからです 9 * [http://www.codento.com/people/mtr/genscript/ GNU Enscript] 通常 UNIX で利用できますが、 Windows ではサポートされていません 10 * [http://silvercity.sourceforge.net/ SilverCity] レガシーなシステムです。いくつかのバージョンには [trac:TracFaq#why-is-my-css-code-not-being-highlighted-even-though-i-have-silvercity-installed 問題があります] 11 11 12 12 13 To activate syntax coloring, simply install either one (or more) of these packages (see [#ExtraSoftware] section below). 14 If none of these packages is available, Trac will display the data as plain text. 13 シンタックスカラーリングを有効にするには、これらのパッケージのどれか 1 つまたは 1 つ以上をインストールするだけです ( 下記の [#ExtraSoftware その他のソフトウェア] を参照 ) 14 もし、これらのパッケージの中で適用できるものがなければ、 Trac はプレーンテキストとしてデータを表示します。 15 15 16 16 17 === About Pygments ===17 === Pygments について === #AboutPygments 18 18 19 Starting 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]. 19 Trac 0.11 以降で、 [http://pygments.org/ pygments] はデフォルトのハイライトパッケージとなりました。ハイライト用のライブラリがピュアな Python コードで書かれていて、とても速く、拡張しやすく [http://pygments.org/docs/ ドキュメントが豊富です] 。 20 20 21 The 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]. 21 Pygments のデフォルトのスタイルは、 trac.ini の [TracIni#mimeviewer-section mime-viewer] セクションで指定できます。デフォルトのスタイルは、 [/prefs/pygments 個人設定のシンタックスハイライトタブ] 上のスタイルを設定することで、オーバーライドされます。 22 22 23 It'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. 23 Pygments の構文解析エンジンが対応するリストは毎週のように更新されています。以下のリストが古い可能性は非常に高いです。 正確には [http://pygments.org/docs/lexers/ supported lexers] のページを参照してください。 24 24 25 25 26 == Syntax Coloring Support ==26 == 対応しているシンタックスハイライト == #SyntaxColoringSupport 27 27 28 === Known MIMETypes28 === 対応している MIME タイプ === #KnownMIMETypes 29 29 30 30 [[KnownMimeTypes]] 31 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.32 Note: 高度なコンテンツはシンタックスハイライトの代わりに直接レンダリングされるかもしれません。これはインストールされている予備のパッケージ及び設定したコンポーネントによって決まります。例えば、`text/x-rst` ドキュメントでは、`docutils` がインストールされていて、`trac.mimeview.rst.ReStructuredTextRenderer` が無効になっておらず、他にシンタックスハイライトが存在するような場合、`docutils` を通してレンダリングされます。 33 33 34 In 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. 34 同様の方法で、 MIME タイプ `text/x-trac-wiki` のドキュメントは Trac Wiki フォーマットを使ってレンダリングされます。ただし、 `trac.mimeview.api.WikiTextRenderer` コンポーネントは無効とされます。 35 35 36 HTML 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.36 HTML ドキュメントは `render_unsafe_html` が TracIni で有効に設定されている場合に限り、直接レンダリングされます。 (ドキュメントがどこからくるかによって異なるセキュリティ上の懸念がある場合、これらの設定は、複数のセクションに存在します)。もし HTML ドキュメントがレンダリングを行わず、シンタックスハイライトなるよう保証したいのであれば、 MIME タイプ `text/xml` を使用してください。 37 37 38 If mimetype such as 'svn:mime-type' is set to 'text/plain', there is no coloring even if file is known type like 'java'. 38 'svn:mime-type' 属性が 'text/plain' のように MIME タイプで設定されている場合、例え 'java' で書かれたファイルであっても色づけされません。 39 39 40 === List of Languages Supported, by Highlighter#language-supported40 === ハイライトパッケージがサポートする言語 === #language-supported 41 41 42 This list is only indicative. 42 このリストはほんの一例です: 43 43 44 44 || ||= !SilverCity =||= Enscript =||= Pygments =|| … … 96 96 97 97 98 ''[=#a1 (1)] Not included in the Enscript distribution. Additional highlighting rules can be obtained for98 ''[=#a1 (1)] Enscript のパッケージには含まれていません。 以下のハイライトルールを追加することが可能です。 99 99 [http://neugierig.org/software/ruby/ Ruby], 100 100 [http://wiki.hasno.info/index.php/Csharp.st C#], 101 101 [http://wiki.hasno.info/index.php/F90.st Fortran 90x/2003] 102 102 103 ''[=#a2 (2)] since Silvercity 0.9.7 released on 2006-11-23103 ''[=#a2 (2)] Silvercity 0.9.7 は 2006-11-23 にリリースされました。 104 104 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"].105 ''[=#a3 (3)] デフォルトで、 `.m` ファイルは Objective-C のファイルだと解釈されます。 `.m` ファイルを MATLAB ファイルとして扱うためには、 "text/matlab:m" を [wiki:TracIni#mimeviewer-section "trac.ini の [mimeviewer] セクション"] 内、 "mime_map" の設定に追加してください。 106 106 107 == Extra Software ==107 == その他のソフトウェア == #ExtraSoftware 108 108 * GNU Enscript — http://directory.fsf.org/GNU/enscript.html 109 109 * GNU Enscript for Windows — http://gnuwin32.sourceforge.net/packages/enscript.htm
![(please configure the [header_logo] section in trac.ini)](/python/trac/mypz/chrome/common/trac_logo_mini.png)