= Trac での reStructuredText 対応 = #reStructuredTextSupportinTrac

Trac は WikiFormatting を使用できるすべての箇所で、 Wiki マークアップの代わりに ''reStructuredText'' を使用することができます。

reStructuredText の Web ページより:
 "''reStructuredText は読みやすく、 WYSIWYG なプレーンテキストへのマークアップ文法と、そのパーサシステムです。 (Python の docstring のような) プログラムへのインラインドキュメンテーションや、シンプルな Web ページの素早い作成、スタンドアロンのドキュメントの記述に役立ちます。 reStructuredText は個別のアプリケーション向けに拡張ができるように設計されています。''"

=== 必須条件 === #Requirements
Trac で RST を使うためには、 Python の docutils パッケージがインストールされていなければなりません。
あなたのオペレーティングシステムでまだ使用できない場合は、 [http://docutils.sourceforge.net/rst.html RST Website] からダウンロードすることができます。

docutils のインストールには `easy_install docutils` を使用してください。 Trac が docutils パッケージを探すことが出来ない可能性があるので、 (`apt-get install python-docutils` などの) OS のパッケージマネージャは使わないでください。
('''訳注:''' docutils が提供している `setup.py` では `setuptools` を使用していないため、 OS のパッケージでは `docutils-*.egg-info` が作成されない場合があることを指しています。 egg-info さえ作成されていれば OS のパッケージマネージャを使用しても問題ないと思われます。)

=== さらなる RST に関する情報 === #MoreinformationonRST

 * reStructuredText  Web サイト -- http://docutils.sourceforge.net/rst.html
 * RST クイックリファレンス -- http://docutils.sourceforge.net/docs/rst/quickref.html

----

== RST を Trac で使用する == #UsingRSTinTrac
テキストブロックが RST でパースされるようにするには、 ''rst'' プロセッサを使用してください。

=== reStructuredText における TracLinks === #TracLinksinreStructuredText

 * Trac は RST テキストの中で TracLinks が可能になる、 RST のディレクティブ 'trac' を提供しています。

 例:
 {{{
 {{{
 #!rst
 This is a reference to |a ticket|

 .. |a ticket| trac:: #42
 }}}
 }}}

 * Trac は RST で TracLinks を簡単に作成できるように、 `:trac:` というロールを予約しています。

 例:
 {{{
 {{{
 #!rst
 This is a reference to ticket `#12`:trac:

 To learn how to use Trac, see `TracGuide`:trac:
 }}}
 }}}

 `:trac:` ロールのすべての使用例の一覧は、 WikiRestructuredTextLinks を見てください。


=== reStructuredText におけるシンタックスハイライト === #SyntaxhighlightinginreStructuredText

同様に、 RST において TracSyntaxColoring を行なうディレクティブがあります。
ディレクティブは code-block と呼ばれます。

例

{{{
{{{
#!rst

.. code-block:: python

 class Test:

    def TestFunction(self):
        pass

}}}
}}}

上記の例は以下のように見えます。

{{{
#!rst

.. code-block:: python

 class Test:

    def TestFunction(self):
        pass

}}}

=== reStructuredText の中における Wiki Macros === #WikiMacrosinreStructuredText

[WikiMacros Wiki マクロ] を RST の中で使用するには、 code-block のような