Changes between Initial Version and Version 1 of WikiFormatting


Ignore:
Timestamp:
Apr 10, 2015, 1:03:53 PM (9 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiFormatting

    v1 v1  
     1= Wiki 文法 = #WikiFormatting
     2[[TracGuideToc]]
     3
     4Wiki マークアップは Trac のコアとなる機能です。他のパーツと緊密に統合することによって、 Trac をフレキシブルかつ強力にしています。
     5
     6Trac はビルトインの小規模だけれども強力な 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}}}
     244
     245
     246== フォント書式 == #FontStyles
     247
     248Trac の 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
     285Note:
     286 * `{{{...}}}`と {{{`...`}}} コマンドは表示を等角フォントにするだけではなく、内容を整形済みテキストとして扱います。つまりテキストに対して、どのような Wiki 処理も行いません
     287 * {{{ ! }}} は wiki パーサに wiki フォーマットとして解釈しないように伝えます。なので、 ! の後ろにスペースを置くことに注意して下さい。例えば、太字で行が終わるようなときです
     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
     3262 つのテキストブロックの間に 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 マークアップ =||= 表示 =||
     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
     385 * Item 1
     386   * Item 1.1
     387      * Item 1.1.1
     388      * Item 1.1.2
     389      * Item 1.1.3
     390   * Item 1.2
     391 * Item 2
     392- 各項目は行の先頭から開始することができます。
     393  そして複数行にまたがることができます。
     394  - 複数行にまたがる場合は、適切なインデントをするよう
     395  注意してください。さもないと
     396新しい段落が開始してしまいます。
     397
     398 1. Item 1
     399   a. Item 1.a
     400   a. Item 1.b
     401      i. Item 1.b.i
     402      i. Item 1.b.ii
     403 1. Item 2
     404番号付きのリストは明示的に番号を付けてあげることでリストを再開できます:
     405 3. Item 3
     406}}}
     407
     408
     409== 用語定義リスト == #DefinitionLists
     410
     411Wikiは用語定義リストも作成できます。
     412
     413||= Wiki マークアップ =||= 表示 =||
     414{{{#!td
     415  {{{
     416   llama::
     417     毛の生えた哺乳類の一種。
     418   ppython::
     419     毛がない爬虫類の一種。
     420     (typoを見つけたかい?)
     421  }}}
     422}}}
     423{{{#!td
     424 llama::
     425   毛の生えた哺乳類の一種。
     426 ppython::
     427   毛がない爬虫類の一種。
     428   (typoを見つけたかい?)
     429}}}
     430
     431定義する用語の前にスペースが一つ必要なことを忘れないで下さい。
     432
     433
     434== 整形済みテキスト == #PreformattedText
     435
     436整形済みテキストを含むブロックは、ソースコードの一部や、ノート、例示に適しています。引用ブロックとしたいテキストの前後を、 3 つの ''ブレース (curly braces)'' で括ってください。ブレースは独立した行に置かなければいけません。
     437
     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
     454Note: このブロックは、 [WikiProcessors Wiki プロセッサ] で処理されるべき行を示すためにも使用されます。
     455
     456== 引用ブロック == #Blockquotes
     457
     458段落を引用ブロックとしてマークするには、段落を 2 個のスペースでインデントします。
     459
     460||= Wiki マークアップ =||= 表示 =||
     461{{{#!td
     462{{{
     463段落
     464  このテキストは何かの引用です。
     465}}}
     466}}}
     467{{{#!td
     468段落
     469  このテキストは何かの引用です。
     470}}}
     471
     472== 引用 == #DiscussionCitations
     473
     474進行中の議題のスレッド、チケットのコメントエリアなどで引用を表すために、メールライクな引用マーク (">", ">>" など) が使用できます。
     475
     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
     486>> Someone's original text
     487> Someone else's reply text
     488>  - which can be any kind of Wiki markup
     489My reply text
     490}}}
     491
     492
     493== 表 == #Tables
     494=== Simple Tables ===
     495簡単なテーブルはこのように記述します:
     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;"
     504||Cell 1||Cell 2||Cell 3||
     505||Cell 4||Cell 5||Cell 6||
     506}}}
     507
     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
     590
     591WikiPageNames や URL は自動的にハイパーリンクされます。 !WikiPageLinks を無効化したい場合、 {{{!WikiPageLink}}} のように、エクスクラメーションマーク (!) を語頭に置きます。
     592
     593||= Wiki マークアップ =||= 表示 =||
     594{{{#!td
     595  {{{
     596  TitleIndex, http://www.edgewall.com/, !NotAlink
     597  }}}
     598}}}
     599{{{#!td
     600TitleIndex, 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     または [[TitleIndex|Title Index]]
     638   * [[wiki:TitleIndex]]
     639     '''  ![[TitleIndex]] はできません !  '''
     640   * [[ISO9000]]
     641}}}
     642
     643'''Note''': [trac:WikiCreole] のリンク用の書式は
     644Wikipedia や他の wiki で使用されていたりするので、素早くタイプでき、
     645確実に親しみやすいです。しかし不幸なことにこの書式は、 [#Macros マクロ] の書式とかぶってしまいます。
     646したがって、まれなケースですが、マクロ名にちなんだ wiki ページ名にリンクをはる必要があるとき
     647( 典型的な例では、 TitleIndex, InterTrac や InterWiki)、
     648`[[TitleIndex]]` と書くと、ページへリンクする代わりにマクロを
     649呼び出してしまいます。
     650
     651== Trac リンク == #TracLinks
     652
     653Wiki ページでは 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
     686{{{
     687[=#point1]
     688}}}
     689
     690[#Headings 上記で説明した] 明示的にヘッダ id をつけるときのフォーマットと合うようにこのシンタックスが採用されました。例:
     691{{{
     692== 長いタイトル == #title
     693}}}
     694
     695そのアンカーに対応するリンクのシンタックスにも近いです:
     696{{{
     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
     728
     729エクスクラメーションマーク (!) を語頭に付与することで、 TracLinks が出力するハイパーリンクを無効化できます。
     730
     731||= Wiki マークアップ =||= 表示 =||
     732{{{#!td
     733  {{{
     734   !NoHyperLink
     735   !#42 はリンクではありません。
     736  }}}
     737  {{{
     738様々な形式のリストマークアップの無効化:
     739 `-` マイナス記号の無効化 \\
     740 ``1. 番号の無効化  \\
     741 {{{*}}} アスタリスク記号の無効化
     742  }}}
     743}}}
     744{{{#!td
     745 !NoHyperLink
     746 !#42 はリンクではありません。
     747
     748様々な形式のリストマークアップの無効化:
     749 `-` マイナス記号の無効化 \\
     750 ``1. 番号の無効化  \\
     751 {{{*}}} アスタリスク記号の無効化
     752}}}
     753
     754== 画像 == #Images
     755
     756URL が `.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 マークアップ =||= 表示 =||
     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
     780
     781マクロは、動的コンテンツを Wiki ページに挿入するための ''カスタム関数'' です。
     782
     783||= Wiki マークアップ =||= 表示 =||
     784{{{#!td
     785  {{{
     786  [[RecentChanges(Trac,3)]]
     787  }}}
     788}}}
     789{{{#!td style="padding-left: 2em"
     790[[RecentChanges(Trac,3)]]
     791}}}
     792
     793使用方法とインストールされているマクロの一覧は WikiMacros に記述されています。
     794
     795特定のマクロの詳細なヘルプを見るためには、マクロ名にクエスチョンマーク ("?") をつけることにより、直接見ることができます。
     796
     797||= Wiki マークアップ =||= 表示 =||
     798{{{#!td
     799  {{{
     800  [[MacroList?]]
     801  }}}
     802}}}
     803{{{#!td style="padding-left: 2em"
     804[[MacroList?]]
     805}}}
     806
     807
     808== プロセッサ == #Processors
     809
     810Trac は WikiProcessors の機能によって、 Wiki 以外のマークアップにも対応しています。例えば、プロセッサとしてページの描画に
     811[wiki:WikiRestructuredText reStructuredText] や [wiki:WikiHtml HTML] を使用することができます。
     812
     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
     833{{{
     834#!html
     835<h1 style="text-align: right; color: blue">HTMLテスト</h1>
     836}}}
     837
     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}}}
     859{{{
     860#!td valign="top"  style="border: 0px"
     861
     862{{{
     863#!python
     864class Test:
     865    def __init__(self):
     866        print "Hello World"
     867if __name__ == '__main__':
     868   Test()
     869}}}
     870
     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}}}
     910{{{
     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
     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>) に置き換えられます。
     979  ----
     980  分かる?
     981  }}}
     982}}}
     983{{{#!td
     984  4 つ以上のハイフン ('-') は横線
     985  (<HR>) に置き換えられます。
     986----
     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}}}