Changes between Version 3 and Version 4 of WikiRestructuredText
- Timestamp:
- Dec 31, 2005, 5:43:42 PM (18 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
WikiRestructuredText
v3 v4 1 = reStructuredText Support in Trac=1 = reStructuredText のサポート = 2 2 3 Trac supports using ''reStructuredText'' (RST) as an alternative to wiki markup in any context WikiFormatting is used.3 Trac は WikiFormatting が使われているあらゆるコンテキストの中で Wiki マークアップの代わりとなるものとして ''reStructuredText'' の使用をサポートしています。 4 4 5 From the reStucturedText webpage:6 "''reStructuredText is an easy-to-read, what-you-see-is-what-you-get plaintext markup syntax and parser system. It is useful for in-line program documentation (such as Python docstrings), for quickly creating simple web pages, and for standalone documents. reStructuredText is designed for extensibility for specific application domains.''"5 reStructuredText の Web ページより: 6 "''reStructuredText は読みやすく、見たものを手にする、マークアップされたプレーンテキストとそのパーサシステムです。 reStructuredText はプログラムのインラインのドキュメント (例えば、 Python docstrings) や簡単な Web ページをすばやく作ること、スタンドアロンのドキュメントを書くのにとても役に立ちます。 reStructuredText は特定のアプリケーションの分野のための拡張として設計されています。''" 7 7 8 === Requirements===9 Note that to activate RST support in Trac, the python docutils package must be installed. 10 If not already available on your operating system, you can download it at the [http://docutils.sourceforge.net/rst.html RST Website]. 8 === 必須条件 === 9 Trac で RST のサポートを有効にするためには、 Python の docutils パッケージがインストールされてなければなりません。 10 あなたのオペレーティングシステムでまだ使用できない場合は、 [http://docutils.sourceforge.net/rst.html RST Website] からダウンロードすることができます。 11 11 12 === More information on RST===12 === さらなる RST に関する情報 === 13 13 14 * reStructuredText Website-- http://docutils.sourceforge.net/rst.html15 * RST Quick Reference-- http://docutils.sourceforge.net/docs/rst/quickref.html14 * reStructuredText Web サイト -- http://docutils.sourceforge.net/rst.html 15 * RST クイックリファレンス -- http://docutils.sourceforge.net/docs/rst/quickref.html 16 16 17 17 ---- 18 18 19 == Using RST in Trac==20 To specify that a block of text should be parsed using RST, use the ''rst'' processor. 19 == RST を Trac で使用する == 20 テキストが RST を使用してパースされるようにするには、 ''rst'' プロセッサを使用してください。 21 21 22 === TracLinks in reStructuredText===22 === reStructuredText における TracLinks === 23 23 24 * Trac provides a custom RST reference-directive 'trac' to allow TracLinks from within RST text.24 * Trac は RST テキストの中で TracLinks を許可するための 'trac' というカスタマイズされたRSTのリファレンスディレクティブを提供しています。 25 25 26 Example:26 例: 27 27 {{{ 28 28 {{{ … … 34 34 }}} 35 35 36 For a complete example of all uses of the ''trac''-directive, please see WikiRestructuredTextLinks.36 ''trac'' ディレクティブのすべての使用方法の一覧は、 WikiRestructuredTextLinks を見てください。 37 37 38 38 39 * Trac allows an even easier way of creating TracLinks in RST, using the custom '':trac:'' link naming scheme.39 * Trac は RST において、カスタマイズされた '':trac::'' というリンクのための命名体系を使用することにより、簡単な方法で TracLinks を作ることを許可しています。 40 40 41 Example:41 例: 42 42 {{{ 43 43 {{{ … … 49 49 }}} 50 50 51 === Syntax highlighting in reStructuredText===51 === reStructuredText におけるシンタックスハイライト === 52 52 53 There is a directive for doing TracSyntaxColoring in ReST as well. The directive is called 54 code-block 53 同様に、 RST において TracSyntaxColoring を行なうディレクティブがあります。 54 ディレクティブは code-block と呼ばれます。 55 55 56 Example 56 例 57 57 58 58 {{{ … … 70 70 }}} 71 71 72 Will result in the below. 72 上記の例は以下のように見えます。 73 73 74 74 {{{ … … 84 84 }}} 85 85 86 === WikiMacros in reStructuredText===86 === reStructuredText の中における WikiMacros === 87 87 88 For doing WikiMacros in ReST you use the same directive as for syntax highlightning i.e 89 code-block. To work you must use a version of trac that has #801 applied. 88 WikiMacros を ReST の中で使用するには、例えば code-block のようなシンタックスハイライトと同様の 89 ディレクティブを使用します。動作させるためには [http://projects.edgewall.com/trac/ticket/801 #801] のパッチ適用をした Trac を使用しなければなりません。 90 90 91 === WikiMacro Example===91 === WikiMacros の例 === 92 92 93 93 {{{ … … 103 103 }}} 104 104 105 Will result in the below. 105 この結果は以下のようになります。 106 106 107 107 [[HelloWorld(Something I wanted to say)]] 108 108 109 109 110 === Bigger ReST Example===111 The example below should be mostly self-explanatory:110 === より大きい ReST の例 === 111 この例のように書くと、とても分かりやすくなります: 112 112 {{{ 113 113 #!html … … 141 141 142 142 143 Results in:143 結果: 144 144 {{{ 145 145 #!rst … … 169 169 }}} 170 170 171 '''訳注: 日本語でテーブルを作成する場合、 docutils にパッチする必要があります。''' 171 172 172 173 ----