XPressME Integration Kit

Trac

Version 1 から Version 2 における更新: WikiRestructuredText

差分発生行の前後
Ignore:
Timestamp:
Nov 29, 2010, 3:25:29 PM (10 years 前)
Author:
trac (IP: 127.0.0.1)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiRestructuredText

    v1 v2  
    1 = Trac での reStructuredText 対応 = #reStructuredTextSupportinTrac 
     1= reStructuredText Support in Trac = 
    22 
    3 Trac は WikiFormatting を使用できるすべての箇所で、 Wiki マークアップの代わりに ''reStructuredText'' を使用することができます。 
     3Trac supports using ''reStructuredText'' (RST) as an alternative to wiki markup in any context WikiFormatting is used. 
    44 
    5 reStructuredText の Web ページより: 
    6  "''reStructuredText は読みやすく、 WYSIWYG なプレーンテキストへのマークアップ文法と、そのパーサシステムです。 (Python の docstring のような) プログラムへのインラインドキュメンテーションや、シンプルな Web ページの素早い作成、スタンドアロンのドキュメントの記述に役立ちます。 reStructuredText は個別のアプリケーション向けに拡張ができるように設計されています。''" 
     5From 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. ''" 
    77 
    8 === 必須条件 === #Requirements 
    9 Trac で RST を使うためには、 Python の docutils パッケージがインストールされていなければなりません。 
    10 あなたのオペレーティングシステムでまだ使用できない場合は、 [http://docutils.sourceforge.net/rst.html RST Website] からダウンロードすることができます。 
     8If you want a file from your Subversion repository be displayed as reStructuredText in Trac's source browser, set `text/x-rst` as value for the Subversion property `svn:mime-type`. See [trac:source:/trunk/INSTALL this example]. 
    119 
    12 === さらなる RST に関する情報 === #MoreinformationonRST 
     10=== Requirements === 
     11Note that to activate RST support in Trac, the python docutils package must be installed.  
     12If not already available on your operating system, you can download it at the [http://docutils.sourceforge.net/rst.html RST Website]. 
    1313 
    14  * reStructuredText  Web サイト -- http://docutils.sourceforge.net/rst.html 
    15  * RST クイックリファレンス -- http://docutils.sourceforge.net/docs/rst/quickref.html 
     14Install docutils using `easy_install docutils`. Do not use the package manager of your OS (e.g. `apt-get install python-docutils`), because Trac will not find docutils then. 
     15 
     16=== More information on RST === 
     17 
     18 * reStructuredText Website -- http://docutils.sourceforge.net/rst.html 
     19 * RST Quick Reference -- http://docutils.sourceforge.net/docs/rst/quickref.html 
    1620 
    1721---- 
    1822 
    19 == RST を Trac で使用する == #UsingRSTinTrac 
    20 テキストブロックが RST でパースされるようにするには、 ''rst'' プロセッサを使用してください。 
     23== Using RST in Trac == 
     24To specify that a block of text should be parsed using RST, use the ''rst'' processor.  
    2125 
    22 === reStructuredText における TracLinks === #TracLinksinreStructuredText 
     26=== TracLinks in reStructuredText === 
    2327 
    24  * Trac は RST テキストの中で TracLinks が可能になる、 RST のリファレンスディレクティブ 'trac' を提供しています。 
     28 * Trac provides a custom RST directive `trac::` to allow TracLinks from within RST text. 
    2529 
    26  : 
     30 Example: 
    2731 {{{ 
    2832 {{{ 
     
    3438 }}} 
    3539 
    36  ''trac'' ディレクティブのすべての使用例の一覧は、 WikiRestructuredTextLinks を見てください。 
     40 * Trac allows an even easier way of creating TracLinks in RST, using the custom `:trac:` role. 
    3741 
    38  
    39  * Trac は RST で TracLinks を簡単に作成できるように、 '':trac:'' という名前 (naming scheme) を予約しています。 
    40  
    41  例: 
     42 Example: 
    4243 {{{ 
    4344 {{{ 
     
    4950 }}} 
    5051 
    51 === reStructuredText におけるシンタックスハイライト === #SyntaxhighlightinginreStructuredText 
     52 For a complete example of all uses of the `:trac:` role, please see WikiRestructuredTextLinks.  
    5253 
    53 同様に、 RST において TracSyntaxColoring を行なうディレクティブがあります。 
    54 ディレクティブは code-block と呼ばれます。 
    5554 
    56  
     55=== Syntax highlighting in reStructuredText === 
     56 
     57There is a directive for doing TracSyntaxColoring in RST as well. The directive is called 
     58code-block 
     59 
     60Example 
    5761 
    5862{{{ 
     
    7074}}} 
    7175 
    72 上記の例は以下のように見えます。 
     76Will result in the below. 
    7377 
    7478{{{ 
     
    8488}}} 
    8589 
    86 === reStructuredText の中における Wiki Macros === #WikiMacrosinreStructuredText 
     90=== Wiki Macros in reStructuredText === 
    8791 
    88 [WikiMacros Wiki マクロ] を ReST の中で使用するには、例えば code-block のようなシンタックスハイライトと同様の 
    89 ディレクティブを使用します。動作させるためには [http://trac.edgewall.org/ticket/801 #801] のパッチ適用をした Trac を使用しなければなりません。 
     92For doing [WikiMacros Wiki Macros] in RST you use the same directive as for syntax highlighting i.e code-block. 
    9093 
    91 === Wiki Macros の例 === #WikiMacroExample 
     94=== Wiki Macro Example === 
    9295 
    9396{{{ 
     
    102105}}} 
    103106 
    104 この結果は以下のようになります: 
     107Will result in the below: 
    105108 
    106109     [[RecentChanges(Trac,3)]] 
    107110 
    108 より簡素な構文でも Wiki マクロを利用できます: 
     111Or a more concise Wiki Macro like syntax is also available: 
    109112 
    110113{{{ 
     
    116119}}} 
    117120 
    118 === より大きい ReST の例 === #BiggerReSTExample 
    119 この例のように書くと、とても分かりやすくなります: 
     121=== Bigger RST Example === 
     122The example below should be mostly self-explanatory: 
    120123{{{ 
    121124#!html 
    122125<pre class="wiki">{{{ 
    123126#!rst 
    124 ほげほげヘッダ 
    125 ============== 
    126 reStructuredText は **素敵** 。この続きは webpage_ で。 
     127FooBar Header 
     128============= 
     129reStructuredText is **nice**. It has its own webpage_. 
    127130 
    128 : 
     131A table: 
    129132 
    130 ==  ==  ====== 
    131  入力    出力 
    132 ------  ------ 
    133 A   B   A or B 
    134 ==  ==  ====== 
    135 偽  偽    偽 
    136 真  偽    真 
    137 偽  真    真 
    138 真  真    真 
    139 ==  ==  ====== 
     133=====  =====  ====== 
     134   Inputs     Output 
     135------------  ------ 
     136  A      B    A or B 
     137=====  =====  ====== 
     138False  False  False 
     139True   False  True 
     140False  True   True 
     141True   True   True 
     142=====  =====  ====== 
    140143 
    141 RST での TracLinks 
    142 ------------------ 
     144RST TracLinks 
     145------------- 
    143146 
    144 チケット `[http://trac.edgewall.org/ticket/42 #42]`:trac: のように使用します。 
     147See also ticket `#42`:trac:. 
    145148 
    146149.. _webpage: http://docutils.sourceforge.net/rst.html 
     
    149152 
    150153 
    151 結果: 
     154Results in: 
    152155{{{ 
    153156#!rst 
    154 ほげほげヘッダ 
    155 ============== 
    156 reStructuredText は **素敵** 。この続きは webpage_ で。 
     157FooBar Header 
     158============= 
     159reStructuredText is **nice**. It has its own webpage_. 
    157160 
    158 : 
     161A table: 
    159162 
    160 ==  ==  ====== 
    161  入力    出力 
    162 ------  ------ 
    163 A   B   A or B 
    164 ==  ==  ====== 
    165 偽  偽    偽 
    166 真  偽    真 
    167 偽  真    真 
    168 真  真    真 
    169 ==  ==  ====== 
     163=====  =====  ====== 
     164   Inputs     Output 
     165------------  ------ 
     166  A      B    A or B 
     167=====  =====  ====== 
     168False  False  False 
     169True   False  True 
     170False  True   True 
     171True   True   True 
     172=====  =====  ====== 
    170173 
    171 RST での TracLinks 
    172 ------------------ 
     174RST TracLinks 
     175------------- 
    173176 
    174 チケット `[http://trac.edgewall.org/ticket/42 #42]`:trac: のように使用します。 
     177See also ticket `#42`:trac:. 
    175178 
    176179.. _webpage: http://docutils.sourceforge.net/rst.html 
    177180}}} 
    178181 
    179 '''訳注: 日本語でテーブルを作成する場合、 Python-2.4 以降かつ docutils-0.4 以降でない場合は、 docutils に日本語テーブルパッチを適用する必要があります。''' 
    180182 
    181183----