Changes between Version 1 and Version 2 of WikiFormatting


Ignore:
Timestamp:
Sep 2, 2019, 4:56:56 PM (5 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • WikiFormatting

    v1 v2  
    1 = Wiki 文法 = #WikiFormatting
     1= WikiFormatting
     2
    23[[TracGuideToc]]
    34
    4 Wiki マークアップは Trac のコアとなる機能です。他のパーツと緊密に統合することによって、 Trac をフレキシブルかつ強力にしています。
    5 
    6 Trac はビルトインの小規模だけれども強力な wiki のレンダリングエンジンを搭載しています。この wiki エンジンは他の有名な wiki のコマンドのサブセット
    7 特に、 [http://moinmo.in/ MoinMoin] や [trac:WikiCreole] を拡張して実装しています。
    8 
    9 
    10 このページでは、 WikiFormatting が使用できるところではどこでも使用できる wiki のマークアップについて掘り下げた説明をします。
    11 
    12 以下に記述する ''チートシート'' に最も一般的なシンタックスのちょっとした概要を載せます。 ''カテゴリ'' カラムの中にあるそれぞれのリンクをたどってこのページの下の方にある詳細な説明を見ることができます。
    13 
    14 いくつかの他の wiki ページにも Trac の wiki のマークアップについて詳細な特徴について、より掘り下げて書かれています:
    15  - TracLinks はいかなる Trac のリソースまたはその一部を正確に参照する方法についてカバーしています
    16  - WikiPageNames wiki ページの命名規則、 CamelCase かそれ以外かについて書かれています
    17  - WikiMacros には動的にコンテンツを生成するためのマクロの一覧がリストされています
    18  - WikiProcessors と WikiHtml には wiki テキストの一部を特別な方法で処理する方法についての詳細が書かれています
    19 
    20 
    21 == チートシート == #Cheatsheet
    22 
    23 ||= '''カテゴリ''' =||= '''Wiki マークアップ''' =||= '''表示''' =||
     5Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into a flexible and unified whole.
     6
     7Trac has a powerful wiki rendering engine that implements a subset of the commands from other popular Wikis, such as [https://moinmo.in/ MoinMoin] and [trac:WikiCreole].
     8
     9The sections below provide an overview for the most common syntax, each link in the ''Category'' column leads you to the more detailed explanation later in this page.
     10
     11The following wiki pages present the advanced features of the Trac wiki markup in more depth:
     12 - TracLinks covers all the possible ways to refer to any Trac resource or parts thereof.
     13 - WikiPageNames covers the various names a wiki page can take, whether in CamelCase or not.
     14 - WikiMacros lists the macros available for generating dynamic content.
     15 - WikiProcessors and WikiHtml details how parts of the wiki text can be processed in special ways.
     16 - [trac:wiki:TracDev/Proposals/AdvancedWikiOperations AdvancedWikiOperations] provides some operations in uncommon or administrative scenarios.
     17
     18== Common wiki markup
     19
     20||= '''Category''' =||= '''Wiki Markup''' =||= '''Display''' =||
    2421|-----------------------------------------------------------
    2522{{{#!th rowspan=3
    26 [#FontStyles フォント書式]
    27 }}}
    28 || `'''太字'''`, `''斜体''`, `'''''Wikipedia 書式'''''` || \
    29 || '''太字''', ''斜体'', '''''Wikipedia 書式''''' ||
    30 || {{{`等幅 (''他のマークアップを無視'')`}}} || \
    31 || `等幅 (''他のマークアップを無視'')` ||
    32 || `**太字**`, `//斜体//`, `**//!WikiCreole 書式//**` || \
    33 || **太字**, //斜体//, **//!WikiCreole 書式//** ||
    34 |-----------------------------------------------------------
    35 ||= [#Headings 見出し] =||\
    36 {{{#!td
    37  {{{
    38  == 見出し 2 ==
    39  === 見出し 3 ^([#hn 注])^
     23[#FontStyles Font Styles]
     24}}}
     25|| `'''bold'''`, `''italic''`, `'''''Wikipedia style'''''` || \
     26|| '''bold''', ''italic'', '''''Wikipedia style''''' ||
     27|| `**bold**`, `//italic//`, `**//!WikiCreole style//**` || \
     28|| **bold**, //italic//, **//!WikiCreole style//** ||
     29|| {{{`monospaced (''other markup ignored'')`}}} || \
     30|| `monospaced (''other markup ignored'')` ||
     31|-----------------------------------------------------------
     32||= [#Headings Headings] =||\
     33{{{#!td 
     34 {{{
     35 == Level 2
     36 === Level 3 ^([#hn note])^
    4037 }}}
    4138}}}
    4239{{{#!td style="padding-left: 2em"
    43 == 見出し 2 ==
    44 === 見出し 3 ^([#hn 注])^
    45 }}}
    46 |-----------------------------------------------------------
    47 ||= [#Paragraphs 改行]  =||\
    48 {{{#!td
    49  {{{
    50  複数行の
    51  第一段落
    52 
    53  第二段落
    54  }}}
    55 }}}
    56 {{{#!td
    57 複数行の
    58 第一段落
    59 
    60 第二段落
    61 }}}
    62 |-----------------------------------------------------------
    63 ||= [#Lists リスト] =||\
    64 {{{#!td
    65  {{{
    66  * 複数行の
    67    番号なしリスト
    68    1. ネストしたリスト
    69      a. 異なる番号付け
    70         書式
    71  }}}
    72 }}}
    73 {{{#!td
    74 * 複数行の
    75   番号なしリスト
    76   1. ネストしたリスト
    77     a. 異なる番号付け
    78        書式
     40== Level 2
     41=== Level 3 ^([#hn note])^
     42}}}
     43|-----------------------------------------------------------
     44||= [#Paragraphs Paragraphs]  =||\
     45{{{#!td
     46 {{{
     47 First paragraph
     48 on multiple lines.
     49
     50 Second paragraph.
     51 }}}
     52}}}
     53{{{#!td
     54First paragraph
     55on multiple lines.
     56
     57Second paragraph.
     58}}}
     59|-----------------------------------------------------------
     60||= [#Lists Lists] =||\
     61{{{#!td
     62 {{{
     63 * bullet list
     64   on multiple lines
     65   1. nested list
     66     a. different numbering
     67        styles
     68 }}}
     69}}}
     70{{{#!td
     71* bullet list
     72  on multiple lines
     73  1. nested list
     74    a. different numbering
     75       styles
    7976}}}
    8077|-----------------------------------------------------------
    8178{{{#!th
    82 [#DefinitionLists 用語定義リスト]
    83 }}}
    84 {{{#!td
    85  {{{
    86   用語:: 複数行にわたる
    87          用語の定義
    88  }}}
    89 }}}
    90 {{{#!td
    91  用語:: 複数行にわたる
    92         用語の定義
    93 }}}
    94 |-----------------------------------------------------------
    95 ||= [#PreformattedText 整形済みテキスト] =||\
    96 {{{#!td
    97  {{{
    98  {{{
    99  複数行、 ''no wiki''
    100        空白文字も除去しない
    101  }}}
    102  }}}
    103 }}}
    104 {{{#!td
    105  {{{
    106  複数行、 ''no wiki''
    107        空白文字も除去しない
    108  }}}
    109 }}}
    110 |-----------------------------------------------------------
    111 ||= [#Blockquotes 引用ブロック] =||\
    112 {{{#!td
    113  {{{
    114    もし、いくつかのスペースが行の先頭にある場合、
    115    テキストは引用を表します。
    116  }}}
    117 }}}
    118 {{{#!td
    119  もし、いくつかのスペースが行の先頭にある場合、
    120  テキストは引用を表します。
    121 }}}
    122 |-----------------------------------------------------------
    123 ||= [#DiscussionCitations 引用] =||\
     79[#DefinitionLists Definition Lists]
     80}}}
     81{{{#!td
     82 {{{
     83  term:: definition on
     84         multiple lines
     85 }}}
     86}}}
     87{{{#!td
     88 term:: definition on
     89        multiple lines
     90}}}
     91|-----------------------------------------------------------
     92||= [#PreformattedText Preformatted Text] =||\
     93{{{#!td
     94 {{{
     95 {{{
     96 multiple lines, ''no wiki'',
     97       white space respected
     98 }}}
     99 }}}
     100}}}
     101{{{#!td
     102 {{{
     103 multiple lines, ''no wiki'',
     104       white space respected
     105 }}}
     106}}}
     107|-----------------------------------------------------------
     108||= [#Blockquotes Blockquotes] =||\
     109{{{#!td
     110 {{{
     111   if there's some leading
     112   space the text is quoted
     113 }}}
     114}}}
     115{{{#!td
     116 if there's some leading
     117 space the text is quoted
     118}}}
     119|-----------------------------------------------------------
     120||= [#DiscussionCitations Discussion Citations] =||\
    124121{{{#!td
    125122 {{{
    … …  
    133130}}}
    134131|-----------------------------------------------------------
    135 ||= [#Tables 表] =||\
    136 {{{#!td
    137  {{{
    138  ||= 表のヘッダ =|| セル ||
    139  ||||  (詳細は下記参照)  ||
    140  }}}
    141 }}}
    142 {{{#!td
    143 ||= 表のヘッダ =|| セル ||
    144 ||||  (詳細は下記参照)  ||
     132||= [#Tables Tables] =||\
     133{{{#!td
     134 {{{
     135 ||= Table Header =|| Cell ||
     136 ||||  (details below)  ||
     137 }}}
     138}}}
     139{{{#!td
     140||= Table Header =|| Cell ||
     141||||  (details below)  ||
    145142}}}
    146143|-----------------------------------------------------------
    147144{{{#!th rowspan=2
    148 [#Links リンク]
    149 }}}
    150 || `http://trac.edgewall.org` ||\
    151 || http://trac.edgewall.org ||
     145[#Links Links]
     146}}}
     147|| `https://trac.edgewall.org` ||\
     148|| https://trac.edgewall.org ||
    152149|| `WikiFormatting (CamelCase)` ||\
    153150|| WikiFormatting (CamelCase) ||
    154151|-----------------------------------------------------------
    155152{{{#!th rowspan=5
    156 [#TracLinks Trac リンク]
     153[#TracLinks TracLinks]
    157154}}}
    158155|| `wiki:WikiFormatting`, `wiki:"WikiFormatting"` ||\
    159156|| wiki:WikiFormatting, wiki:"WikiFormatting" ||
    160 || `#1 (チケット)`, `[1] (チェンジセット)`, `{1} (レポート)` ||\
    161 || #1 (チケット), [1] (チェンジセット), {1} (レポート) ||
    162 || `ticket:1, ticket:1#comment:1` ||\
    163 || ticket:1, ticket:1#comment:1 ||
    164 || `チケット [ticket:1]`, `[ticket:1 チケット 1]` ||\
    165 || チケット [ticket:1], [ticket:1 チケット 1] ||
    166 || `チケット [[ticket:1]]`, `[[ticket:1|チケット 1]]` ||\
    167 || チケット [[ticket:1]], [[ticket:1|チケット 1]] ||
    168 |-----------------------------------------------------------
    169 {{{#!th rowspan=2
    170 [#SettingAnchors アンカーの設定]
    171 }}}
    172 || `[=#point1 (1)] 1 つ目...` ||\
    173 || [=#point1 (1)] 1 つ目... ||
    174 || `[#point1 (1)] 参照` ||\
    175 || [#point1 (1)] 参照 ||
     157|| `#1 (ticket)`, `[1] (changeset)`, `{1} (report)` ||\
     158|| #1 (ticket), [1] (changeset), {1} (report) ||
     159|| `ticket:1, ticket:1#comment:1, comment:1:ticket:1` ||\
     160|| ticket:1, ticket:1#comment:1, comment:1:ticket:1 ||
     161|| `Ticket [ticket:1]`, `[ticket:1 ticket one]` ||\
     162|| Ticket [ticket:1], [ticket:1 ticket one] ||
     163|| `Ticket [[ticket:1]]`, `[[ticket:1|ticket one]]` ||\
     164|| Ticket [[ticket:1]], [[ticket:1|ticket one]] ||
     165|-----------------------------------------------------------
     166{{{#!th rowspan=2 
     167[#SettingAnchors Setting Anchors]
     168}}}
     169|| `[=#point1 (1)] First...` ||\
     170|| [=#point1 (1)] First... ||
     171|| `see [#point1 (1)]` ||\
     172|| see [#point1 (1)] ||
    176173|-----------------------------------------------------------
    177174{{{#!th rowspan=3
    178 [#EscapingLinksWikiPageNamesandotherMarkup リンクの無効化]
    179 }}}
    180 || `!'' シングルクオテーション 2 つ` ||\
    181 || !'' シングルクオテーション 2 つ ||
     175[#Escaping Escaping Markup]
     176}}}
     177|| `!'' doubled quotes` ||\
     178|| !'' doubled quotes ||
    182179|| `!wiki:WikiFormatting`, `!WikiFormatting` ||\
    183180|| !wiki:WikiFormatting, !WikiFormatting ||
    184 || {{{`}}}`{{{-}}}`{{{`}}}` 3重中括弧` ||\
    185 || `{{{-}}}` 3重中括弧 ||
    186 |-----------------------------------------------------------
    187 ||= [#Images 画像] =|| `[[Image(`''link''`)]]` || [[Image(htdocs:../common/trac_logo_mini.png)]] ||
     181|| [[html(<code>`{{{-}}}` triple curly brackets</code>)]] ||\
     182|| `{{{-}}}` triple curly brackets ||
     183|-----------------------------------------------------------
     184||= [#Images Images] =|| `[[Image(`''link''`)]]` || [[Image(htdocs:../common/trac_logo_mini.png)]] ||
    188185|-----------------------------------------------------------
    189186{{{#!th rowspan=2
    190 [#Macros マクロ]
    191 }}}
    192 || `[[MacroList(*)]]` ||  ''(簡単なマクロ一覧)''  ||
    193 || `[[Image?]]` ||  ''(イメージマクロのヘルプ)''  ||
    194 |-----------------------------------------------------------
    195 ||= [#Processors プロセッサ] =||\
    196 {{{#!td
    197  {{{
    198  {{{
    199  #!div style="font-size: 80%"
    200  ソースコードのハイライト:
     187[#Macros Macros]
     188}}}
     189|| `[[MacroList(*)]]` ||  ''(short list of all available macros)''  ||
     190|| `[[Image?]]` ||  ''(help for the Image macro)''  ||
     191|-----------------------------------------------------------
     192||= [#Processors Processors] =||\
     193{{{#!td
     194 {{{
     195 {{{#!div style="font-size: 80%"
     196 Code highlighting:
    201197   {{{#!python
    202198   hello = lambda: "world"
    … …  
    206202}}}
    207203{{{#!td style="padding-left: 2em"
    208  {{{
    209  #!div style="font-size: 80%"
    210  ソースコードのハイライト:
    211    {{{#!python
     204 {{{#!div style="font-size: 80%"
     205 Code highlighting:
     206   {{{#!python
    212207   hello = lambda: "world"
    213208   }}}
    … …  
    215210}}}
    216211|-----------------------------------------------------------
    217 ||= [#Comments コメント] =||\
     212||= [#Comments Comments] =||\
    218213{{{#!td
    219214 {{{
    220215 {{{#!comment
    221  編集している人への注: ...
    222  }}}
     216 Note to Editors: ...
     217 }}}
     218 }}}
     219}}}
     220||  ''(comment is shown in edit mode only)''  ||
     221|-----------------------------------------------------------
     222||= [#Miscellaneous Miscellaneous] =||\
     223{{{#!td
     224 {{{
     225 Line [[br]] break
     226 Line \\ break
     227 ----
    223228 }}}
    224229}}}
    225230{{{#!td style="padding-left: 2em"
    226  {{{#!comment
    227  編集している人への注: ...
    228  }}}
    229 }}}
    230 |-----------------------------------------------------------
    231 ||= [#Miscellaneous その他] =||\
    232 {{{#!td
    233  {{{
    234  改 [[br]] 行
    235  改 \\ 行
    236  ----
    237  }}}
    238 }}}
    239 {{{#!td style="padding-left: 2em"
    240 改 [[br]] 行
    241 改 \\ 行
     231Line [[br]] break
     232Line \\ break
    242233----
    243234}}}
    244235
    245 
    246 == フォント書式 == #FontStyles
    247 
    248 Trac の Wiki は以下のフォント書式に対応しています:
    249 ||= Wiki マークアップ =||= 表示 =||
    250 {{{#!td
    251   {{{
    252    * '''太字''',
    253      ''' シングルクオテーションを 3 つ (!''') も
    254      頭にエクスクラメーションマーク (!) を付ければ、太字になります'''
    255    * ''斜体''
    256    * '''''太字 + 斜体''''' そして ''斜体と
    257      ''' 斜体 + 太字 ''' ''
    258    * __下線__
    259    * {{{等幅}}} または `等幅`
    260      (ゆえに `{{{` または {{{`}}} で囲む)
    261    * ~~取り消し線~~
    262    * ^上付き文字^
    263    * ,,下付き文字,,
    264    * **これも太字**, //これは斜体//,
    265      そして **'' 太字 + 斜体 **'' //(0.12 以降)//
    266   }}}
    267 }}}
    268 {{{#!td
    269  * '''太字''',
    270    ''' シングルクオテーションを 3 つ (!''') も
    271    頭にエクスクラメーションマーク (!) を付ければ、太字になります。''',
    272  * ''斜体''
    273  * '''''太字 + 斜体''''' そして ''斜体と
    274    ''' 斜体 + 太字 ''' ''
    275  * __下線__
    276  * {{{等幅}}} または `等幅`
    277    (ゆえに `{{{` または {{{`}}} で囲む)
    278  * ~~取り消し線~~
    279  * ^上付き文字^
    280  * ,,下付き文字,,
    281  * **これも太字**, //これは斜体//,
    282    そして **'' 太字 + 斜体 **'' //(0.12 以降)//
    283 }}}
    284 
    285 Note:
    286  * `{{{...}}}`と {{{`...`}}} コマンドは表示を等角フォントにするだけではなく、内容を整形済みテキストとして扱います。つまりテキストに対して、どのような Wiki 処理も行いません
    287  * {{{ ! }}} は wiki パーサに wiki フォーマットとして解釈しないように伝えます。なので、 ! の後ろにスペースを置くことに注意して下さい。例えば、太字で行が終わるようなときです
    288  * すべてのフォント書式の記号は開始記号と終了記号のペアで使われなければなりません
    289    そして、これらのペアは適切にネストされなければなりません ( 特に、斜体の `''` は
    290    `//` とペアにすることはできませんし、太字の `'''` は `**` とペアにすることはできません )
    291 
    292 
    293 == 見出し == #Headings
    294 
    295 見出しは、その行を 1 つから 6 つまでの等号記号 ("=") ではじめ、
    296 その後にスペースを 1 つおいて、見出しのテキストを記述することにより作成することができます。
     236== Font Styles
     237
     238The Trac wiki supports the following font styles:
     239||= Wiki Markup =||= Display =||
     240{{{#!td
     241  {{{
     242   * '''bold''',
     243     ''' triple quotes !'''
     244     can be bold too if prefixed by ! ''',
     245   * ''italic''
     246   * '''''bold italic''''' or ''italic and
     247     ''' italic bold ''' ''
     248   * __underline__
     249   * {{{monospace}}} or `monospace`
     250     (hence `{{{` or {{{`}}} quoting)
     251   * ~~strike-through~~
     252   * ^superscript^
     253   * ,,subscript,,
     254   * **also bold**, //italic as well//,
     255     and **'' bold italic **'' //(since 0.12)//
     256   * [[span(style=color: #FF0000, a red text )]]
     257  }}}
     258}}}
     259{{{#!td
     260 * '''bold''',
     261   ''' triple quotes !'''
     262   can be bold too if prefixed by ! ''',
     263 * ''italic''
     264 * '''''bold italic''''' or ''italic and
     265   ''' italic bold ''' ''
     266 * __underline__
     267 * {{{monospace}}} or `monospace`
     268   (hence `{{{` or {{{`}}} quoting)
     269 * ~~strike-through~~
     270 * ^superscript^
     271 * ,,subscript,,
     272 * **also bold**, //italic as well//,
     273   and **'' bold italic **'' //(since 0.12)//
     274 * [[span(style=color: #FF0000, a red text )]]
     275}}}
     276
     277Notes:
     278 * `{{{...}}}` and {{{`...`}}} commands not only select a monospace font, but also treat their content as verbatim text, meaning that no further wiki processing is done on this text.
     279 * {{{ ! }}} tells wiki parser to not take the following characters as wiki format, so pay attention to put a space after `!`, e.g. when ending bold.
     280 * all the font styles marks have to be used in opening/closing pairs,
     281   and they must nest properly; in particular, an `''` italic can't be paired
     282   with a `//` one, and `'''` can't be paired with `**`.
     283
     284== Headings
     285
     286You can create a heading by starting a line with one up to six ''equal'' characters (`=`) followed by a single space and the headline text.
    297287
    298288[=#hn]
    299 見出しのテキストの後ろには同じ数の等号 ("=") が必要ですが、もはやこれは必須ではありません。
    300 
    301 ついに、ヘッダは 1 つの明示的な id によって選択的に追えるかもしれません。そうでなければ、暗黙ではあるけれども読み取り可能な id が生成されます。
    302 
    303 ||= Wiki マークアップ =||= 表示 =||
    304 {{{#!td
    305   {{{
    306   = 見出し1 =
    307   == 見出し2
    308   === ''これ'' について ===
    309   === 明示的な Id === #using-explicit-id-in-heading
    310   == 見出し2 #sub2
     289The headline text can be followed by the same number of `=` characters, but this is not mandatory. That is, `=== Section3 ===` is identical to `=== Section3`.
     290
     291Finally, the heading might optionally be followed by an explicit id. If not, an implicit but nevertheless readable id will be generated.
     292
     293||= Wiki Markup =||= Display =||
     294{{{#!td
     295  {{{
     296  = Heading =
     297  == Subheading
     298  === About ''this'' ===
     299  === Explicit id === #using-explicit-id-in-heading
     300  == Subheading #sub2
    311301}}}
    312302}}}
    … …  
    314304  {{{
    315305  #!div
    316   = 見出し1 =
    317   == 見出し2
    318   === ''これ'' について ===
    319   === 明示的な Id === #using-explicit-id-in-heading
    320   == 見出し2 #sub2
    321   }}}
    322 }}}
    323 
    324 == 改行 == #Paragraphs
    325 
    326 2 つのテキストブロックの間に 1 行以上の空行がある場合、新しい段落として改行を行います。
    327 
    328 強制的に改行だけを行いたい場合、このように書いてください:
    329 ||= Wiki マークアップ =||= 表示 =||
    330 {{{#!td
    331   {{{
    332   行 1[[BR]]行 2
    333   }}}
    334   {{{
    335   段落
    336   1
    337 
    338   段落
    339   2
    340   }}}
    341 }}}
    342 {{{#!td
    343   行 1[[BR]]行 2
    344 
    345   段落
    346   1
    347 
    348   段落
    349   2
    350 }}}
    351 
    352 == リスト == #Lists
    353 
    354 番号付きリストと番号無しリストの両方があります。
    355 
    356 例:
    357 ||= Wiki マークアップ =||= 表示 =||
     306  = Heading =
     307  == Subheading
     308  === About ''this'' ===
     309  === Explicit id === #using-explicit-id-in-heading
     310  == Subheading #sub2
     311  }}}
     312}}}
     313
     314== Paragraphs
     315
     316A new text paragraph is created whenever two blocks of text are separated by one or more empty lines.
     317
     318A forced line break can also be inserted, using:
     319||= Wiki Markup =||= Display =||
     320{{{#!td
     321  {{{
     322  Line 1[[BR]]Line 2
     323  }}}
     324  {{{
     325  Paragraph
     326  one
     327
     328  Paragraph
     329  two
     330  }}}
     331}}}
     332{{{#!td
     333  Line 1[[BR]]Line 2
     334
     335  Paragraph
     336  one
     337
     338  Paragraph
     339  two
     340}}}
     341
     342== Lists
     343
     344The wiki supports both ordered/numbered and unordered lists.
     345
     346||= Wiki Markup =||= Display =||
    358347{{{#!td
    359348  {{{
    360349   * Item 1
    361350     * Item 1.1
    362         * Item 1.1.1
     351        * Item 1.1.1   
    363352        * Item 1.1.2
    364353        * Item 1.1.3
    365354     * Item 1.2
    366355   * Item 2
    367   - 各項目は行の先頭から開始することができます。
    368     そして複数行にまたがることができます。
    369     - 複数行にまたがる場合は、適切なインデントをするよう
    370     注意してください。さもないと
    371   新しい段落が開始してしまいます。
    372 
     356  - items can start at the beginning of a line
     357    and they can span multiple lines
     358    - be careful though to continue the line
     359    with the appropriate indentation, otherwise
     360  that will start a new paragraph...
     361 
    373362   1. Item 1
    374363     a. Item 1.a
    … …  
    377366        i. Item 1.b.ii
    378367   1. Item 2
    379   番号付きのリストは明示的に番号を付けてあげることで
    380   リストを再開できます:
     368  And numbered lists can also be restarted
     369  with an explicit number:
    381370   3. Item 3
    382371  }}}
    … …  
    385374 * Item 1
    386375   * Item 1.1
    387       * Item 1.1.1
     376      * Item 1.1.1   
    388377      * Item 1.1.2
    389378      * Item 1.1.3
    390379   * Item 1.2
    391380 * Item 2
    392 - 各項目は行の先頭から開始することができます。
    393   そして複数行にまたがることができます。
    394   - 複数行にまたがる場合は、適切なインデントをするよう
    395   注意してください。さもないと
    396 新しい段落が開始してしまいます。
     381- items can start at the beginning of a line
     382  and they can span multiple lines
     383  - be careful though to continue the line
     384  with the appropriate indentation, otherwise
     385that will start a new paragraph...
    397386
    398387 1. Item 1
    … …  
    402391      i. Item 1.b.ii
    403392 1. Item 2
    404 番号付きのリストは明示的に番号を付けてあげることでリストを再開できます:
     393And numbered lists can also be restarted with an explicit number:
    405394 3. Item 3
    406395}}}
    407396
    408 
    409 == 用語定義リスト == #DefinitionLists
    410 
    411 Wikiは用語定義リストも作成できます。
    412 
    413 ||= Wiki マークアップ =||= 表示 =||
     397== Definition Lists
     398
     399The wiki also supports definition lists.
     400
     401||= Wiki Markup =||= Display =||
    414402{{{#!td
    415403  {{{
    416404   llama::
    417      毛の生えた哺乳類の一種。
     405     some kind of mammal, with hair
    418406   ppython::
    419      毛がない爬虫類の一種。
    420      (typoを見つけたかい?)
     407     some kind of reptile, without hair
     408     (can you spot the typo?)
    421409  }}}
    422410}}}
    423411{{{#!td
    424412 llama::
    425    毛の生えた哺乳類の一種。
     413   some kind of mammal, with hair
    426414 ppython::
    427    毛がない爬虫類の一種。
    428    (typoを見つけたかい?)
    429 }}}
    430 
    431 定義する用語の前にスペースが一つ必要なことを忘れないで下さい。
    432 
    433 
    434 == 整形済みテキスト == #PreformattedText
    435 
    436 整形済みテキストを含むブロックは、ソースコードの一部や、ノート、例示に適しています。引用ブロックとしたいテキストの前後を、 3 つの ''ブレース (curly braces)'' で括ってください。ブレースは独立した行に置かなければいけません。
    437 
    438 ||= Wiki マークアップ =||= 表示 =||
     415   some kind of reptile, without hair
     416   (can you spot the typo?)
     417}}}
     418
     419Note that you need a space in front of the defined term.
     420
     421== Preformatted Text
     422
     423Block containing preformatted text are suitable for source code snippets, notes and examples. Use three ''curly braces'' wrapped around the text to define a block quote. The curly braces need to be on a separate line.
     424 
     425||= Wiki Markup =||= Display =||
    439426{{{#!td
    440427  {{{
    … …  
    452439}}}
    453440
    454 Note: このブロックは、 [WikiProcessors Wiki プロセッサ] で処理されるべき行を示すためにも使用されます。
    455 
    456 == 引用ブロック == #Blockquotes
    457 
    458 段落を引用ブロックとしてマークするには、段落を 2 個のスペースでインデントします。
    459 
    460 ||= Wiki マークアップ =||= 表示 =||
     441Note that this kind of block is also used for selecting lines that should be processed through WikiProcessors.
     442
     443== Blockquotes
     444
     445In order to mark a paragraph as blockquote, indent that paragraph with two spaces.
     446
     447||= Wiki Markup =||= Display =||
    461448{{{#!td
    462449{{{
    463 段落
    464   このテキストは何かの引用です。
    465 }}}
    466 }}}
    467 {{{#!td
    468 段落
    469   このテキストは何かの引用です。
    470 }}}
    471 
    472 == 引用 == #DiscussionCitations
    473 
    474 進行中の議題のスレッド、チケットのコメントエリアなどで引用を表すために、メールライクな引用マーク (">", ">>" など) が使用できます。
    475 
    476 ||= Wiki マークアップ =||= 表示 =||
     450Paragraph
     451  This text is a quote from someone else.
     452}}}
     453}}}
     454{{{#!td
     455Paragraph
     456  This text is a quote from someone else.
     457}}}
     458
     459== Discussion Citations
     460
     461To delineate a citation in an ongoing discussion thread, such as the ticket comment area, email-like citation marks (`>`, `>>`, etc.) may be used. 
     462
     463||= Wiki Markup =||= Display =||
    477464{{{#!td
    478465  {{{
    … …  
    490477}}}
    491478
    492 
    493 == 表 == #Tables
    494 === Simple Tables ===
    495 簡単なテーブルはこのように記述します:
    496 ||= Wiki マークアップ =||= 表示 =||
     479== Tables
     480=== Simple Tables
     481
     482Simple tables can be created:
     483||= Wiki Markup =||= Display =||
    497484{{{#!td
    498485  {{{
    … …  
    506493}}}
    507494
    508 ヘッダとするセルは、等号 ('=') のペアで中身をラップすることで指定できます。
    509 下記の例のように、等号 ('=') はセルのセパレータとくっつけておかなければなりません:
    510 ||= Wiki マークアップ =||= 表示 =||
    511 {{{#!td
    512   {{{
    513   ||        ||= 安定版 =||= 最新版 =||
     495Cell headings can be specified by wrapping the content in a pair of `=` characters.
     496Note that the `=` characters have to stick to the cell separators:
     497||= Wiki Markup =||= Display =||
     498{{{#!td
     499  {{{
     500  ||        ||= stable =||= latest =||
    514501  ||= 0.10 =||  0.10.5  || 0.10.6dev||
    515502  ||= 0.11 =||  0.11.6  || 0.11.7dev||
    … …  
    517504}}}
    518505{{{#!td style="padding: 2em;"
    519 ||        ||= 安定版 =||= 最新版 =||
     506||        ||= stable =||= latest =||
    520507||= 0.10 =||  0.10.5  || 0.10.6dev||
    521508||= 0.11 =||  0.11.6  || 0.11.7dev||
    522509}}}
    523510
    524 最後に、空のセルを指定することは、隣の空ではないセルの範囲が空のセルまで広がることを意味します。例:
    525 ||= Wiki マークアップ =||= 表示 =||
     511Finally, specifying an empty cell means that the next non empty cell will span the empty cells:
     512||= Wiki Markup =||= Display =||
    526513{{{#!td
    527514  {{{
    … …  
    539526}}}
    540527
    541 もし、セルの中身がセルの左右どちらか一方の端に "くっついている" ならば、そのテキストはくっついている端に寄せて表示されるでしょう。例:
    542 ||= Wiki マークアップ =||= 表示 =||
    543 {{{#!td
    544   {{{
    545   ||=テキスト =||= 数字 =||
    546   ||左寄せ    ||        1.0||
    547   ||  中央寄せ      ||        4.5||
    548   ||      右寄せ||     4.5||
    549   || デフォルトの配置 ||   2.5||
    550   ||デフォルト||         2.5||
    551   ||  デフォルト ||      2.5||
    552   || デフォルト ||       2.5||
     528Note that if the content of a cell sticks to one side of the cell and only one, then the text will be aligned on that side:
     529||= Wiki Markup =||= Display =||
     530{{{#!td
     531  {{{
     532  ||=Text =||= Numbers =||
     533  ||left align    ||        1.0||
     534  ||  center      ||        4.5||
     535  ||      right align||     4.5||
     536  || default alignment ||   2.5||
     537  ||default||         2.5||
     538  ||  default ||      2.5||
     539  || default ||       2.5||
    553540  }}}
    554541}}}
    555542{{{#!td style="padding: 2em;"
    556 ||=テキスト =||= 数字 =||
    557 ||左寄せ    ||        1.0||
    558 ||  中央寄せ      ||        4.5||
    559 ||      右寄せ||     4.5||
    560 || デフォルトの配置 ||   2.5||
    561 ||デフォルト||         2.5||
    562 ||  デフォルト ||      2.5||
    563 || デフォルト ||       2.5||
    564 }}}
    565 
    566 上記の例に反して、テーブルのセルにより多くのテキストが含まれている場合、複数の行にわたるマークアップを使用して行を広げられれば便利かもしれません。バックスラッシュ (`\`) がセルのセパレータの後ろの行末にあるとき、Trac は次の行に新しい行の新しいセルがあったとしても、新しい行を開始しません。
    567 
    568 ||= Wiki マークアップ =||
    569 {{{#!td
    570   {{{
    571   || 行 1 [http://trac.edgewall.org/newticket 新しいチケット] || \
    572   || 行 2 [http://trac.edgewall.org/roadmap ロードマップ] || \
    573   || 行 3 最後の行 ||
     543||=Text =||= Numbers =||
     544||left align    ||        1.0||
     545||  center      ||        4.5||
     546||      right align||     4.5||
     547|| default alignment ||   2.5||
     548||default||         2.5||
     549||  default ||      2.5||
     550|| default ||       2.5||
     551}}}
     552
     553If contrary to the example above, the cells in your table contain more text, it might be convenient to spread a table row over multiple lines of markup. The `\` character placed at the end of a line after a cell separator tells Trac to not start a new row for the cells on the next line:
     554
     555||= Wiki Markup =||
     556{{{#!td
     557  {{{
     558  || this is column 1 [https://trac.edgewall.org/newticket new ticket] || \
     559  || this is column 2 [https://trac.edgewall.org/roadmap the road ahead] || \
     560  || that's column 3 and last one ||
    574561  }}}
    575562}}}
    576563|-------------
    577 ||= 表示 =||
     564||= Display =||
    578565{{{#!td style="padding: 2em;"
    579 || 行 1 [http://trac.edgewall.org/newticket 新しいチケット] || \
    580 || 行 2 [http://trac.edgewall.org/roadmap ロードマップ] || \
    581 || 行 3 最後の行 ||
    582 }}}
    583 
    584 === 複雑なテーブル === #ComplexTables
    585 
    586 上記に記載されている表における簡単な "パイプ" 形式のマークアップによる試みがあなたのニーズに合わないとしたら、 [#Processors-example-tables テーブル用 Wiki プロセッサ] を使用して、より凝ったテーブルを作成することができます。
    587 
    588 
    589 == リンク == #Links
    590 
    591 WikiPageNames や URL は自動的にハイパーリンクされます。 !WikiPageLinks を無効化したい場合、 {{{!WikiPageLink}}} のように、エクスクラメーションマーク (!) を語頭に置きます。
    592 
    593 ||= Wiki マークアップ =||= 表示 =||
    594 {{{#!td
    595   {{{
    596   TitleIndex, http://www.edgewall.com/, !NotAlink
    597   }}}
    598 }}}
    599 {{{#!td
    600 TitleIndex, http://www.edgewall.com/, !NotAlink
    601 }}}
    602 
    603 スクエアブラケット ('[', ']') 内にリンクの後ろにスペースとタイトルをつけることによって、よりリンクの内容をふさわしく表したタイトルをつけることができます。
    604 このタイトルが省略されたとき、リンクが外部リンクでない限りにおいて明示的なプレフィックスが捨てられるでしょう。これは、 [WikiPageNames Wiki ページ名] のコンベンションに従わない wiki ページを扱うときに役に立つでしょう。
    605 
    606 ||= Wiki マークアップ =||= 表示 =||
    607 {{{#!td
    608   {{{
    609    * [http://www.edgewall.com Edgewall Software]
    610    * [wiki:TitleIndex Title Index]
    611    * [wiki:TitleIndex]
     566|| this is column 1 [https://trac.edgewall.org/newticket new ticket] || \
     567|| this is column 2 [https://trac.edgewall.org/roadmap the road ahead] || \
     568|| that's column 3 and last one ||
     569}}}
     570
     571=== Complex Tables
     572
     573If the possibilities offered by the simple pipe-based markup (`||`) for tables described above are not enough for your needs, you can create more elaborate tables by using [#Processors-example-tables WikiProcessor based tables].
     574
     575== Links
     576
     577Hyperlinks are automatically created for WikiPageNames and URLs. !WikiPageLinks can be disabled by prepending an exclamation mark (`!`), such as `!WikiPageLink`.
     578
     579||= Wiki Markup =||= Display =||
     580{{{#!td
     581  {{{
     582  TitleIndex, https://www.edgewall.com/, !NotAlink
     583  }}}
     584}}}
     585{{{#!td
     586TitleIndex, https://www.edgewall.com/, !NotAlink
     587}}}
     588
     589Links can be given a more descriptive title by writing the link followed by a space and a title and all this inside square brackets.
     590If the descriptive title is omitted, then the explicit prefix is discarded, unless the link is an external link. This can be useful for wiki pages not adhering to the WikiPageNames convention.
     591
     592||= Wiki Markup =||= Display =||
     593{{{#!td
     594  {{{
     595   * [https://www.edgewall.com Edgewall Software]
     596   * [wiki:TitleIndex Title Index]
     597   * [wiki:TitleIndex]
    612598   * [wiki:ISO9000]
    613599  }}}
    614600}}}
    615601{{{#!td
    616    * [http://www.edgewall.com Edgewall Software]
    617    * [wiki:TitleIndex Title Index]
    618    * [wiki:TitleIndex]
     602   * [https://www.edgewall.com Edgewall Software]
     603   * [wiki:TitleIndex Title Index] 
     604   * [wiki:TitleIndex] 
    619605   * [wiki:ISO9000]
    620606}}}
    621607
    622 [trac:WikiCreole] の書式に従って、この種のタイトルはまた、//二重の// スクエアブラケット ('![[', ']]') 内にリンクの後ろにパイプ ('|') とタイトルを書くことによっても指定することができます。
    623 
    624 {{{#!td
    625   {{{
    626    * [[http://www.edgewall.com|Edgewall Software]]
     608Following the [trac:WikiCreole] trend, the descriptive title can also be specified by writing the link followed by a pipe (`|`) and a title and all this inside //double// square brackets.
     609
     610{{{#!td
     611  {{{
     612   * [[https://www.edgewall.com|Edgewall Software]]
    627613   * [[wiki:TitleIndex|Title Index]]
    628      または [[TitleIndex|Title Index]]
     614     or even [[TitleIndex|Title Index]]
    629615   * [[wiki:TitleIndex]]
    630      ''' ![[TitleIndex]] はできません ! '''
     616     ''' but not ![[TitleIndex]]! '''
    631617   * [[ISO9000]]
    632618  }}}
    633619}}}
    634620{{{#!td
    635    * [[http://www.edgewall.com|Edgewall Software]]
     621   * [[https://www.edgewall.com|Edgewall Software]]
    636622   * [[wiki:TitleIndex|Title Index]]
    637      または [[TitleIndex|Title Index]]
     623     or even [[TitleIndex|Title Index]]
    638624   * [[wiki:TitleIndex]]
    639      '''  ![[TitleIndex]] はできません ! '''
     625     ''' but not ![[TitleIndex]]! '''
    640626   * [[ISO9000]]
    641627}}}
    642628
    643 '''Note''': [trac:WikiCreole] のリンク用の書式は
    644 Wikipedia や他の wiki で使用されていたりするので、素早くタイプでき、
    645 確実に親しみやすいです。しかし不幸なことにこの書式は、 [#Macros マクロ] の書式とかぶってしまいます。
    646 したがって、まれなケースですが、マクロ名にちなんだ wiki ページ名にリンクをはる必要があるとき
    647 ( 典型的な例では、 TitleIndex, InterTrac や InterWiki)、
    648 `[[TitleIndex]]` と書くと、ページへリンクする代わりにマクロを
    649 呼び出してしまいます。
    650 
    651 == Trac リンク == #TracLinks
    652 
    653 Wiki ページでは Trac の他のコンポーネントに直接リンクできます。チケット、レポート、チェンジセット、マイルストーン、ソースファイル、他の Wiki ページへは以下のようにリンクを記述します:
    654 
    655 ||= Wiki マークアップ =||= 表示 =||
    656 {{{#!td
    657   {{{
    658    * チケット: #1 または ticket:1
    659    * レポート: {1} または report:1
    660    * チェンジセット: r1, [1] または changeset:1
     629'''Note''': the [trac:WikiCreole] style for links is quick to type and certainly looks familiar as it is the one used on Wikipedia and in many other wikis. Unfortunately it conflicts with the syntax for [#Macros macros].
     630So in the rare case when you need to refer to a page which is named after a macro (typical examples being TitleIndex, InterTrac and InterWiki), by writing `[[TitleIndex]]` you will actually call the macro instead of linking to the page.
     631
     632== Trac Links
     633
     634Wiki pages can link directly to other parts of the Trac system. Pages can refer to tickets, reports, changesets, milestones, source files and other Wiki pages using the following notations:
     635
     636||= Wiki Markup =||= Display =||
     637{{{#!td
     638  {{{
     639   * Tickets: #1 or ticket:1
     640   * Reports: {1} or report:1
     641   * Changesets: r1, [1] or changeset:1
    661642   * ...
    662    * 他の Trac のインスタンスをターゲット、
    663      つまり InterTrac リンクを使用している場合:
    664      - チケット: #Trac1 または Trac:ticket:1
    665      - チェンジセット: [Trac1] or Trac:changeset:1
    666   }}}
    667 }}}
    668 {{{#!td
    669  * チケット: #1 または ticket:1
    670  * レポート: {1} または report:1
    671  * チェンジセット: r1, [1] または changeset:1
    672  * ...
    673  * 他の Trac のインスタンスをターゲット、
    674    つまり InterTrac リンクを使用している場合:
    675    - チケット: #Trac1 または Trac:ticket:1
    676    - チェンジセット: [Trac1] or Trac:changeset:1
    677 }}}
    678 
    679 他にもいろいろな Trac リンクがあります。 [TracLinks Trac リンク] により細かい情報とデフォルトで使用できるすべてのリンクのリソルバのリファレンスについて書かれています。
    680 
    681 
    682 == アンカーの設定 == #SettingAnchors
    683 
    684 アンカー、またはもっと正しく言うならば、 [http://www.w3.org/TR/REC-html40/struct/links.html#h-12.2.1 アンカー名] は ドキュメント内の場所をユニークに特定するために、Wiki ページ内のいたるところに明示的に追加することができます:
     643   * targeting other Trac instances,
     644     so called InterTrac links:
     645     - Tickets: #Trac1 or Trac:ticket:1
     646     - Changesets: [Trac1] or Trac:changeset:1
     647  }}}
     648}}}
     649{{{#!td
     650 * Tickets: #1 or ticket:1
     651 * Reports: {1} or report:1
     652 * Changesets: r1, [1] or changeset:1
     653 * ...
     654 * targeting other Trac instances,
     655   so called InterTrac links:
     656   - Tickets: #Trac1 or Trac:ticket:1
     657   - Changesets: [Trac1] or Trac:changeset:1
     658}}}
     659
     660There are many more flavors of Trac links, see TracLinks for more in-depth information and a reference for all the default link resolvers.
     661
     662== Setting Anchors
     663
     664An anchor, or more correctly speaking, an [https://www.w3.org/TR/REC-html40/struct/links.html#h-12.2.1 anchor name] can be added explicitly at any place in the Wiki page, to uniquely identify a position in the document:
    685665
    686666{{{
    … …  
    688668}}}
    689669
    690 [#Headings 上記で説明した] 明示的にヘッダ id をつけるときのフォーマットと合うようにこのシンタックスが採用されました。例:
     670This syntax was chosen to match the format for explicitly naming the header id [#Headings documented above]:
    691671{{{
    692 == 長いタイトル == #title
    693 }}}
    694 
    695 そのアンカーに対応するリンクのシンタックスにも近いです:
     672== Long title == #title
     673}}}
     674
     675It is also very close to the syntax for the corresponding link to that anchor:
    696676{{{
    697677[#point1]
    698678}}}
    699679
    700 オプションとしてアンカーにラベルを設定できます:
     680Optionally, a label can be given to the anchor:
    701681{{{
    702 [[=#point1 '''Point 1''']]
    703 }}}
    704 
    705 ||= Wiki マークアップ =||= 表示 =||
     682[=#point1 '''Point 1''']
     683}}}
     684
     685||= Wiki Markup =||= Display =||
    706686|----------------------------------
    707687{{{#!td
    708688  {{{
    709   [#point2 ポイント 2 へジャンプする]
     689  [#point2 jump to the second point]
    710690
    711691  ...
    712692
    713   ポイント 2:  [=#point2] ここにジャンプしています
    714   }}}
    715 }}}
    716 {{{#!td
    717   [#point2 ポイント 2 へジャンプする]
     693  Point2:  [=#point2] Jump here
     694  }}}
     695}}}
     696{{{#!td
     697  [#point2 jump to the second point]
    718698
    719699  ...
    720700
    721   ポイント 2:  [=#point2] ここにジャンプしています
    722 }}}
    723 
    724 より複雑なアンカー (例: カスタマイズしたタイトルが必要なとき) については、Span　マクロ (例: `[[span(id=point2, class=wikianchor, title=Point 2, ^(2)^)]]`) を使用することができます。
    725 
    726 
    727 == リンクの無効化と Wiki ページ名、その他のマークアップ == #EscapingLinksWikiPageNamesandotherMarkup
    728 
    729 エクスクラメーションマーク (!) を語頭に付与することで、 TracLinks が出力するハイパーリンクを無効化できます。
    730 
    731 ||= Wiki マークアップ =||= 表示 =||
     701  Point2:  [=#point2] Jump here
     702}}}
     703
     704For more complex anchors (eg when a custom title is wanted), you can use the Span macro: `[[span(id=point2, class=wikianchor, title=Point 2, ^(2)^)]]`.
     705
     706== Escaping Links, WikiPageNames and other Markup == #Escaping
     707
     708You may avoid making hyperlinks out of TracLinks by preceding an expression with a single exclamation mark (`!`).
     709
     710||= Wiki Markup =||= Display =||
    732711{{{#!td
    733712  {{{
    734713   !NoHyperLink
    735    !#42 はリンクではありません。
    736   }}}
    737   {{{
    738 様々な形式のリストマークアップの無効化:
    739  `-` マイナス記号の無効化 \\
    740  ``1. 番号の無効化  \\
    741  {{{*}}} アスタリスク記号の無効化
     714   !#42 is not a link
     715  }}}
     716  {{{
     717Various forms of escaping for list markup:
     718 ^^- escaped minus sign \\
     719 ^^1. escaped number  \\
     720 ^^* escaped asterisk sign
    742721  }}}
    743722}}}
    744723{{{#!td
    745724 !NoHyperLink
    746  !#42 はリンクではありません。
    747 
    748 様々な形式のリストマークアップの無効化:
    749  `-` マイナス記号の無効化 \\
    750  ``1. 番号の無効化  \\
    751  {{{*}}} アスタリスク記号の無効化
    752 }}}
    753 
    754 == 画像 == #Images
    755 
    756 URL が `.png`, `.gif` or `.jpg` で終わっている場合、自動的にイメージへのリンクとはならずに `<img>` タグに変換されます。
    757 
    758 現在では `[[Image]]` マクロを使用しなければなりません。画像を表示する最も簡単な方法は、現在のページへの添付ファイルとして画像をアップロードし、 `[[Image(picture.gif)]]` のようにファイル名を指定してマクロを呼び出す方法です。
    759 
    760 現在のページに加えて、他のリソースを参照することも可能です。
    761  * `[[Image(wiki:WikiFormatting:picture.gif)]]` (他のページの添付ファイルを参照する)
    762  * `[[Image(ticket:1:picture.gif)]]` (チケットに添付されたファイルを参照する)
    763  * `[[Image(htdocs:picture.gif)]]` ( [TracEnvironment TracEnvironment 環境] の `htdocs` ディレクトリ内のファイルを参照する)
    764  * `[[Image(source:/trunk/trac/htdocs/trac_logo_mini.png)]]` (リポジトリにあるファイルを参照)
    765 
    766 ||= Wiki マークアップ =||= 表示 =||
     725 !#42 is not a link
     726
     727Various forms of escaping for list markup:
     728 ^^- escaped minus sign \\
     729 ^^1. escaped number  \\
     730 ^^* escaped asterisk sign
     731}}}
     732
     733== Images
     734
     735Urls ending with `.png`, `.gif` or `.jpg` are no longer automatically interpreted as image links, and converted to `<img>` tags.
     736
     737You now have to use the ![[Image]] macro. The simplest way to include an image is to upload it as attachment to the current page, and put the filename in a macro call like `[[Image(picture.gif)]]`.
     738
     739In addition to the current page, it is possible to refer to other resources:
     740 * `[[Image(wiki:WikiFormatting:picture.gif)]]` (referring to attachment on another page)
     741 * `[[Image(ticket:1:picture.gif)]]` (file attached to a ticket)
     742 * `[[Image(htdocs:picture.gif)]]` (referring to a file inside the [TracEnvironment environment] `htdocs` directory)
     743 * `[[Image(source:/trunk/trac/htdocs/trac_logo_mini.png)]]` (a file in repository)
     744
     745||= Wiki Markup =||= Display =||
    767746{{{#!td
    768747  {{{
    … …  
    774753}}}
    775754
    776 `[[Image()]]` マクロに関するより詳しい情報は WikiMacros に記載されています。役に立ついくつかのオプションがあります (`title=`, `link=`, など)
    777 
    778 
    779 == マクロ == #Macros
    780 
    781 マクロは、動的コンテンツを Wiki ページに挿入するための ''カスタム関数'' です。
    782 
    783 ||= Wiki マークアップ =||= 表示 =||
     755See WikiMacros for further documentation on the `[[Image()]]` macro, which has several useful options (`title=`, `link=`, etc.)
     756
     757== Macros
     758
     759Macros are ''custom functions'' that insert dynamic content in a page.
     760
     761||= Wiki Markup =||= Display =||
    784762{{{#!td
    785763  {{{
    … …  
    791769}}}
    792770
    793 使用方法とインストールされているマクロの一覧は WikiMacros に記述されています。
    794 
    795 特定のマクロの詳細なヘルプを見るためには、マクロ名にクエスチョンマーク ("?") をつけることにより、直接見ることができます。
    796 
    797 ||= Wiki マークアップ =||= 表示 =||
     771See WikiMacros for more information, and a list of installed macros.
     772
     773The detailed help for a specific macro can also be obtained more directly by appending a `?` to the macro name.
     774
     775||= Wiki Markup =||= Display =||
    798776{{{#!td
    799777  {{{
    … …  
    805783}}}
    806784
    807 
    808 == プロセッサ == #Processors
    809 
    810 Trac は WikiProcessors の機能によって、 Wiki 以外のマークアップにも対応しています。例えば、プロセッサとしてページの描画に
    811 [wiki:WikiRestructuredText reStructuredText] や [wiki:WikiHtml HTML] を使用することができます。
    812 
    813 ||= Wiki マークアップ =||= 表示 =||
     785== Processors
     786
     787Trac supports alternative markup formats using WikiProcessors. For example, processors are used to write pages in
     788[wiki:WikiRestructuredText reStructuredText] or [wiki:WikiHtml HTML].
     789
     790||= Wiki Markup =||= Display =||
    814791|--------------------------------------------------------
    815792{{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%"
    … …  
    821798{{{#!td style="border: 0px"
    822799  {{{
    823   {{{
    824   #!html
     800  {{{#!html
    825801  <h1 style="text-align: right; color: blue">
    826    HTML テスト
     802   HTML Test
    827803  </h1>
    828804  }}}
    … …  
    831807{{{#!td valign="top"  style="border: 0px"
    832808
    833 {{{
    834 #!html
    835 <h1 style="text-align: right; color: blue">HTMLテスト</h1>
     809{{{#!html
     810<h1 style="text-align: right; color: blue">HTML Test</h1>
    836811}}}
    837812
    … …  
    840815{{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%"
    841816
    842    [=#Processors-example-highlight Example 2:] ソースコードのハイライト
     817   [=#Processors-example-highlight Example 2:] Code Highlighting
    843818
    844819}}}
    … …  
    846821{{{#!td style="border: 0px"
    847822  {{{
    848   {{{
    849   #!python
     823  {{{#!python
    850824  class Test:
    851 
     825 
    852826      def __init__(self):
    853827          print "Hello World"
    … …  
    857831  }}}
    858832}}}
    859 {{{
    860 #!td valign="top"  style="border: 0px"
    861 
    862 {{{
    863 #!python
     833{{{#!td valign="top"  style="border: 0px"
     834
     835{{{#!python
    864836class Test:
    865837    def __init__(self):
    … …  
    873845{{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%"
    874846
    875        [=#Processors-example-tables Example 3:] 複雑なテーブル
     847       [=#Processors-example-tables Example 3:] Complex Tables
    876848
    877849}}}
    … …  
    880852  {{{
    881853  {{{#!th rowspan=4 align=justify
    882   `#td` や `#th` プロセッサを用いることによって、
    883   表にいろいろな中身を入れ込むことができます:
     854  With the `#td` and `#th` processors,
     855  table cells can contain any content:
    884856  }}}
    885857  |----------------
    886858  {{{#!td
    887     - リスト
    888     - 埋め込みテーブル
    889     - 簡単な複数行にわたる内容
     859    - lists
     860    - embedded tables
     861    - simple multiline content
    890862  }}}
    891863  |----------------
    892864  {{{#!td
    893   プロセッサはネストして使用することが簡単にできるので、
    894   表はこのようにもできます:
     865  As processors can be easily nested,
     866  so can be tables:
    895867    {{{#!th
    896     例:
     868    Example:
    897869    }}}
    898870    {{{#!td style="background: #eef"
    899     || ここは三重の入れ子になっている違いない... ||
     871    || must be at the third level now... ||
    900872    }}}
    901873  }}}
    902874  |----------------
    903875  {{{#!td
    904   複雑なマークアップではなかったときでさえ、
    905   この表のセルのフォームは複数行にわたる
    906   内容を書くときには便利でしょう。
    907   }}}
    908   }}}
    909 }}}
    910 {{{
    911 #!td  valign="top"  style="border: 0px"
     876  Even when you don't have complex markup,
     877  this form of table cells can be convenient
     878  to write content on multiple lines.
     879  }}}
     880  }}}
     881}}}
     882{{{#!td  valign="top"  style="border: 0px"
    912883
    913884  {{{#!th rowspan=4 align=justify
    914   `#td` や `#th` プロセッサを用いることによって、
    915   表にいろいろな中身を入れ込むことができます:
     885  With the `#td` and `#th` processors,
     886  table cells can contain any content:
    916887  }}}
    917888  |----------------
    918889  {{{#!td
    919     - リスト
    920     - 埋め込みテーブル
    921     - 簡単な複数行にわたる内容
     890    - lists
     891    - embedded tables
     892    - simple multiline content
    922893  }}}
    923894  |----------------
    924895  {{{#!td
    925   プロセッサはネストして使用することが簡単にできるので、
    926   表はこのようにもできます:
     896  As processors can be easily nested,
     897  so can be tables:
    927898    {{{#!th
    928     例:
     899    Example:
    929900    }}}
    930901    {{{#!td style="background: #eef"
    931     || ここは三重の入れ子になっている違いない... ||
     902    || must be at the third level now... ||
    932903    }}}
    933904  }}}
    934905  |----------------
    935906  {{{#!td
    936   複雑なマークアップではなかったときでさえ、
    937   この表のセルのフォームは複数行にわたる
    938   内容を書くときには便利でしょう。
    939   }}}
    940 
    941 }}}
    942 
    943 より詳細な情報は WikiProcessors に記載されています。
    944 
    945 
    946 == コメント == #Comments
    947 
    948 コメントをプレーンテキストに追加することができます。コメントはレンダリングされず、プレーンテキスト形式でのみ表示されます。
    949 
    950 ||= Wiki マークアップ =||= 表示 =||
    951 {{{#!td
    952   {{{
    953   何も
    954   {{{
    955   #!comment
    956   ここに編集者向けのコメントを書く
    957   }}}
    958   見えないよ ;-)
    959   }}}
    960 }}}
    961 {{{#!td
    962   何も
    963   {{{
    964   #!comment
    965   ここに編集者向けのコメントを書く
    966   }}}
    967   見えないよ ;-)
    968 }}}
    969 
    970 == その他 == #Miscellaneous
    971 
    972 横線はページをいくつかに分けるために使用されます:
    973 
    974 ||= Wiki マークアップ =||= 表示 =||
    975 {{{#!td
    976   {{{
    977   4 つ以上のハイフン ('-') は横線
    978   (<HR>) に置き換えられます。
     907  Even when you don't have complex markup,
     908  this form of table cells can be convenient
     909  to write content on multiple lines.
     910  }}}
     911
     912}}}
     913
     914See WikiProcessors for more information.
     915
     916== Comments
     917
     918Comments can be added to the plain text. These will not be rendered and will not display in any other format than plain text.
     919
     920||= Wiki Markup =||= Display =||
     921{{{#!td
     922  {{{
     923  Nothing to
     924  {{{#!comment
     925  Your comment for editors here
     926  }}}
     927  see.
     928  }}}
     929}}}
     930{{{#!td
     931  Nothing to
     932  {{{#!comment
     933  Your comment for editors here
     934  }}}
     935  see.
     936}}}
     937
     938== Miscellaneous
     939
     940||= Wiki Markup =||= Display =||
     941{{{#!td
     942  Horizontal line:
     943  {{{
     944  Four or more dashes will be replaced
     945  by a horizontal line (<HR>)
    979946  ----
    980   分かる?
    981   }}}
    982 }}}
    983 {{{#!td
    984   4 つ以上のハイフン ('-') は横線
    985   (<HR>) に置き換えられます。
     947  See?
     948  }}}
     949}}}
     950{{{#!td
     951Four or more dashes will be replaced
     952by a horizontal line (<HR>)
    986953----
    987   分かる?
     954See?
    988955}}}
    989956|----------------------------------
    990957{{{#!td
    991   {{{
    992   "マクロ" 書式 [[br]] 改行
    993   }}}
    994 }}}
    995 {{{#!td
    996 "マクロ" 書式 [[br]] 改行
     958  Two examples of line breaks:
     959  {{{
     960  "macro" style [[BR]] line break
     961  }}}
     962  or:
     963  {{{
     964  !WikiCreole style \\ line\\break
     965  }}}
     966}}}
     967{{{#!td
     968"macro" style [[BR]] line break
     969
     970!WikiCreole style \\ line\\break
    997971}}}
    998972|----------------------------------
    999 {{{#!td
    1000   {{{
    1001   !WikiCreole 書式 \\ 改\\行
    1002   }}}
    1003 }}}
    1004 {{{#!td
    1005 !WikiCreole 書式 \\ 改\\行
    1006 }}}