Changes between Version 1 and Version 2 of WikiRestructuredText


Ignore:
Timestamp:
Aug 13, 2014, 12:08:18 AM (10 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • WikiRestructuredText

    v1 v2  
    1212あなたのオペレーティングシステムでまだ使用できない場合は、 [http://docutils.sourceforge.net/rst.html RST Website] からダウンロードすることができます。
    1313
    14 docutils のインストールには `easy_install docutils` を使用してください。 Trac が docutils パッケージを探すことが出来ない可能性があるので、 (`apt-get install python-docutils` などの) OS のパッケージマネージャは使わないでください。
    15 ('''訳注:''' docutils が提供している `setup.py` では `setuptools` を使用していないため、 OS のパッケージでは `docutils-*.egg-info` が作成されない場合があることを指しています。 egg-info さえ作成されていれば OS のパッケージマネージャを使用しても問題ないと思われます。)
     14docutils のインストールには `easy_install docutils` を使用してください。 Trac が docutils パッケージを探すことが出来ない可能性があるので、 (`apt-get install python-docutils` などの) OS のパッケージマネージャは使わないでください。('''訳注:''' docutils が提供している `setup.py` では `setuptools` を使用していないため、 OS のパッケージでは `docutils-*.egg-info` が作成されない場合があることを指しています。 egg-info さえ作成されていれば OS のパッケージマネージャを使用しても問題ないと思われます。)
    1615
    1716=== さらなる RST に関する情報 === #MoreinformationonRST
    … …  
    2726=== reStructuredText における TracLinks === #TracLinksinreStructuredText
    2827
    29  * Trac は RST テキストの中で TracLinks が可能になる、 RST のディレクティブ 'trac' を提供しています。
    30 
    31  例:
    32  {{{
    33  {{{
    34  #!rst
    35  This is a reference to |a ticket|
    36 
    37  .. |a ticket| trac:: #42
    38  }}}
    39  }}}
    40 
    41  * Trac は RST で TracLinks を簡単に作成できるように、 `:trac:` というロールを予約しています。
    42 
    43  例:
    44  {{{
    45  {{{
    46  #!rst
    47  This is a reference to ticket `#12`:trac:
    48 
    49  To learn how to use Trac, see `TracGuide`:trac:
    50  }}}
    51  }}}
     28 * Trac は RST テキストの中で TracLinks が可能になる、 RST のディレクティブ 'trac' を提供しています
     29   ||= Wiki マークアップ ||= 表示 ||
     30   {{{#!td
     31     {{{
     32     {{{
     33     #!rst
     34     これは |チケット| へのリンクです。
     35
     36     .. |チケット| trac:: #42
     37     }}}
     38     }}}
     39   }}}
     40   {{{#!td
     41     {{{
     42     #!rst
     43     これは |チケット| へのリンクです。
     44
     45     .. |チケット| trac:: #42
     46     }}}
     47   }}}
     48
     49 * Trac は RST で TracLinks を簡単に作成できるように、 `:trac:` というロールを予約しています
     50   ||= Wiki マークアップ ||= 表示 ||
     51   {{{#!td
     52     {{{
     53     {{{
     54     #!rst
     55     これはチケット `#12`:trac: へのリンクです。
     56
     57     Trac の使い方を学ぶためには、 `TracGuide`:trac: を参照して下さい。
     58     }}}
     59     }}}
     60   }}}
     61   {{{#!td
     62     {{{
     63     #!rst
     64     これはチケット `#12`:trac: へのリンクです。
     65
     66     Trac の使い方を学ぶためには、 `TracGuide`:trac: を参照して下さい。
     67     }}}
     68   }}}
    5269
    5370 `:trac:` ロールのすべての使用例の一覧は、 WikiRestructuredTextLinks を見てください。
    … …  
    5976ディレクティブは code-block と呼ばれます。
    6077
    61 例
    62 
    63 {{{
    64 {{{
    65 #!rst
    66 
    67 .. code-block:: python
    68 
    69  class Test:
    70 
    71     def TestFunction(self):
    72         pass
    73 
    74 }}}
    75 }}}
    76 
    77 上記の例は以下のように見えます。
    78 
    79 {{{
    80 #!rst
    81 
    82 .. code-block:: python
    83 
    84  class Test:
    85 
    86     def TestFunction(self):
    87         pass
    88 
    89 }}}
     78||= Wiki マークアップ ||= 表示 ||
     79{{{#!td
     80  {{{
     81  {{{
     82  #!rst
     83
     84  .. code-block:: python
     85
     86     class Test:
     87
     88         def TestFunction(self):
     89             pass
     90
     91  }}}
     92  }}}
     93}}}
     94{{{#!td
     95  {{{
     96  #!rst
     97
     98  .. code-block:: python
     99
     100     class Test:
     101
     102         def TestFunction(self):
     103             pass
     104
     105  }}}
     106}}}
     107`.. code-block` ディレクティブの後のコードは少なくとも1文字インデントする必要があります。
    90108
    91109=== reStructuredText の中における Wiki Macros === #WikiMacrosinreStructuredText
    92110
    93111[WikiMacros Wiki マクロ] を RST の中で使用するには、 code-block のようなシンタックスハイライトと同様のディレクティブを使用します。
    94 動作させるためには [http://trac.edgewall.org/ticket/801 #801] のパッチ適用をした Trac を使用しなければなりません。
    95 
    96 === Wiki Macros の例 === #WikiMacroExample
    97 
    98 {{{
    99 {{{
    100 #!rst
    101 
    102 .. code-block:: RecentChanges
    103 
    104    Trac,3
    105 
    106 }}}
    107 }}}
    108 
    109 この結果は以下のようになります:
    110 
    111      [[RecentChanges(Trac,3)]]
    112 
    113 より簡素な構文でも Wiki マクロを利用できます:
    114 
    115 {{{
    116 {{{
    117 #!rst
    118 
    119 :code-block:`RecentChanges:Trac,3`
    120 }}}
     112
     113||= Wiki マークアップ ||= 表示 ||
     114{{{#!td
     115  {{{
     116  {{{
     117  #!rst
     118
     119  .. code-block:: RecentChanges
     120
     121     Trac,3
     122
     123  }}}
     124  }}}
     125}}}
     126{{{#!td
     127  {{{
     128  #!rst
     129
     130  .. code-block:: RecentChanges
     131
     132     Trac,3
     133
     134  }}}
     135}}}
     136
     137`:code-block:` を使って、より簡素な構文でも Wiki マクロを利用できます:
     138
     139||= Wiki マークアップ ||= 表示 ||
     140{{{#!td
     141  {{{
     142  {{{
     143  #!rst
     144
     145  :code-block:`RecentChanges:Trac,3`
     146  }}}
     147  }}}
     148}}}
     149{{{#!td
     150  {{{
     151  #!rst
     152
     153  :code-block:`RecentChanges:Trac,3`
     154  }}}
    121155}}}
    122156
    123157=== より大きい RST の例 === #BiggerRSTExample
    124158この例のように書くと、とても分かりやすくなります:
     159
     160||= Wiki マークアップ ||= 表示 ||
     161{{{#!td
    125162{{{
    126163#!html
    … …  
    147184------------------
    148185
    149 チケット `[http://trac.edgewall.org/ticket/42 #42]`:trac: のように使用します。
     186チケット `[trac:#42]`:trac: のように使用します。
    150187
    151188.. _webpage: http://docutils.sourceforge.net/rst.html
    152189}}}</pre>
    153190}}}
    154 
    155 
    156 結果:
     191}}}
     192{{{#!td
    157193{{{
    158194#!rst
    … …  
    177213------------------
    178214
    179 チケット `[http://trac.edgewall.org/ticket/42 #42]`:trac: のように使用します。
     215チケット `[trac:#42]`:trac: のように使用します。
    180216
    181217.. _webpage: http://docutils.sourceforge.net/rst.html
     218}}}
    182219}}}
    183220