Changes between Initial Version and Version 1 of WikiProcessors


Ignore:
Timestamp:
06/04/12 12:01:35 (12 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiProcessors

    v1 v1  
     1= Wiki プロセッサ = #WikiProcessors 
     2 
     3プロセッサは [WikiMacros Wiki マクロ] の一種です。 [TracWiki Trac Wiki エンジン] 以外のマークアップフォーマットを使用するために設計されています。プロセッサは ''ユーザが編集したテキストを処理するマクロ機能'' と考えることができます。 
     4 
     5Trac 内の全ての Wiki テキストにおいて、 Wiki エンジンにプロセッサを使わせることによって [wiki:WikiRestructuredText Restructured Text], [wiki:WikiHtml raw HTML] および [http://www.textism.com/tools/textile/ textile] を使用することができます。 
     6 
     7 
     8== プロセッサを使用する == #UsingProcessors 
     9 
     10テキストブロックでプロセッサを使うには、 Wiki のコードブロックを使用し、プロセッサの名前を (Unix 系 OS のスクリプトのように) ''shebang 行'' (#!) に続いて指定します。 
     11 
     12'''例1''' (''Wiki テキストに raw HTML を挿入する''): 
     13 
     14{{{ 
     15#!html 
     16<pre class="wiki">{{{ 
     17#!html 
     18&lt;h1 style="color: orange"&gt;これは raw HTML です&lt;/h1&gt; 
     19}}}</pre> 
     20}}} 
     21 
     22'''結果、このように表示されます:''' 
     23{{{ 
     24#!html 
     25<h1 style="color: orange">これは raw HTML です</h1> 
     26}}} 
     27 
     28Note that since 0.11, such blocks of HTML have to be self-contained, i.e. you can't start an HTML element in one block and close it later in a second block. Use div or span processors for achieving similar effect (see WikiHtml). 
     29 
     30---- 
     31 
     32'''例2''' (''Wiki テキストに !ReStructured テキストを挿入する''): 
     33 
     34{{{ 
     35#!html 
     36<pre class="wiki">{{{ 
     37#!rst 
     38見出し 
     39------ 
     40脚注 [*]_ 付きの **text** です。 
     41 
     42.. [*] ここは脚注。 
     43}}}</pre> 
     44}}} 
     45 
     46'''結果、このように表示されます:''' 
     47{{{ 
     48#!rst 
     49見出し 
     50------ 
     51脚注 [*]_ 付きの **text** です。 
     52 
     53.. [*] ここは脚注。 
     54}}} 
     55---- 
     56'''例3''' (''Wiki テキストに C 言語ソースコードブロックを挿入する''): 
     57 
     58{{{ 
     59#!html 
     60<pre class="wiki">{{{ 
     61#!c 
     62int main(int argc, char *argv[]) 
     63{ 
     64  printf("Hello World\n"); 
     65  return 0; 
     66} 
     67}}}</pre> 
     68}}} 
     69 
     70'''結果、このように表示されます:''' 
     71{{{ 
     72#!c 
     73int main(int argc, char *argv[]) 
     74{ 
     75  printf("Hello World\n"); 
     76  return 0; 
     77} 
     78}}} 
     79 
     80---- 
     81 
     82== プロセッサ一覧 == #AvailableProcessors 
     83以下のプロセッサが Trac の配布に含まれています: 
     84 * '''html''' -- Wiki ページにカスタム HTML を挿入する。 WikiHtml を参照してください。 
     85 * '''div''' -- Wiki ページの内容を任意の <div> 要素でラップする (''0.11 以降'')。 WikiHtml を参照してください。 
     86 * '''span''' -- Wiki ページの内容を任意の <span> 要素でラップする (''0.11 以降'')。 WikiHtml を参照してください。 
     87 * '''rst''' -- Restructured テキスト を Trac で利用可能にする。 WikiRestructuredText を参照してください。 
     88 * '''textile''' -- [http://cheeseshop.python.org/pypi/textile Textile] をインストールすれば利用可能です。 [http://www.textism.com/tools/textile/ Textile リファレンス] を参照してください。 
     89 * '''comment''' -- セクション内のテキストを処理しません。(セクションの内容はレンダリングされた Wiki ページには出力されず、プレーンテキストにのみ保持されます。) 
     90 
     91=== ソースコードの強調表示対応 === #CodeHighlightingSupport 
     92Trac では、以下のプログラミング言語でのインライン [wiki:TracSyntaxColoring シンタックスハイライト] を行うプロセッサが組み込まれています。 
     93 * '''c''' -- C 
     94 * '''cpp''' -- C++ 
     95 * '''python''' -- Python 
     96 * '''perl''' -- Perl 
     97 * '''ruby''' -- Ruby 
     98 * '''php''' -- PHP 
     99 * '''asp''' -- ASP 
     100 * '''java''' -- Java 
     101 * '''js''' -- Javascript 
     102 * '''sql''' -- SQL 
     103 * '''xml''' -- XML 
     104 * '''sh''' -- Bourne/Bash shell 
     105 
     106'''Note:''' ''Trac はシンタックスの色付けを、外部のソフトウェアパッケージに依存しています。詳しくは TracSyntaxColoring をご覧下さい。'' 
     107 
     108プロセッサとして mime-type が指定されると、ソースコードをブラウズするときと同じく、対応されている言語であれば、シンタックスハイライトを行うことができます。例えば、以下のように書くと: 
     109{{{ 
     110{{{ 
     111#!text/html 
     112<h1>text</h1> 
     113}}} 
     114}}} 
     115 
     116この結果はシンタックスハイライトされた HTML コードになります: 
     117{{{ 
     118#!text/html 
     119<h1>text</h1> 
     120}}} 
     121 
     122対応している全ての mime-type でも、これは同じく有効です。 
     123 
     124 
     125ユーザによるプロセッサマクロの開発やコントリビュート: 
     126 * [http://trac.edgewall.org/wiki/ProcessorBazaar ProcessorBazaar] 
     127 * [http://trac.edgewall.org/wiki/MacroBazaar MacroBazaar] 
     128 * [http://trac-hacks.org/ Trac Hacks] コミュニティサイト 
     129 
     130 
     131== 上級トピック: プロセッサマクロを開発する == #AdvancedTopics:DevelopingProcessorMacros 
     132プロセッサの開発は Wiki マクロと違いはありません。事実、これらは同じような機能を持ち、シンタックスだけが異なります。詳しくは WikiMacros を参照してください。 
     133 
     134 
     135---- 
     136See also: WikiMacros, WikiHtml, WikiRestructuredText, TracSyntaxColoring, WikiFormatting, TracGuide