Changes between Version 1 and Version 2 of WikiFormatting
- Timestamp:
- 09/18/14 10:48:12 (10 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
WikiFormatting
v1 v2 4 4 Wiki マークアップは Trac のコアとなる機能です。他のパーツと緊密に統合することによって、 Trac をフレキシブルかつ強力にしています。 5 5 6 Trac は小さく強力な Wiki レンダリングエンジンを内蔵しています。この Wiki エンジンは、他のポピュラーな Wiki からのコマンドの強化サブセットを実装しています。 7 (特に [http://moinmoin.wikiwikiweb.de/ MoinMoin]) 8 9 10 このページは、 WikiFormatting でフォーマットできる文法の文例集です。 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 || {{{`等幅 (''他のマークアップを無視'')`}}} || \ 31 || `等幅 (''他のマークアップを無視'')` || 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 || {{{`}}}`{{{-}}}`{{{`}}}` 3重中括弧` ||\ 185 || `{{{-}}}` 3重中括弧 || 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 }}} 11 244 12 245 … … 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 フォーマットとして解釈しないように伝えます。なので、 ! の後ろにスペースを置くことに注意して下さい。例えば、太字で行が終わるようなときです。 288 * すべてのフォント書式の記号は開始記号と終了記号のペアで使われなければなりません。 289 そして、これらのペアは適切にネストされなければなりません ( 特に、斜体の `''` は 290 `//` とペアにすることはできませんし、太字の `'''` は `**` とペアにすることはできません ) 291 40 292 41 293 == 見出し == #Headings 42 294 43 1 文字から 5 文字の「イコール '='」を行頭に置き、 1 文字のスペースに続けてタイトルを置くと、 44 見出しになります。見出しの行末は1文字のスペースに続けて、行頭と同じ数の ''イコール (=)'' を 45 置きます。 46 見出しに続いて id 属性を明示的に付与することが出来ます。付与しない場合、暗黙の読み取り可能な id 属性が生成されます。 47 '''(訳注: 明示的に付与する id 属性では日本語は使用できないようです。)''' 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 == 改行 == #Paragraphs 64 65 2 つのテキストブロックの間に 1 行以上の空行がある場合、新しい段落として改行を行います。 66 67 強制的に改行だけを行いたい場合、このように書いてください: 68 {{{ 69 1行目[[BR]]2行目 70 }}} 71 以下のように表示されます: 72 73 1行目[[BR]]2行目 74 75 76 == リスト == #Lists 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 … … 87 390 * Item 1.2 88 391 * Item 2 392 - 各項目は行の先頭から開始することができます。 393 そして複数行にまたがることができます。 394 - 複数行にまたがる場合は、適切なインデントをするよう 395 注意してください。さもないと 396 新しい段落が開始してしまいます。 89 397 90 398 1. Item 1 … … 94 402 i. Item 1.b.ii 95 403 1. Item 2 96 番号付き リストでは、番号を指定することもできます:404 番号付きのリストは明示的に番号を付けてあげることでリストを再開できます: 97 405 3. Item 3 98 406 }}} 99 407 100 表示内容:101 * Item 1102 * Item 1.1103 * Item 1.1.1104 * Item 1.1.2105 * Item 1.1.3106 * Item 1.2107 * Item 2108 109 1. Item 1110 a. Item 1.a111 a. Item 1.b112 i. Item 1.b.i113 i. Item 1.b.ii114 1. Item 2115 番号付きリストでは、番号を指定することもできます:116 3. Item 3117 118 リストマーカーの前にスペースを一つ以上置かなければなりません。スペースがない場合、通常のパラグラフとして扱われます。119 120 408 121 409 == 用語定義リスト == #DefinitionLists 122 410 123 124 411 Wikiは用語定義リストも作成できます。 125 412 126 例: 127 {{{ 413 ||= Wiki マークアップ =||= 表示 =|| 414 {{{#!td 415 {{{ 416 llama:: 417 毛の生えた哺乳類の一種。 418 ppython:: 419 毛がない爬虫類の一種。 420 (typoを見つけたかい?) 421 }}} 422 }}} 423 {{{#!td 128 424 llama:: 129 425 毛の生えた哺乳類の一種。 … … 133 429 }}} 134 430 135 表示内容:136 llama::137 毛の生えた哺乳類の一種。138 ppython::139 毛がない爬虫類の一種。140 (typoを見つけたかい?)141 142 431 定義する用語の前にスペースが一つ必要なことを忘れないで下さい。 143 432 … … 147 436 整形済みテキストを含むブロックは、ソースコードの一部や、ノート、例示に適しています。引用ブロックとしたいテキストの前後を、 3 つの ''ブレース (curly braces)'' で括ってください。ブレースは独立した行に置かなければいけません。 148 437 149 例: 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 150 462 {{{ 151 {{{ 152 def HelloWorld(): 153 print "Hello World" 154 }}} 155 }}} 156 157 表示内容: 158 {{{ 159 def HelloWorld(): 160 print "Hello World" 161 }}} 162 163 164 == 引用ブロック == #Blockquotes 165 166 段落を引用ブロックとしてマークするには、段落を 2 個のスペースでインデントします。 167 168 例: 169 {{{ 170 This text is a quote from someone else. 171 }}} 172 173 表示内容: 174 This text is a quote from someone else. 463 段落 464 このテキストは何かの引用です。 465 }}} 466 }}} 467 {{{#!td 468 段落 469 このテキストは何かの引用です。 470 }}} 175 471 176 472 == 引用 == #DiscussionCitations … … 178 474 進行中の議題のスレッド、チケットのコメントエリアなどで引用を表すために、メールライクな引用マーク (">", ">>" など) が使用できます。 179 475 180 例: 181 {{{ 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 182 486 >> Someone's original text 183 487 > Someone else's reply text 488 > - which can be any kind of Wiki markup 184 489 My reply text 185 490 }}} 186 491 187 表示内容:188 >> Someone's original text189 > Someone else's reply text190 My reply text191 192 ''Note: いくつかの WikiFormatting の要素、 表やあらかじめ整形されたテキストは引用エリアでは整形が崩れてしまいます。きれいな引用を作るには再整形が必要になるでしょう。''193 492 194 493 == 表 == #Tables 195 494 === Simple Tables === 196 495 簡単なテーブルはこのように記述します: 197 {{{ 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;" 198 504 ||Cell 1||Cell 2||Cell 3|| 199 505 ||Cell 4||Cell 5||Cell 6|| 200 506 }}} 201 507 202 表示内容: 203 ||Cell 1||Cell 2||Cell 3|| 204 ||Cell 4||Cell 5||Cell 6|| 205 206 より複雑なテーブルは [wiki:WikiRestructuredText#より大きいReSTの例 reStructuredText] 207 を使用して書くことができます。 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 プロセッサ] を使用して、より凝ったテーブルを作成することができます。 208 587 209 588 … … 212 591 WikiPageNames や URL は自動的にハイパーリンクされます。 !WikiPageLinks を無効化したい場合、 {{{!WikiPageLink}}} のように、エクスクラメーションマーク (!) を語頭に置きます。 213 592 214 例: 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 215 686 {{{ 216 TitleIndex, http://www.edgewall.com/, !NotAlink 217 }}} 218 219 表示内容: 220 TitleIndex, http://www.edgewall.com/, !NotAlink 221 222 リンク先そのものでなくリンク先の内容説明やタイトルを表示させたい場合、角括弧 (square bracket) で括り、リンクに続いて 1 文字の空白を開けて記述します。もし説明のタイトルが省略された場合、そして明確なプレフィックスが記述されなかったとき、外部へのリンクにはなりません。これは WikiPageNames の仕様に準拠できない Wiki ページを使いたい場合に役に立ちます。 223 224 例: 687 [=#point1] 688 }}} 689 690 [#Headings 上記で説明した] 明示的にヘッダ id をつけるときのフォーマットと合うようにこのシンタックスが採用されました。例: 225 691 {{{ 226 * [http://www.edgewall.com/ Edgewall Software] 227 * [wiki:TitleIndex Title Index] 228 * [wiki:ISO9000] 229 }}} 230 231 表示内容: 232 * [http://www.edgewall.com/ Edgewall Software] 233 * [wiki:TitleIndex Title Index] 234 * [wiki:ISO9000] 235 236 == Trac リンク == #TracLinks 237 238 Wiki ページでは Trac の他のコンポーネントに直接リンクできます。チケット、レポート、チェンジセット、マイルストーン、ソースファイル、他の Wiki ページへは以下のようにリンクを記述します: 692 == 長いタイトル == #title 693 }}} 694 695 そのアンカーに対応するリンクのシンタックスにも近いです: 239 696 {{{ 240 * チケット: #1 もしくは ticket:1 241 * レポート: {1} もしくは report:1 242 * チェンジセット: r1, [1] もしくは changeset:1 243 * ... 244 }}} 245 246 表示内容: 247 * チケット: #1 もしくは ticket:1 248 * レポート: {1} もしくは report:1 249 * チェンジセット: r1, [1] もしくは changeset:1 250 * ... 251 252 Trac は他にも多くの種類のリンクを使用することができます。より詳しい情報は TracLinks を参照してください。 253 254 255 == リンクの無効化 == #EscapingLinksandWikiPageNames 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 256 728 257 729 エクスクラメーションマーク (!) を語頭に付与することで、 TracLinks が出力するハイパーリンクを無効化できます。 258 730 259 例: 260 {{{ 731 ||= Wiki マークアップ =||= 表示 =|| 732 {{{#!td 733 {{{ 734 !NoHyperLink 735 !#42 はリンクではありません。 736 }}} 737 {{{ 738 様々な形式のリストマークアップの無効化: 739 `-` マイナス記号の無効化 \\ 740 ``1. 番号の無効化 \\ 741 {{{*}}} アスタリスク記号の無効化 742 }}} 743 }}} 744 {{{#!td 261 745 !NoHyperLink 262 746 !#42 はリンクではありません。 263 }}} 264 265 表示内容: 266 !NoHyperLink267 !#42 はリンクではありません。268 747 748 様々な形式のリストマークアップの無効化: 749 `-` マイナス記号の無効化 \\ 750 ``1. 番号の無効化 \\ 751 {{{*}}} アスタリスク記号の無効化 752 }}} 269 753 270 754 == 画像 == #Images … … 275 759 276 760 現在のページに加えて、他のリソースを参照することも可能です。 277 * `[[Image(wiki:WikiFormatting:picture.gif)]]` (referring to attachment on another page) 278 * `[[Image(ticket:1:picture.gif)]]` (file attached to a ticket) 279 * `[[Image(htdocs:picture.gif)]]` (referring to a file inside project htdocs) 280 * `[[Image(source:/trunk/trac/htdocs/trac_logo_mini.png)]]` (a file in repository) 281 282 表示例: [[Image(htdocs:../common/trac_logo_mini.png)]] 283 284 285 `[[Image()]]` マクロに関するより詳しい情報は WikiMacros に記載されています。 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=`, など) 286 777 287 778 … … 290 781 マクロは、動的コンテンツを Wiki ページに挿入するための ''カスタム関数'' です。 291 782 292 例: 293 {{{ 294 [[RecentChanges(Trac,3)]] 295 }}} 296 297 表示内容: 298 [[RecentChanges(Trac,3)]] 783 ||= Wiki マークアップ =||= 表示 =|| 784 {{{#!td 785 {{{ 786 [[RecentChanges(Trac,3)]] 787 }}} 788 }}} 789 {{{#!td style="padding-left: 2em" 790 [[RecentChanges(Trac,3)]] 791 }}} 299 792 300 793 使用方法とインストールされているマクロの一覧は WikiMacros に記述されています。 794 795 特定のマクロの詳細なヘルプを見るためには、マクロ名にクエスチョンマーク ("?") をつけることにより、直接見ることができます。 796 797 ||= Wiki マークアップ =||= 表示 =|| 798 {{{#!td 799 {{{ 800 [[MacroList?]] 801 }}} 802 }}} 803 {{{#!td style="padding-left: 2em" 804 [[MacroList?]] 805 }}} 301 806 302 807 … … 306 811 [wiki:WikiRestructuredText reStructuredText] や [wiki:WikiHtml HTML] を使用することができます。 307 812 308 例1: 309 {{{ 310 #!html 311 <pre class="wiki">{{{ 312 #!html 313 <h1 style="text-align: right; color: blue">HTMLテスト</h1> 314 }}}</pre> 315 }}} 316 317 表示内容: 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 318 833 {{{ 319 834 #!html … … 321 836 }}} 322 837 323 例: 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 }}} 324 859 {{{ 325 #!html 326 <pre class="wiki">{{{ 327 #!python 328 class Test: 329 330 def __init__(self): 331 print "Hello World" 332 if __name__ == '__main__': 333 Test() 334 }}}</pre> 335 }}} 336 337 表示内容: 860 #!td valign="top" style="border: 0px" 861 338 862 {{{ 339 863 #!python … … 345 869 }}} 346 870 347 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 }}} 348 910 {{{ 349 #!perl 350 my ($test) = 0; 351 if ($test > 0) { 352 print "hello"; 353 } 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 354 941 }}} 355 942 … … 360 947 361 948 コメントをプレーンテキストに追加することができます。コメントはレンダリングされず、プレーンテキスト形式でのみ表示されます。 362 {{{ 363 {{{ 364 #!comment 365 Your comment here 366 }}} 367 }}} 368 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 }}} 369 969 370 970 == その他 == #Miscellaneous 371 971 372 4 文字以上のハイフン (-) は水平ライン (<hr>) に置き換えられます。 373 374 例: 375 {{{ 376 ---- 377 }}} 378 379 表示内容: 972 横線はページをいくつかに分けるために使用されます: 973 974 ||= Wiki マークアップ =||= 表示 =|| 975 {{{#!td 976 {{{ 977 4 つ以上のハイフン ('-') は横線 978 (<HR>) に置き換えられます。 979 ---- 980 分かる? 981 }}} 982 }}} 983 {{{#!td 984 4 つ以上のハイフン ('-') は横線 985 (<HR>) に置き換えられます。 380 986 ---- 381 382 383 384 ---- 385 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
