| 4 | | Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into a flexible and powerful whole. |
| 5 | | |
| 6 | | Trac has a built in small and powerful wiki rendering engine. This wiki engine implements an ever growing subset of the commands from other popular Wikis, |
| 7 | | especially [http://moinmo.in/ MoinMoin] and [trac:WikiCreole]. |
| 8 | | |
| 9 | | |
| 10 | | This page will give you an in-depth explanation of the wiki markup available anywhere WikiFormatting is allowed. |
| 11 | | |
| 12 | | The ''Cheat sheet'' below gives you a quick overview for the most common syntax, each link in the ''Category'' column will lead you to the more detailed explanation later in this page. |
| 13 | | |
| 14 | | A few other wiki pages present the advanced features of the Trac wiki markup in more depth: |
| 15 | | - TracLinks covers all the possible ways to refer precisely to any Trac resource or parts thereof, |
| 16 | | - WikiPageNames talks about the various names a wiki page can take, CamelCase or not |
| 17 | | - WikiMacros lists the macros available for generating dynamic content, |
| 18 | | - WikiProcessors and WikiHtml details how parts of the wiki text can be processed in special ways |
| 19 | | |
| 20 | | |
| 21 | | == Cheat sheet == |
| 22 | | |
| 23 | | ||= '''Category''' =||= '''Wiki Markup''' =||= '''Display''' =|| |
| | 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 マークアップ''' =||= '''表示''' =|| |
| 26 | | [#FontStyles Font Styles] |
| 27 | | }}} |
| 28 | | || `'''bold'''`, `''italic''`, `'''''Wikipedia style'''''` || \ |
| 29 | | || '''bold''', ''italic'', '''''Wikipedia style''''' || |
| 30 | | || {{{`monospaced (''other markup ignored'')`}}} || \ |
| 31 | | || `monospaced (''other markup ignored'')` || |
| 32 | | || `**bold**`, `//italic//`, `**//!WikiCreole style//**` || \ |
| 33 | | || **bold**, //italic//, **//!WikiCreole style//** || |
| 34 | | |----------------------------------------------------------- |
| 35 | | ||= [#Headings Headings] =||\ |
| 36 | | {{{#!td |
| 37 | | {{{ |
| 38 | | == Level 2 == |
| 39 | | === Level 3 ^([#hn note])^ |
| | 26 | [#FontStyles フォント書式] |
| | 27 | }}} |
| | 28 | || `'''太字'''`, `''斜体''`, `'''''Wikipedia 書式'''''` || \ |
| | 29 | || '''太字''', ''斜体'', '''''Wikipedia 書式''''' || |
| | 30 | || {{{`等幅 (''他のマークアップを無視'')`}}} || \ |
| | 31 | || `等幅 (''他のマークアップを無視'')` || |
| | 32 | || `**太字**`, `//斜体//`, `**//!WikiCreole 書式//**` || \ |
| | 33 | || **太字**, //斜体//, **//!WikiCreole 書式//** || |
| | 34 | |----------------------------------------------------------- |
| | 35 | ||= [#Headings 見出し] =||\ |
| | 36 | {{{#!td |
| | 37 | {{{ |
| | 38 | == 見出し 2 == |
| | 39 | === 見出し 3 ^([#hn 注])^ |
| 82 | | [#DefinitionLists Definition Lists] |
| 83 | | }}} |
| 84 | | {{{#!td |
| 85 | | {{{ |
| 86 | | term:: definition on |
| 87 | | multiple lines |
| 88 | | }}} |
| 89 | | }}} |
| 90 | | {{{#!td |
| 91 | | term:: definition on |
| 92 | | multiple lines |
| 93 | | }}} |
| 94 | | |----------------------------------------------------------- |
| 95 | | ||= [#PreformattedText Preformatted Text] =||\ |
| 96 | | {{{#!td |
| 97 | | {{{ |
| 98 | | {{{ |
| 99 | | multiple lines, ''no wiki'' |
| 100 | | white space respected |
| 101 | | }}} |
| 102 | | }}} |
| 103 | | }}} |
| 104 | | {{{#!td |
| 105 | | {{{ |
| 106 | | multiple lines, ''no wiki'' |
| 107 | | white space respected |
| 108 | | }}} |
| 109 | | }}} |
| 110 | | |----------------------------------------------------------- |
| 111 | | ||= [#Blockquotes Blockquotes] =||\ |
| 112 | | {{{#!td |
| 113 | | {{{ |
| 114 | | if there's some leading |
| 115 | | space the text is quoted |
| 116 | | }}} |
| 117 | | }}} |
| 118 | | {{{#!td |
| 119 | | if there's some leading |
| 120 | | space the text is quoted |
| 121 | | }}} |
| 122 | | |----------------------------------------------------------- |
| 123 | | ||= [#DiscussionCitations Discussion Citations] =||\ |
| | 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 引用] =||\ |
| 164 | | || `Ticket [ticket:1]`, `[ticket:1 ticket one]` ||\ |
| 165 | | || Ticket [ticket:1], [ticket:1 ticket one] || |
| 166 | | || `Ticket [[ticket:1]]`, `[[ticket:1|ticket one]]` ||\ |
| 167 | | || Ticket [[ticket:1]], [[ticket:1|ticket one]] || |
| 168 | | |----------------------------------------------------------- |
| 169 | | {{{#!th rowspan=2 |
| 170 | | [#SettingAnchors Setting Anchors] |
| 171 | | }}} |
| 172 | | || `[=#point1 (1)] First...` ||\ |
| 173 | | || [=#point1 (1)] First... || |
| 174 | | || `see [#point1 (1)]` ||\ |
| 175 | | || see [#point1 (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)] 参照 || |
| 246 | | == Font Styles == |
| 247 | | |
| 248 | | The Trac wiki supports the following font styles: |
| 249 | | ||= Wiki Markup =||= Display =|| |
| 250 | | {{{#!td |
| 251 | | {{{ |
| 252 | | * '''bold''', |
| 253 | | ''' triple quotes !''' |
| 254 | | can be bold too if prefixed by ! ''', |
| 255 | | * ''italic'' |
| 256 | | * '''''bold italic''''' or ''italic and |
| 257 | | ''' italic bold ''' '' |
| 258 | | * __underline__ |
| 259 | | * {{{monospace}}} or `monospace` |
| 260 | | (hence `{{{` or {{{`}}} quoting) |
| 261 | | * ~~strike-through~~ |
| 262 | | * ^superscript^ |
| 263 | | * ,,subscript,, |
| 264 | | * **also bold**, //italic as well//, |
| 265 | | and **'' bold italic **'' //(since 0.12)// |
| 266 | | }}} |
| 267 | | }}} |
| 268 | | {{{#!td |
| 269 | | * '''bold''', |
| 270 | | ''' triple quotes !''' |
| 271 | | can be bold too if prefixed by ! ''', |
| 272 | | * ''italic'' |
| 273 | | * '''''bold italic''''' or ''italic and |
| 274 | | ''' italic bold ''' '' |
| 275 | | * __underline__ |
| 276 | | * {{{monospace}}} or `monospace` |
| 277 | | (hence `{{{` or {{{`}}} quoting) |
| 278 | | * ~~strike-through~~ |
| 279 | | * ^superscript^ |
| 280 | | * ,,subscript,, |
| 281 | | * **also bold**, //italic as well//, |
| 282 | | and **'' bold italic **'' //(since 0.12)// |
| 283 | | }}} |
| 284 | | |
| 285 | | Notes: |
| 286 | | * `{{{...}}}` 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. |
| 287 | | * {{{ ! }}} 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. |
| 288 | | * all the font styles marks have to be used in opening/closing pairs, |
| 289 | | and they must nest properly (in particular, an `''` italic can't be paired |
| 290 | | with a `//` one, and `'''` can't be paired with `**`) |
| 291 | | |
| 292 | | |
| 293 | | == Headings == |
| 294 | | |
| 295 | | You can create heading by starting a line with one up to six ''equal'' characters ("=") |
| 296 | | followed by a single space and the headline text. |
| | 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 つおいて、見出しのテキストを記述することにより作成することができます。 |
| 299 | | The headline text can be followed by the same number of "=" characters, but this is no longer mandatory. |
| 300 | | |
| 301 | | Finally, the heading might optionally be followed by an explicit id. If not, an implicit but nevertheless readable id will be generated. |
| 302 | | |
| 303 | | ||= Wiki Markup =||= Display =|| |
| 304 | | {{{#!td |
| 305 | | {{{ |
| 306 | | = Heading = |
| 307 | | == Subheading |
| 308 | | === About ''this'' === |
| 309 | | === Explicit id === #using-explicit-id-in-heading |
| 310 | | == Subheading #sub2 |
| | 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 |
| 316 | | = Heading = |
| 317 | | == Subheading |
| 318 | | === About ''this'' === |
| 319 | | === Explicit id === #using-explicit-id-in-heading |
| 320 | | == Subheading #sub2 |
| 321 | | }}} |
| 322 | | }}} |
| 323 | | |
| 324 | | == Paragraphs == |
| 325 | | |
| 326 | | A new text paragraph is created whenever two blocks of text are separated by one or more empty lines. |
| 327 | | |
| 328 | | A forced line break can also be inserted, using: |
| 329 | | ||= Wiki Markup =||= Display =|| |
| 330 | | {{{#!td |
| 331 | | {{{ |
| 332 | | Line 1[[BR]]Line 2 |
| 333 | | }}} |
| 334 | | {{{ |
| 335 | | Paragraph |
| 336 | | one |
| 337 | | |
| 338 | | Paragraph |
| 339 | | two |
| 340 | | }}} |
| 341 | | }}} |
| 342 | | {{{#!td |
| 343 | | Line 1[[BR]]Line 2 |
| 344 | | |
| 345 | | Paragraph |
| 346 | | one |
| 347 | | |
| 348 | | Paragraph |
| 349 | | two |
| 350 | | }}} |
| 351 | | |
| 352 | | == Lists == |
| 353 | | |
| 354 | | The wiki supports both ordered/numbered and unordered lists. |
| 355 | | |
| 356 | | Example: |
| 357 | | ||= Wiki Markup =||= Display =|| |
| | 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 マークアップ =||= 表示 =|| |
| 427 | | some kind of reptile, without hair |
| 428 | | (can you spot the typo?) |
| 429 | | }}} |
| 430 | | |
| 431 | | Note that you need a space in front of the defined term. |
| 432 | | |
| 433 | | |
| 434 | | == Preformatted Text == |
| 435 | | |
| 436 | | Block 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. |
| 437 | | |
| 438 | | ||= Wiki Markup =||= Display =|| |
| | 427 | 毛がない爬虫類の一種。 |
| | 428 | (typoを見つけたかい?) |
| | 429 | }}} |
| | 430 | |
| | 431 | 定義する用語の前にスペースが一つ必要なことを忘れないで下さい。 |
| | 432 | |
| | 433 | |
| | 434 | == 整形済みテキスト == #PreformattedText |
| | 435 | |
| | 436 | 整形済みテキストを含むブロックは、ソースコードの一部や、ノート、例示に適しています。引用ブロックとしたいテキストの前後を、 3 つの ''ブレース (curly braces)'' で括ってください。ブレースは独立した行に置かなければいけません。 |
| | 437 | |
| | 438 | ||= Wiki マークアップ =||= 表示 =|| |
| 463 | | Paragraph |
| 464 | | This text is a quote from someone else. |
| 465 | | }}} |
| 466 | | }}} |
| 467 | | {{{#!td |
| 468 | | Paragraph |
| 469 | | This text is a quote from someone else. |
| 470 | | }}} |
| 471 | | |
| 472 | | == Discussion Citations == |
| 473 | | |
| 474 | | To delineate a citation in an ongoing discussion thread, such as the ticket comment area, e-mail-like citation marks (">", ">>", etc.) may be used. |
| 475 | | |
| 476 | | ||= Wiki Markup =||= Display =|| |
| | 463 | 段落 |
| | 464 | このテキストは何かの引用です。 |
| | 465 | }}} |
| | 466 | }}} |
| | 467 | {{{#!td |
| | 468 | 段落 |
| | 469 | このテキストは何かの引用です。 |
| | 470 | }}} |
| | 471 | |
| | 472 | == 引用 == #DiscussionCitations |
| | 473 | |
| | 474 | 進行中の議題のスレッド、チケットのコメントエリアなどで引用を表すために、メールライクな引用マーク (">", ">>" など) が使用できます。 |
| | 475 | |
| | 476 | ||= Wiki マークアップ =||= 表示 =|| |
| 556 | | ||=Text =||= Numbers =|| |
| 557 | | ||left align || 1.0|| |
| 558 | | || center || 4.5|| |
| 559 | | || right align|| 4.5|| |
| 560 | | || default alignment || 2.5|| |
| 561 | | ||default|| 2.5|| |
| 562 | | || default || 2.5|| |
| 563 | | || default || 2.5|| |
| 564 | | }}} |
| 565 | | |
| 566 | | If 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. |
| 567 | | |
| 568 | | ||= Wiki Markup =|| |
| 569 | | {{{#!td |
| 570 | | {{{ |
| 571 | | || this is column 1 [http://trac.edgewall.org/newticket new ticket] || \ |
| 572 | | || this is column 2 [http://trac.edgewall.org/roadmap the road ahead] || \ |
| 573 | | || that's column 3 and last one || |
| | 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 最後の行 || |
| 579 | | || this is column 1 [http://trac.edgewall.org/newticket new ticket] || \ |
| 580 | | || this is column 2 [http://trac.edgewall.org/roadmap the road ahead] || \ |
| 581 | | || that's column 3 and last one || |
| 582 | | }}} |
| 583 | | |
| 584 | | === Complex Tables === |
| 585 | | |
| 586 | | If the possibilities offered by the simple "pipe"-based markup for tables described above are not enough for your needs, you can create more elaborated tables by using [#Processors-example-tables WikiProcessor based tables]. |
| 587 | | |
| 588 | | |
| 589 | | == Links == |
| 590 | | |
| 591 | | Hyperlinks are automatically created for WikiPageNames and URLs. !WikiPageLinks can be disabled by prepending an exclamation mark "!" character, such as {{{!WikiPageLink}}}. |
| 592 | | |
| 593 | | ||= Wiki Markup =||= Display =|| |
| | 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 マークアップ =||= 表示 =|| |
| 643 | | '''Note''': the [trac:WikiCreole] style for links is quick to type and |
| 644 | | certainly looks familiar as it's the one used on Wikipedia and in many |
| 645 | | other wikis. Unfortunately it conflicts with the syntax for [#Macros macros]. |
| 646 | | So in the rare case when you need to refer to a page which is named after |
| 647 | | a macro (typical examples being TitleIndex, InterTrac and InterWiki), |
| 648 | | by writing `[[TitleIndex]]` you will actually call the macro instead of linking |
| 649 | | to the page. |
| 650 | | |
| 651 | | == Trac Links == |
| 652 | | |
| 653 | | Wiki 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: |
| 654 | | |
| 655 | | ||= Wiki Markup =||= Display =|| |
| 656 | | {{{#!td |
| 657 | | {{{ |
| 658 | | * Tickets: #1 or ticket:1 |
| 659 | | * Reports: {1} or report:1 |
| 660 | | * Changesets: r1, [1] or changeset:1 |
| | 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 |
| 662 | | * targeting other Trac instances, |
| 663 | | so called InterTrac links: |
| 664 | | - Tickets: #Trac1 or Trac:ticket:1 |
| 665 | | - Changesets: [Trac1] or Trac:changeset:1 |
| 666 | | }}} |
| 667 | | }}} |
| 668 | | {{{#!td |
| 669 | | * Tickets: #1 or ticket:1 |
| 670 | | * Reports: {1} or report:1 |
| 671 | | * Changesets: r1, [1] or changeset:1 |
| 672 | | * ... |
| 673 | | * targeting other Trac instances, |
| 674 | | so called InterTrac links: |
| 675 | | - Tickets: #Trac1 or Trac:ticket:1 |
| 676 | | - Changesets: [Trac1] or Trac:changeset:1 |
| 677 | | }}} |
| 678 | | |
| 679 | | There are many more flavors of Trac links, see TracLinks for more in-depth information and a reference for all the default link resolvers. |
| 680 | | |
| 681 | | |
| 682 | | == Setting Anchors == |
| 683 | | |
| 684 | | An anchor, or more correctly speaking, an [http://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, in order to uniquely identify a position in the document: |
| | 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 ページ内のいたるところに明示的に追加することができます: |
| 721 | | Point2: [=#point2] Jump here |
| 722 | | }}} |
| 723 | | |
| 724 | | For more complex anchors (e.g. when a custom title is wanted), one can use the Span macro, e.g. `[[span(id=point2, class=wikianchor, title=Point 2, ^(2)^)]]`. |
| 725 | | |
| 726 | | |
| 727 | | == Escaping Links, WikiPageNames and other Markup == #Escaping |
| 728 | | |
| 729 | | You may avoid making hyperlinks out of TracLinks by preceding an expression with a single "!" (exclamation mark). |
| 730 | | |
| 731 | | ||= Wiki Markup =||= Display =|| |
| | 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 マークアップ =||= 表示 =|| |
| 746 | | !#42 is not a link |
| 747 | | |
| 748 | | Various forms of escaping for list markup: |
| 749 | | `-` escaped minus sign \\ |
| 750 | | ``1. escaped number \\ |
| 751 | | {{{*}}} escaped asterisk sign |
| 752 | | }}} |
| 753 | | |
| 754 | | == Images == |
| 755 | | |
| 756 | | Urls ending with `.png`, `.gif` or `.jpg` are no longer automatically interpreted as image links, and converted to `<img>` tags. |
| 757 | | |
| 758 | | You 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)]]`. |
| 759 | | |
| 760 | | In addition to the current page, it is possible to refer to other resources: |
| 761 | | * `[[Image(wiki:WikiFormatting:picture.gif)]]` (referring to attachment on another page) |
| 762 | | * `[[Image(ticket:1:picture.gif)]]` (file attached to a ticket) |
| 763 | | * `[[Image(htdocs:picture.gif)]]` (referring to a file inside the [TracEnvironment environment] `htdocs` directory) |
| 764 | | * `[[Image(source:/trunk/trac/htdocs/trac_logo_mini.png)]]` (a file in repository) |
| 765 | | |
| 766 | | ||= Wiki Markup =||= Display =|| |
| | 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 マークアップ =||= 表示 =|| |
| 936 | | Even when you don't have complex markup, |
| 937 | | this form of table cells can be convenient |
| 938 | | to write content on multiple lines. |
| 939 | | }}} |
| 940 | | |
| 941 | | }}} |
| 942 | | |
| 943 | | See WikiProcessors for more information. |
| 944 | | |
| 945 | | |
| 946 | | == Comments == |
| 947 | | |
| 948 | | Comments can be added to the plain text. These will not be rendered and will not display in any other format than plain text. |
| 949 | | |
| 950 | | ||= Wiki Markup =||= Display =|| |
| 951 | | {{{#!td |
| 952 | | {{{ |
| 953 | | Nothing to |
| | 936 | 複雑なマークアップではなかったときでさえ、 |
| | 937 | この表のセルのフォームは複数行にわたる |
| | 938 | 内容を書くときには便利でしょう。 |
| | 939 | }}} |
| | 940 | |
| | 941 | }}} |
| | 942 | |
| | 943 | より詳細な情報は WikiProcessors に記載されています。 |
| | 944 | |
| | 945 | |
| | 946 | == コメント == #Comments |
| | 947 | |
| | 948 | コメントをプレーンテキストに追加することができます。コメントはレンダリングされず、プレーンテキスト形式でのみ表示されます。 |
| | 949 | |
| | 950 | ||= Wiki マークアップ =||= 表示 =|| |
| | 951 | {{{#!td |
| | 952 | {{{ |
| | 953 | 何も |