| 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 マークアップ''' =||= '''表示''' =|| |
| | 5 | Wiki markup is a core feature in Trac, tightly integrating all the other parts of Trac into a flexible and unified whole. |
| | 6 | |
| | 7 | Trac has a powerful wiki rendering engine that implements a subset of the commands from other popular Wikis, such as [http://moinmo.in/ MoinMoin] and [trac:WikiCreole]. |
| | 8 | |
| | 9 | The 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 | |
| | 11 | The 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''' =|| |
| 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])^ |
| 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] =||\ |
| 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)] || |
| 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: |
| 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 | |
| | 238 | The 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 | |
| | 277 | Notes: |
| | 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 | |
| | 286 | You can create a heading by starting a line with one up to six ''equal'' characters (`=`) followed by a single space and the headline text. |
| 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 |
| | 289 | The headline text can be followed by the same number of `=` characters, but this is not mandatory. That is, `=== Section3 ===` is identical to `=== Section3`. |
| | 290 | |
| | 291 | Finally, 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 |
| 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 | |
| | 316 | A new text paragraph is created whenever two blocks of text are separated by one or more empty lines. |
| | 317 | |
| | 318 | A 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 | |
| | 344 | The wiki supports both ordered/numbered and unordered lists. |
| | 345 | |
| | 346 | ||= Wiki Markup =||= Display =|| |
| 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 | |
| | 553 | 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: |
| | 554 | |
| | 555 | ||= Wiki Markup =|| |
| | 556 | {{{#!td |
| | 557 | {{{ |
| | 558 | || this is column 1 [http://trac.edgewall.org/newticket new ticket] || \ |
| | 559 | || this is column 2 [http://trac.edgewall.org/roadmap the road ahead] || \ |
| | 560 | || that's column 3 and last one || |
| 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 マークアップ =||= 表示 =|| |
| | 566 | || this is column 1 [http://trac.edgewall.org/newticket new ticket] || \ |
| | 567 | || this is column 2 [http://trac.edgewall.org/roadmap the road ahead] || \ |
| | 568 | || that's column 3 and last one || |
| | 569 | }}} |
| | 570 | |
| | 571 | === Complex Tables |
| | 572 | |
| | 573 | If 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 | |
| | 577 | Hyperlinks are automatically created for WikiPageNames and URLs. !WikiPageLinks can be disabled by prepending an exclamation mark (`!`), such as `!WikiPageLink`. |
| | 578 | |
| | 579 | ||= Wiki Markup =||= Display =|| |
| 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]. |
| | 630 | So 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 | |
| | 634 | 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: |
| | 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 |
| 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 | |
| | 660 | There 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 | |
| | 664 | 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, to uniquely identify a position in the document: |
| 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 | |
| | 704 | For 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 | |
| | 708 | You may avoid making hyperlinks out of TracLinks by preceding an expression with a single exclamation mark (`!`). |
| | 709 | |
| | 710 | ||= 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 マークアップ =||= 表示 =|| |
| | 725 | !#42 is not a link |
| | 726 | |
| | 727 | Various forms of escaping for list markup: |
| | 728 | ^^- escaped minus sign \\ |
| | 729 | ^^1. escaped number \\ |
| | 730 | ^^* escaped asterisk sign |
| | 731 | }}} |
| | 732 | |
| | 733 | == Images |
| | 734 | |
| | 735 | Urls ending with `.png`, `.gif` or `.jpg` are no longer automatically interpreted as image links, and converted to `<img>` tags. |
| | 736 | |
| | 737 | 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)]]`. |
| | 738 | |
| | 739 | In 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 =|| |
| 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 | |
| | 914 | See WikiProcessors for more information. |
| | 915 | |
| | 916 | == Comments |
| | 917 | |
| | 918 | Comments 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>) |
