Changes between Version 1 and Version 2 of WikiFormatting
- Timestamp:
- May 13, 2012, 9:15:45 PM (13 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
WikiFormatting
v1 v2 1 = Wiki 文法 = 1 = Wiki 文法 = #WikiFormatting 2 2 [[TracGuideToc]] 3 3 4 4 Wiki マークアップは Trac のコアとなる機能です。他のパーツと緊密に統合することによって、 Trac をフレキシブルかつ強力にしています。 5 5 6 Trac は小さく強力な Wiki レンダリングエンジンを内蔵しています。この Wiki エンジンは、他のポピュラーな Wiki からのコマンドの強化サブセットを実装しています。 7 (特に [http://moinmoin.wikiwikiweb.de/ MoinMoin]) 8 9 10 このページは、 WikiFormatting でフォーマットできる文法の文例集です。 11 12 13 == フォント書式 == 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 マークアップ''' =||= '''表示''' =|| 24 |----------------------------------------------------------- 25 {{{#!th rowspan=3 26 [#FontStyles フォント書式] 27 }}} 28 || `'''太字'''`, `''斜体''`, `'''''Wikipedia 書式'''''` || \ 29 || '''太字''', ''斜体'', '''''Wikipedia 書式''''' || 30 || {{{`等幅 , ''nowiki''`}}} || \ 31 || `等幅 , ''nowiki''` || 32 || `**太字**`, `//斜体//`, `**//!WikiCreole 書式//**` || \ 33 || **太字**, //斜体//, **//!WikiCreole 書式//** || 34 |----------------------------------------------------------- 35 ||= [#Headings 見出し] =||\ 36 {{{#!td 37 {{{ 38 == 見出し 2 == 39 === 見出し 3 ^([#hn 注])^ 40 }}} 41 }}} 42 {{{#!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 書式 79 }}} 80 |----------------------------------------------------------- 81 {{{#!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 引用] =||\ 124 {{{#!td 125 {{{ 126 >> ... (I said) 127 > (he replied) 128 }}} 129 }}} 130 {{{#!td 131 >>... (I said) 132 > (he replied) 133 }}} 134 |----------------------------------------------------------- 135 ||= [#Tables 表] =||\ 136 {{{#!td 137 {{{ 138 ||= 表のヘッダ =|| セル || 139 |||| (詳細は下記参照) || 140 }}} 141 }}} 142 {{{#!td 143 ||= 表のヘッダ =|| セル || 144 |||| (詳細は下記参照) || 145 }}} 146 |----------------------------------------------------------- 147 {{{#!th rowspan=2 148 [#Links リンク] 149 }}} 150 || `http://trac.edgewall.org` ||\ 151 || http://trac.edgewall.org || 152 || `WikiFormatting (CamelCase)` ||\ 153 || WikiFormatting (CamelCase) || 154 |----------------------------------------------------------- 155 {{{#!th rowspan=5 156 [#TracLinks Trac リンク] 157 }}} 158 || `wiki:WikiFormatting`, `wiki:"WikiFormatting"` ||\ 159 || 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)] 参照 || 176 |----------------------------------------------------------- 177 {{{#!th rowspan=3 178 [#EscapingLinksWikiPageNamesandotherMarkup リンクの無効化] 179 }}} 180 || `!'' シングルクオテーション 2 つ` ||\ 181 || !'' シングルクオテーション 2 つ || 182 || `!wiki:WikiFormatting`, `!WikiFormatting` ||\ 183 || !wiki:WikiFormatting, !WikiFormatting || 184 || `{{{-}}} curly brackets` ||\ 185 || {{{-}}} curly brackets || 186 |----------------------------------------------------------- 187 ||= [#Images 画像] =|| `[[Image(`''link''`)]]` || [[Image(htdocs:../common/trac_logo_mini.png)]] || 188 |----------------------------------------------------------- 189 {{{#!th rowspan=2 190 [#Macros マクロ] 191 }}} 192 || `[[MacroList(*)]]` || ''(簡単なマクロ一覧)'' || 193 || `[[Image?]]` || ''(イメージマクロのヘルプ)'' || 194 |----------------------------------------------------------- 195 ||= [#Processors プロセッサ] =||\ 196 {{{#!td 197 {{{ 198 {{{ 199 #!div style="font-size: 80%" 200 ソースコードのハイライト: 201 {{{#!python 202 hello = lambda: "world" 203 }}} 204 }}} 205 }}} 206 }}} 207 {{{#!td style="padding-left: 2em" 208 {{{ 209 #!div style="font-size: 80%" 210 ソースコードのハイライト: 211 {{{#!python 212 hello = lambda: "world" 213 }}} 214 }}} 215 }}} 216 |----------------------------------------------------------- 217 ||= [#Comments コメント] =||\ 218 {{{#!td 219 {{{ 220 {{{#!comment 221 編集している人への注: ... 222 }}} 223 }}} 224 }}} 225 {{{#!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 改 \\ 行 242 ---- 243 }}} 244 245 246 == フォント書式 == #FontStyles 14 247 15 248 Trac の Wiki は以下のフォント書式に対応しています: 16 {{{ 17 * '''ボールド''', '''!''' ボールドにできます''' そして '''! ''' 18 * ''イタリック'' 19 * '''''ボールドイタリック''''' 20 * __アンダーライン__ 21 * {{{モノスペース}}} or `モノスペース` 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 (ゆえに `{{{` または {{{`}}} で囲む) 22 278 * ~~取り消し線~~ 23 279 * ^上付き文字^ 24 280 * ,,下付き文字,, 25 }}} 26 27 表示内容: 28 * '''ボールド''', '''!''' ボールドにできます''' そして '''! ''' 29 * ''イタリック'' 30 * '''''ボールドイタリック''''' 31 * __アンダーライン__ 32 * {{{モノスペース}}} or `モノスペース` 33 * ~~取り消し線~~ 34 * ^上付き文字^ 35 * ,,下付き文字,, 36 37 Notes: 281 * **これも太字**, //これは斜体//, 282 そして **'' 太字 + 斜体 **'' //(0.12 以降)// 283 }}} 284 285 Note: 38 286 * `{{{...}}}`と {{{`...`}}} コマンドは表示を等角フォントにするだけではなく、内容を整形済みテキストとして扱います。つまりテキストに対して、どのような Wiki 処理も行いません。 39 287 * {{{ ! }}} は wiki パーサに wiki フォーマットとして解釈しないように伝えます。なので、 ! の後ろにスペースを置くことに注意して下さい。例えば、太字で行が終わるようなときです。 40 41 == 見出し == 42 43 1 文字から 5 文字の「イコール '='」を行頭に置き、 1 文字のスペースに続けてタイトルを置くと、 44 見出しになります。見出しの行末は1文字のスペースに続けて、行頭と同じ数の ''イコール (=)'' を 45 置きます。 46 見出しに続いて id 属性を明示的に付与することが出来ます。付与しない場合、暗黙の読み取り可能な id 属性が生成されます。 47 '''(訳注: 明示的に付与する id 属性では日本語は使用できないようです。)''' 288 * すべてのフォント書式の記号は開始記号と終了記号のペアで使われなければなりません。 289 そして、これらのペアは適切にネストされなければなりません ( 特に、斜体の `''` は 290 `//` とペアにすることはできませんし、太字の `'''` は `**` とペアにすることはできません ) 291 292 293 == 見出し == #Headings 294 295 見出しは、その行を 1 つから 6 つまでの等号記号 ("=") ではじめ、 296 その後にスペースを 1 つおいて、見出しのテキストを記述することにより作成することができます。 297 298 [=#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 311 }}} 312 }}} 313 {{{#!td style="padding: 1em;" 314 {{{ 315 #!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 番号付きリストと番号無しリストの両方があります。 48 355 49 356 例: 50 {{{ 51 = 見出し (第1レベル) = 52 == 見出し (第2レベル) == 53 === 見出し (第3レベル) === 54 === 明示的な id === #using-explicit-id-in-heading 55 }}} 56 57 表示内容: 58 = 見出し (第1レベル) = 59 == 見出し (第2レベル) == 60 === 見出し (第3レベル) === 61 === 明示的な id === #using-explicit-id-in-heading 62 63 == 改行 == 64 65 2 つのテキストブロックの間に 1 行以上の空行がある場合、新しい段落として改行を行います。 66 67 強制的に改行だけを行いたい場合、このように書いてください: 68 {{{ 69 1行目[[BR]]2行目 70 }}} 71 以下のように表示されます: 72 73 1行目[[BR]]2行目 74 75 76 == リスト == 77 78 番号付きリストと番号無しリストの両方があります。 79 80 例: 81 {{{ 357 ||= Wiki マークアップ =||= 表示 =|| 358 {{{#!td 359 {{{ 360 * Item 1 361 * Item 1.1 362 * Item 1.1.1 363 * Item 1.1.2 364 * Item 1.1.3 365 * Item 1.2 366 * Item 2 367 - 各項目は行の先頭から開始することができます。 368 そして複数行にまたがることができます。 369 - 複数行にまたがる場合は、適切なインデントをするよう 370 注意してください。さもないと 371 新しい段落が開始してしまいます。 372 373 1. Item 1 374 a. Item 1.a 375 a. Item 1.b 376 i. Item 1.b.i 377 i. Item 1.b.ii 378 1. Item 2 379 番号付きのリストは明示的に番号を付けてあげることで 380 リストを再開できます: 381 3. Item 3 382 }}} 383 }}} 384 {{{#!td 82 385 * Item 1 83 386 * Item 1.1 387 * Item 1.1.1 388 * Item 1.1.2 389 * Item 1.1.3 390 * Item 1.2 84 391 * Item 2 392 - 各項目は行の先頭から開始することができます。 393 そして複数行にまたがることができます。 394 - 複数行にまたがる場合は、適切なインデントをするよう 395 注意してください。さもないと 396 新しい段落が開始してしまいます。 85 397 86 398 1. Item 1 … … 90 402 i. Item 1.b.ii 91 403 1. Item 2 92 番号付き リストでは、番号を指定することもできます:404 番号付きのリストは明示的に番号を付けてあげることでリストを再開できます: 93 405 3. Item 3 94 406 }}} 95 407 96 表示内容: 97 * Item 1 98 * Item 1.1 99 * Item 2 100 101 1. Item 1 102 a. Item 1.a 103 a. Item 1.b 104 i. Item 1.b.i 105 i. Item 1.b.ii 106 1. Item 2 107 番号付きリストでは、番号を指定することもできます: 108 3. Item 3 109 110 リストマーカーの前にスペースを一つ以上置かなければなりません。スペースがない場合、通常のパラグラフとして扱われます。 111 112 113 == 用語定義リスト == 114 408 409 == 用語定義リスト == #DefinitionLists 115 410 116 411 Wikiは用語定義リストも作成できます。 117 412 118 例: 119 {{{ 413 ||= Wiki マークアップ =||= 表示 =|| 414 {{{#!td 415 {{{ 416 llama:: 417 毛の生えた哺乳類の一種。 418 ppython:: 419 毛がない爬虫類の一種。 420 (typoを見つけたかい?) 421 }}} 422 }}} 423 {{{#!td 120 424 llama:: 121 425 毛の生えた哺乳類の一種。 … … 125 429 }}} 126 430 127 表示内容:128 llama::129 毛の生えた哺乳類の一種。130 ppython::131 毛がない爬虫類の一種。132 (typoを見つけたかい?)133 134 431 定義する用語の前にスペースが一つ必要なことを忘れないで下さい。 135 432 136 433 137 == 整形済みテキスト == 434 == 整形済みテキスト == #PreformattedText 138 435 139 436 整形済みテキストを含むブロックは、ソースコードの一部や、ノート、例示に適しています。引用ブロックとしたいテキストの前後を、 3 つの ''ブレース (curly braces)'' で括ってください。ブレースは独立した行に置かなければいけません。 140 437 141 例: 438 ||= Wiki マークアップ =||= 表示 =|| 439 {{{#!td 440 {{{ 441 {{{ 442 def HelloWorld(): 443 print '''Hello World''' 444 }}} 445 }}} 446 }}} 447 {{{#!td 448 {{{ 449 def HelloWorld(): 450 print '''Hello World''' 451 }}} 452 }}} 453 454 Note: このブロックは、 [WikiProcessors Wiki プロセッサ] で処理されるべき行を示すためにも使用されます。 455 456 == 引用ブロック == #Blockquotes 457 458 段落を引用ブロックとしてマークするには、段落を 2 個のスペースでインデントします。 459 460 ||= Wiki マークアップ =||= 表示 =|| 461 {{{#!td 142 462 {{{ 143 {{{ 144 def HelloWorld(): 145 print "Hello World" 146 }}} 147 }}} 148 149 表示内容: 150 {{{ 151 def HelloWorld(): 152 print "Hello World" 153 }}} 154 155 156 == 引用ブロック == 157 158 段落を引用ブロックとしてマークするには、段落を 2 個のスペースでインデントします。 159 160 例: 161 {{{ 162 This text is a quote from someone else. 163 }}} 164 165 表示内容: 166 This text is a quote from someone else. 167 168 == 引用 == 463 段落 464 このテキストは何かの引用です。 465 }}} 466 }}} 467 {{{#!td 468 段落 469 このテキストは何かの引用です。 470 }}} 471 472 == 引用 == #DiscussionCitations 169 473 170 474 進行中の議題のスレッド、チケットのコメントエリアなどで引用を表すために、メールライクな引用マーク (">", ">>" など) が使用できます。 171 475 172 例: 173 {{{ 476 ||= Wiki マークアップ =||= 表示 =|| 477 {{{#!td 478 {{{ 479 >> Someone's original text 480 > Someone else's reply text 481 > - which can be any kind of Wiki markup 482 My reply text 483 }}} 484 }}} 485 {{{#!td 174 486 >> Someone's original text 175 487 > Someone else's reply text 488 > - which can be any kind of Wiki markup 176 489 My reply text 177 490 }}} 178 491 179 表示内容: 180 >> Someone's original text 181 > Someone else's reply text 182 My reply text 183 184 ''Note: いくつかの WikiFormatting の要素、 表やあらかじめ整形されたテキストは引用エリアでは整形が崩れてしまいます。きれいな引用を作るには再整形が必要になるでしょう。'' 185 186 == 表 == 187 492 493 == 表 == #Tables 494 === Simple Tables === 188 495 簡単なテーブルはこのように記述します: 189 {{{ 496 ||= Wiki マークアップ =||= 表示 =|| 497 {{{#!td 498 {{{ 499 ||Cell 1||Cell 2||Cell 3|| 500 ||Cell 4||Cell 5||Cell 6|| 501 }}} 502 }}} 503 {{{#!td style="padding: 2em;" 190 504 ||Cell 1||Cell 2||Cell 3|| 191 505 ||Cell 4||Cell 5||Cell 6|| 192 506 }}} 193 507 194 表示内容: 195 ||Cell 1||Cell 2||Cell 3|| 196 ||Cell 4||Cell 5||Cell 6|| 197 198 より複雑なテーブルは [wiki:WikiRestructuredText#より大きいReSTの例 reStructuredText] 199 を使用して書くことができます。 200 201 202 == リンク == 508 ヘッダとするセルは、等号 ('=') のペアで中身をラップすることで指定できます。 509 下記の例のように、等号 ('=') はセルのセパレータとくっつけておかなければなりません: 510 ||= Wiki マークアップ =||= 表示 =|| 511 {{{#!td 512 {{{ 513 || ||= 安定版 =||= 最新版 =|| 514 ||= 0.10 =|| 0.10.5 || 0.10.6dev|| 515 ||= 0.11 =|| 0.11.6 || 0.11.7dev|| 516 }}} 517 }}} 518 {{{#!td style="padding: 2em;" 519 || ||= 安定版 =||= 最新版 =|| 520 ||= 0.10 =|| 0.10.5 || 0.10.6dev|| 521 ||= 0.11 =|| 0.11.6 || 0.11.7dev|| 522 }}} 523 524 最後に、空のセルを指定することは、隣の空ではないセルの範囲が空のセルまで広がることを意味します。例: 525 ||= Wiki マークアップ =||= 表示 =|| 526 {{{#!td 527 {{{ 528 || 1 || 2 || 3 || 529 |||| 1-2 || 3 || 530 || 1 |||| 2-3 || 531 |||||| 1-2-3 || 532 }}} 533 }}} 534 {{{#!td style="padding: 2em;" 535 || 1 || 2 || 3 || 536 |||| 1-2 || 3 || 537 || 1 |||| 2-3 || 538 |||||| 1-2-3 || 539 }}} 540 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|| 553 }}} 554 }}} 555 {{{#!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 最後の行 || 574 }}} 575 }}} 576 |------------- 577 ||= 表示 =|| 578 {{{#!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 203 590 204 591 WikiPageNames や URL は自動的にハイパーリンクされます。 !WikiPageLinks を無効化したい場合、 {{{!WikiPageLink}}} のように、エクスクラメーションマーク (!) を語頭に置きます。 205 592 206 例: 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] 612 * [wiki:ISO9000] 613 }}} 614 }}} 615 {{{#!td 616 * [http://www.edgewall.com Edgewall Software] 617 * [wiki:TitleIndex Title Index] 618 * [wiki:TitleIndex] 619 * [wiki:ISO9000] 620 }}} 621 622 [trac:WikiCreole] の書式に従って、この種のタイトルはまた、//二重の// スクエアブラケット ('![[', ']]') 内にリンクの後ろにパイプ ('|') とタイトルを書くことによっても指定することができます。 623 624 {{{#!td 625 {{{ 626 * [[http://www.edgewall.com|Edgewall Software]] 627 * [[wiki:TitleIndex|Title Index]] 628 または [[TitleIndex|Title Index]] 629 * [[wiki:TitleIndex]] 630 ''' ![[TitleIndex]] はできません ! ''' 631 * [[ISO9000]] 632 }}} 633 }}} 634 {{{#!td 635 * [[http://www.edgewall.com|Edgewall Software]] 636 * [[wiki:TitleIndex|Title Index]] 637 or even [[TitleIndex|Title Index]] 638 * [[wiki:TitleIndex]] 639 ''' but not ![[TitleIndex]]! ''' 640 * [[ISO9000]] 641 }}} 642 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 661 * ... 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 ページ内のいたるところに明示的に追加することができます: 685 207 686 {{{ 208 TitleIndex, http://www.edgewall.com/, !NotAlink 209 }}} 210 211 表示内容: 212 TitleIndex, http://www.edgewall.com/, !NotAlink 213 214 リンク先そのものでなくリンク先の内容説明やタイトルを表示させたい場合、角括弧 (square bracket) で括り、リンクに続いて 1 文字の空白を開けて記述します。もし説明のタイトルが省略された場合、そして明確なプレフィックスが記述されなかったとき、外部へのリンクにはなりません。これは WikiPageNames の仕様に準拠できない Wiki ページを使いたい場合に役に立ちます。 215 216 例: 687 [=#point1] 688 }}} 689 690 [#Headings 上記で説明した] 明示的にヘッダ id をつけるときのフォーマットと合うようにこのシンタックスが採用されました。例: 217 691 {{{ 218 * [http://www.edgewall.com/ Edgewall Software] 219 * [wiki:TitleIndex Title Index] 220 * [wiki:ISO9000] 221 }}} 222 223 表示内容: 224 * [http://www.edgewall.com/ Edgewall Software] 225 * [wiki:TitleIndex Title Index] 226 * [wiki:ISO9000] 227 228 229 === Trac リンク === 230 231 Wiki ページでは Trac の他のコンポーネントに直接リンクできます。チケット、レポート、チェンジセット、マイルストーン、ソースファイル、他の Wiki ページへは以下のようにリンクを記述します: 692 == 長いタイトル == #title 693 }}} 694 695 そのアンカーに対応するリンクのシンタックスにも近いです: 232 696 {{{ 233 * チケット: #1 もしくは ticket:1 234 * レポート: {1} もしくは report:1 235 * チェンジセット: [1] もしくは changeset:1 236 * ... 237 }}} 238 239 表示内容: 240 * チケット: #1 もしくは ticket:1 241 * レポート: {1} もしくは report:1 242 * チェンジセット: [1] もしくは changeset:1 243 * ... 244 245 より深い情報は TracLinks に記述されています。 246 247 248 == リンクの無効化 == 697 [#point1] 698 }}} 699 700 オプションとしてアンカーにラベルを設定できます: 701 {{{ 702 [[=#point1 '''Point 1''']] 703 }}} 704 705 ||= Wiki マークアップ =||= 表示 =|| 706 |---------------------------------- 707 {{{#!td 708 {{{ 709 [#point2 ポイント 2 へジャンプする] 710 711 ... 712 713 ポイント 2: [=#point2] ここにジャンプしています 714 }}} 715 }}} 716 {{{#!td 717 [#point2 ポイント 2 へジャンプする] 718 719 ... 720 721 ポイント 2: [=#point2] ここにジャンプしています 722 }}} 723 724 より複雑なアンカー (例: カスタマイズしたタイトルが必要なとき) については、Span マクロ (例: `[[span(id=point2, class=wikianchor, title=Point 2, ^(2)^)]]`) を使用することができます。 725 726 727 == リンクの無効化と Wiki ページ名、その他のマークアップ == #EscapingLinksWikiPageNamesandotherMarkup 249 728 250 729 エクスクラメーションマーク (!) を語頭に付与することで、 TracLinks が出力するハイパーリンクを無効化できます。 251 730 252 例: 253 {{{ 731 ||= Wiki マークアップ =||= 表示 =|| 732 {{{#!td 733 {{{ 734 !NoHyperLink 735 !#42 はリンクではありません。 736 }}} 737 {{{ 738 様々な形式のリストマークアップの無効化: 739 `-` マイナス記号の無効化 \\ 740 ``1. 番号の無効化 \\ 741 {{{*}}} アスタリスク記号の無効化 742 }}} 743 }}} 744 {{{#!td 254 745 !NoHyperLink 255 746 !#42 はリンクではありません。 256 }}} 257 258 表示内容: 259 !NoHyperLink260 !#42 はリンクではありません。261 262 263 == 画像 == 747 748 様々な形式のリストマークアップの無効化: 749 `-` マイナス記号の無効化 \\ 750 ``1. 番号の無効化 \\ 751 {{{*}}} アスタリスク記号の無効化 752 }}} 753 754 == 画像 == #Images 264 755 265 756 URL が `.png`, `.gif` or `.jpg` で終わっている場合、自動的にイメージへのリンクとはならずに `<img>` タグに変換されます。 266 757 267 ![[Image]] マクロを使用しなければなりません (以下参照) 。 268 269 270 == マクロ == 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 マークアップ =||= 表示 =|| 767 {{{#!td 768 {{{ 769 [[Image(htdocs:../common/trac_logo_mini.png)]] 770 }}} 771 }}} 772 {{{#!td 773 [[Image(htdocs:../common/trac_logo_mini.png)]] 774 }}} 775 776 `[[Image()]]` マクロに関するより詳しい情報は WikiMacros に記載されています。役に立ついくつかのオプションがあります (`title=`, `link=`, など) 777 778 779 == マクロ == #Macros 271 780 272 781 マクロは、動的コンテンツを Wiki ページに挿入するための ''カスタム関数'' です。 273 782 274 例: 275 {{{ 276 [[Timestamp]] 277 }}} 278 279 表示内容: 280 [[Timestamp]] 783 ||= Wiki マークアップ =||= 表示 =|| 784 {{{#!td 785 {{{ 786 [[RecentChanges(Trac,3)]] 787 }}} 788 }}} 789 {{{#!td style="padding-left: 2em" 790 [[RecentChanges(Trac,3)]] 791 }}} 281 792 282 793 使用方法とインストールされているマクロの一覧は WikiMacros に記述されています。 283 794 284 285 == プロセッサ == 795 特定のマクロの詳細なヘルプを見るためには、マクロ名にクエスチョンマーク ("?") をつけることにより、直接見ることができます。 796 797 ||= Wiki マークアップ =||= 表示 =|| 798 {{{#!td 799 {{{ 800 [[MacroList?]] 801 }}} 802 }}} 803 {{{#!td style="padding-left: 2em" 804 [[MacroList?]] 805 }}} 806 807 808 == プロセッサ == #Processors 286 809 287 810 Trac は WikiProcessors の機能によって、 Wiki 以外のマークアップにも対応しています。例えば、プロセッサとしてページの描画に 288 811 [wiki:WikiRestructuredText reStructuredText] や [wiki:WikiHtml HTML] を使用することができます。 289 812 290 例1: 291 {{{ 292 #!html 293 <pre class="wiki">{{{ 294 #!html 295 <h1 style="text-align: right; color: blue">HTMLテスト</h1> 296 }}}</pre> 297 }}} 298 299 表示内容: 813 ||= Wiki マークアップ =||= 表示 =|| 814 |-------------------------------------------------------- 815 {{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%" 816 817 [=#Processors-example-html Example 1:] HTML 818 819 }}} 820 |-------------------------------------------------------- 821 {{{#!td style="border: 0px" 822 {{{ 823 {{{ 824 #!html 825 <h1 style="text-align: right; color: blue"> 826 HTML テスト 827 </h1> 828 }}} 829 }}} 830 }}} 831 {{{#!td valign="top" style="border: 0px" 832 300 833 {{{ 301 834 #!html … … 303 836 }}} 304 837 305 例: 838 }}} 839 |-------------------------------------------------------- 840 {{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%" 841 842 [=#Processors-example-highlight Example 2:] ソースコードのハイライト 843 844 }}} 845 |-------------------------------------------------------- 846 {{{#!td style="border: 0px" 847 {{{ 848 {{{ 849 #!python 850 class Test: 851 852 def __init__(self): 853 print "Hello World" 854 if __name__ == '__main__': 855 Test() 856 }}} 857 }}} 858 }}} 306 859 {{{ 307 #!html 308 <pre class="wiki">{{{ 309 #!python 310 class Test: 311 312 def __init__(self): 313 print "Hello World" 314 if __name__ == '__main__': 315 Test() 316 }}}</pre> 317 }}} 318 319 表示内容: 860 #!td valign="top" style="border: 0px" 861 320 862 {{{ 321 863 #!python … … 327 869 }}} 328 870 329 Perl: 871 }}} 872 |-------------------------------------------------------- 873 {{{#!td align="center" colspan=2 style="border: 0px; font-size: 90%" 874 875 [=#Processors-example-tables Example 3:] 複雑なテーブル 876 877 }}} 878 |-------------------------------------------------------- 879 {{{#!td style="border: 0px" 880 {{{ 881 {{{#!th rowspan=4 align=justify 882 `#td` や `#th` プロセッサを用いることによって、 883 表にいろいろな中身を入れ込むことができます: 884 }}} 885 |---------------- 886 {{{#!td 887 - リスト 888 - 埋め込みテーブル 889 - 簡単な複数行にわたる内容 890 }}} 891 |---------------- 892 {{{#!td 893 プロセッサはネストして使用することが簡単にできるので、 894 表はこのようにもできます: 895 {{{#!th 896 例: 897 }}} 898 {{{#!td style="background: #eef" 899 || ここは三重の入れ子になっている違いない... || 900 }}} 901 }}} 902 |---------------- 903 {{{#!td 904 複雑なマークアップではなかったときでさえ、 905 この表のセルのフォームは複数行にわたる 906 内容を書くときには便利でしょう。 907 }}} 908 }}} 909 }}} 330 910 {{{ 331 #!perl 332 my ($test) = 0; 333 if ($test > 0) { 334 print "hello"; 335 } 911 #!td valign="top" style="border: 0px" 912 913 {{{#!th rowspan=4 align=justify 914 `#td` や `#th` プロセッサを用いることによって、 915 表にいろいろな中身を入れ込むことができます: 916 }}} 917 |---------------- 918 {{{#!td 919 - リスト 920 - 埋め込みテーブル 921 - 簡単な複数行にわたる内容 922 }}} 923 |---------------- 924 {{{#!td 925 プロセッサはネストして使用することが簡単にできるので、 926 表はこのようにもできます: 927 {{{#!th 928 例: 929 }}} 930 {{{#!td style="background: #eef" 931 || ここは三重の入れ子になっている違いない... || 932 }}} 933 }}} 934 |---------------- 935 {{{#!td 936 複雑なマークアップではなかったときでさえ、 937 この表のセルのフォームは複数行にわたる 938 内容を書くときには便利でしょう。 939 }}} 940 336 941 }}} 337 942 … … 339 944 340 945 341 == その他 == 342 343 4 文字以上のハイフン (-) は水平ライン (<hr>) に置き換えられます。 344 345 例: 346 {{{ 347 ---- 348 }}} 349 350 表示内容: 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>) に置き換えられます。 979 ---- 980 分かる? 981 }}} 982 }}} 983 {{{#!td 984 4 つ以上のハイフン ('-') は横線 985 (<HR>) に置き換えられます。 351 986 ---- 352 353 354 ---- 355 See also: TracLinks, TracGuide, WikiHtml, WikiMacros, WikiProcessors, TracSyntaxColoring. 987 分かる? 988 }}} 989 |---------------------------------- 990 {{{#!td 991 {{{ 992 "マクロ" 書式 [[br]] 改行 993 }}} 994 }}} 995 {{{#!td 996 "マクロ" 書式 [[br]] 改行 997 }}} 998 |---------------------------------- 999 {{{#!td 1000 {{{ 1001 !WikiCreole 書式 \\ 改\\行 1002 }}} 1003 }}} 1004 {{{#!td 1005 !WikiCreole 書式 \\ 改\\行 1006 }}} 1007