= Wiki プロセッサ = #WikiProcessors

プロセッサは [WikiMacros Wiki マクロ] の一種です。 [TracWiki Trac Wiki エンジン] 以外のマークアップフォーマットを使用するために設計されています。プロセッサは ''ユーザが編集したテキストを処理するマクロ機能'' と考えることができます。

Trac 内の全ての Wiki テキストにおいて、 Wiki プロセッサを使用することができます。
例えば、以下に述べる様々な用途で使用することができます:
 - [#CodeHighlightingSupport シンタックスハイライト] またはテキストを逐語的にレンダリングする,
 -  <div> ブロックや <span> や <td>, <th> のテーブルのセルの内容など
   [#HTMLrelated コンテキスト内の Wiki のマークアップ]をレンダリングする,
 - [wiki:WikiHtml HTML] や
   [wiki:WikiRestructuredText Restructured テキスト]
   または [http://www.textism.com/tools/textile/ textile] のシンタックスをマークアップの代替手段として使用する


== プロセッサを使用する == #UsingProcessors

テキストブロック上に Wiki プロセッサを適用するには、
最初のデリミタとして Wiki の ''コードブロック'' を使用します:
{{{
{{{
これらの行は
処理されるでしょう...
}}}
}}}

`{{{` のすぐ後または直後の行に, 
`#!` に続けて ''プロセッサ名'' を追加します。.

{{{
{{{
#!プロセッサ名
これらの行は
処理されるでしょう...
}}}
}}}

これはほとんどの UNIX ユーザにはおなじみである "shebang" を用いた表記法です。

これらの内容に加えて、いくつかの Wiki プロセッサでは、 
プロセッサ名に続けて同じ行に、 `key=value` のペアを書くことによって、 
''パラメータ'' を許容するものがあります。もし、 `value` にスペースが含まれるケースがたびたび起こるようであれば、
クオテーションで囲んだ文字列を使用することができます (`key="スペースが含まれている文字列"`) 。

いくつかのプロセッサは Wiki のマークアップを処理することを意味するので、
プロセッサのブロックを ''ネスト'' させることができます。
可読性を向上させるためにネストしたブロックの内容をインデントさせたいと思うかもしれません。
この種のインデントは中身を処理する際に無視されます。


== 例 ==

||= Wiki マークアップ =||= 表示 =||
{{{#!td colspan=2 align=center style="border: none"

                __例 1__: HTML を挿入する
}}}
|-----------------------------------------------------------------
{{{#!td style="border: none"
{{{
{{{
<h1 style="color: grey">HTML テスト</h1>
}}}
}}}
}}}
{{{#!td valign=top style="border: none; padding-left: 2em"
{{{
#!html
<h1 style="color: grey">HTML テスト</h1>
}}}
}}}
|-----------------------------------------------------------------
{{{#!td colspan=2 align=center style="border: none"

     __例 2__: <div> ブロック内のカスタマイズしたスタイルシートでハイライトした Python のコード
}}}
|-----------------------------------------------------------------
{{{#!td style="border: none"
  {{{
  {{{#!div style="background: #ffd; border: 3px ridge"

  これは 埋め込まれた "コード" ブロックの例です:

    {{{
    #!python
    def hello():
        return "world"
    }}}

  }}}
  }}}
}}}
{{{#!td valign=top style="border: none; padding: 1em"
  {{{#!div style="background: #ffd; border: 3px ridge"

  これは 埋め込まれた "コード" ブロックの例です:

    {{{
    #!python
    def hello():
        return "world"
    }}}

  }}}
}}}
|-----------------------------------------------------------------
{{{#!td colspan=2 align=center style="border: none"

     __例 3__: Wiki ページでチケットのキーワード検索を行なう
}}}
|-----------------------------------------------------------------
{{{#!td style="border: none"
  {{{
  {{{
  #!html
  <form action="/query" method="get">
  <input type="text" name="keywords" value="~" size="30">
  <input type="submit" value="キーワードで検索">
  <!-- To control what fields show up use hidden fields
  <input type="hidden" name="col" value="id">
  <input type="hidden" name="col" value="summary">
  <input type="hidden" name="col" value="status">
  <input type="hidden" name="col" value="milestone">
  <input type="hidden" name="col" value="version">
  <input type="hidden" name="col" value="owner">
  <input type="hidden" name="col" value="priority">
  <input type="hidden" name="col" value="component">
  -->
  </form>
  }}}
  }}}
}}}
{{{#!td valign=top style="border: none; padding: 1em"
  {{{
  #!html
  <form action="/query" method="get">
  <input type="text" name="keywords" value="~" size="30">
  <input type="submit" value="キーワードで検索">
  <!-- To control what fields show up use hidden fields
  <input type="hidden" name="col" value="id">
  <input type="hidden" name="col" value="summary">
  <input type="hidden" name="col" value="status">
  <input type="hidden" name="col" value="milestone">
  <input type="hidden" name="col" value="version">
  <input type="hidden" name="col" value="owner">
  <input type="hidden" name="col" value="priority">
  <input type="hidden" name="col" value="component">
  -->
  </form>
  }}}
}}}
== プロセッサ一覧 == #AvailableProcessors

以下のプロセッサが Trac の配布に含まれています:

 `#!default` :: フォーマット済みのテキストブロック内でテキストを逐語的に表示する。 
                これはプロセッサ名を指定 ''しない'' のと同じです。
                (さらに `#!` を指定しないのと同じです)
 `#!comment` :: このセクション内のテキストを処理しません(つまり、このセクションの内容は
                プレインテキスト内にのみ存在します - レンダリングしたページには表示されません)。

=== HTML 関連 === #HTMLrelated

 `#!html`        :: Wiki ページにカスタムした HTML を挿入する。
 `#!htmlcomment` :: Wiki ページに HTML のコメントを挿入する (''0.12 以降'') 。

`#!html` ブロックは ''自己完結型'' でなければなりません。
つまり、1つ目のブロックである HTML 要素を開始し、後に記述する2つ目のブロックでその要素を閉じるということはできません。これに類似した効果を得るためには、下記に述べるプロセッサを使用して下さい。

  `#!div` :: <div> 要素内の任意の Wiki の内容をラップする
             (''0.11 以降'').
 `#!span` :: <span> 要素内の任意の Wiki の内容をラップする 
             (''0.11 以降''). 

 `#!td` :: <td> 要素内の任意の Wiki の内容をラップする (''0.12 以降'')
 `#!th` :: <th> 要素内の任意の Wiki の内容をラップする (''0.12 以降'') 
 `#!tr` :: `#!td` や `#!th` ブロックをラッピングしたり、
       グルーピングした列を見やすくするために属性を指定する際、オプションとして使用することができます。
       (''0.12 以降'')

これらのプロセッサについての詳細と使用例については、 WikiHtml を参照して下さい。

=== その他のプロセッサ ===#OtherMarkups

     `#!rst` :: Trac における Restructured テキストのサポート. WikiRestructuredText 参照。
 `#!textile` :: [http://cheeseshop.python.org/pypi/textile Textile] がインストール
                されている場合のサポート。
                [http://www.textism.com/tools/textile/ a Textile リファレンス] 参照。


=== コードのハイライトのサポート ===#CodeHighlightingSupport

Trac はインラインのシンタックスハイライトを提供するプロセッサを同梱しています:
 `#!c` (C), `#!cpp` (C++), `#!python` (Python), `#!perl` (Perl), 
 `#!ruby` (Ruby), `#!php` (PHP), `#!asp` (ASP), `#!java` (Java), 
 `#!js` (Javascript), `#!sql (SQL)`, `#!xml` (XML または HTML),
 `#!sh` (!Bourne/Bash シェル), など。

Trac では、シンタックスのカラーリングについて外部のソフトウェア
例えば [http://pygments.org Pygments] に依存しています。 

TracSyntaxColoring にどの言語のシンタックスハイライトがサポートされているかについての情報と
その他の言語のシンタックスハイライトのサポートを有効にする方法について書かれています。 

MIME タイプをプロセッサ名として使用することによって、ソースコードをブラウズするときに、サポートしている言語についてはシンタックスハイライトをすることが可能です。例えば、このように書くことができます:
{{{
{{{
#!text/html
<h1>テキスト</h1>
}}}
}}}

この結果はシンタックスハイライトされた HTML コードになります:
{{{
#!text/html
<h1>text</h1>
}}}

これは、対応しているすべての [TracSyntaxColoring#SyntaxColoringSupport 対応している MIME タイプ] に対して有効です。


ユーザによるプロセッサマクロの開発やコントリビュート:
 * [http://trac.edgewall.org/wiki/ProcessorBazaar ProcessorBazaar]
 * [http://trac.edgewall.org/wiki/MacroBazaar MacroBazaar]
 * [http://trac-hacks.org/ Trac Hacks] コミュニティサイト

プロセッサは Wiki マクロを開発するのと変わりはありません。
実際、開発方法は同じであり、シンタックスの使用方法のみが異なります。 
詳細情報については、 [WikiMacros#DevelopingCustomMacros カスタムマクロを開発する] を参照して下さい。


----
See also: WikiMacros, WikiHtml, WikiRestructuredText, TracSyntaxColoring, WikiFormatting, TracGuide