Changes between Version 1 and Version 2 of WikiRestructuredText

Timestamp:

2009/10/03 12:40:44 (17 years ago)

Author:

trac

Comment:

--

WikiRestructuredText

@@ -1 @@
-= reStructuredText の対応 =
+= Trac での reStructuredText 対応 = #reStructuredTextSupportinTrac
 
-Trac は WikiFormatting が使われているあらゆるコンテキストの中で Wiki マークアップの代わりとなるものとして ''reStructuredText'' が利用可能です。
+Trac は WikiFormatting を使用できるすべての箇所で、 Wiki マークアップの代わりに ''reStructuredText'' を使用することができます。
 
 reStructuredText の Web ページより:
- "''reStructuredText は読みやすく、見たものを手にする、マークアップされたプレーンテキストとそのパーサシステムです。 reStructuredText はプログラムのインラインのドキュメント (例えば、 Python docstrings) や簡単な Web ページをすばやく作ること、スタンドアロンのドキュメントを書くのにとても役に立ちます。 reStructuredText は特定のアプリケーションの分野のための拡張として設計されています。''"
+ "''reStructuredText は読みやすく、 WYSIWYG なプレーンテキストへのマークアップ文法と、そのパーサシステムです。 (Python の docstring のような) プログラムへのインラインドキュメンテーションや、シンプルな Web ページの素早い作成、スタンドアロンのドキュメントの記述に役立ちます。 reStructuredText は個別のアプリケーション向けに拡張ができるように設計されています。''"
 
-=== 必須条件 ===
-Trac で RST を使うためには、 Python の docutils パッケージがインストールされてなければなりません。
+=== 必須条件 === #Requirements
+Trac で RST を使うためには、 Python の docutils パッケージがインストールされていなければなりません。
 あなたのオペレーティングシステムでまだ使用できない場合は、 [http://docutils.sourceforge.net/rst.html RST Website] からダウンロードすることができます。
 
-=== さらなる RST に関する情報 ===
+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
@@ -17 +20 @@
 ----
 
-== RST を Trac で使用する ==
-テキストが RST を使用してパースされるようにするには、 ''rst'' プロセッサを使用してください。
+== RST を Trac で使用する == #UsingRSTinTrac
+テキストブロックが RST でパースされるようにするには、 ''rst'' プロセッサを使用してください。
 
-=== reStructuredText における TracLinks ===
+=== reStructuredText における TracLinks === #TracLinksinreStructuredText
 
- * Trac は RST テキストの中で TracLinks を許可するための 'trac' というカスタマイズされたRSTのリファレンスディレクティブを提供しています。
+ * Trac は RST テキストの中で TracLinks が可能になる、 RST のディレクティブ 'trac' を提供しています。
 
  例:
@@ -34 +37 @@
  }}}
 
- ''trac'' ディレクティブのすべての使用方法の一覧は、 WikiRestructuredTextLinks を見てください。
-
-
- * Trac は RST において、カスタマイズされた '':trac::'' というリンクのための命名体系を使用することにより、簡単な方法で TracLinks を作ることを許可しています。
+ * Trac は RST で TracLinks を簡単に作成できるように、 `:trac:` というロールを予約しています。
 
  例:
@@ -49 +49 @@
  }}}
 
-=== reStructuredText におけるシンタックスハイライト ===
+ `:trac:` ロールのすべての使用例の一覧は、 WikiRestructuredTextLinks を見てください。
+
+
+=== reStructuredText におけるシンタックスハイライト === #SyntaxhighlightinginreStructuredText
 
 同様に、 RST において TracSyntaxColoring を行なうディレクティブがあります。
@@ -84 +87 @@
 }}}
 
-=== reStructuredText の中における WikiMacros ===
+=== reStructuredText の中における Wiki Macros === #WikiMacrosinreStructuredText
 
-WikiMacros を ReST の中で使用するには、例えば code-block のようなシンタックスハイライトと同様の
-ディレクティブを使用します。動作させるためには [http://trac.edgewall.org/ticket/801 #801] のパッチ適用をした Trac を使用しなければなりません。
+[WikiMacros Wiki マクロ] を RST の中で使用するには、 code-block のようなシンタックスハイライトと同様のディレクティブを使用します。
+動作させるためには [http://trac.edgewall.org/ticket/801 #801] のパッチ適用をした Trac を使用しなければなりません。
 
-=== WikiMacros の例 ===
+=== Wiki Macros の例 === #WikiMacroExample
 
 {{{
@@ -95 +98 @@
 #!rst
 
-.. code-block:: HelloWorld
- 
-   Something I wanted to say
+.. code-block:: RecentChanges
 
+   Trac,3
 
 }}}
 }}}
 
-この結果は以下のようになります。
+この結果は以下のようになります:
 
-[[HelloWorld(Something I wanted to say)]]
+     [[RecentChanges(Trac,3)]]
 
+より簡素な構文でも Wiki マクロを利用できます:
 
-=== より大きい ReST の例 ===
+{{{
+{{{
+#!rst
+
+:code-block:`RecentChanges:Trac,3`
+}}}
+}}}
+
+=== より大きい RST の例 === #BiggerRSTExample
 この例のように書くと、とても分かりやすくなります:
 {{{