Changes between Initial Version and Version 1 of WikiProcessors


Ignore:
Timestamp:
06/11/06 17:57:32 (18 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • WikiProcessors

    v1 v1  
     1= Wiki プロセッサ = 
     2プロセッサは Trac の Wiki エンジンが、 Wiki 以外のフォーマットを提供するために設計された WikiMacros です。プロセッサは、 ''ユーザが編集したテキストを処理するマクロ機能'' と考えることができます。 
     3 
     4Trac 内の全ての Wiki テキストにおいて、 [wiki:WikiRestructuredText Restructured Text] および [wiki:WikiHtml raw HTML] をプロセッサとして使用することができます。 
     5 
     6テキストブロックでプロセッサを使うには、 Wiki の引用ブロックを使用し、プロセッサの名前を (Unix 系 OS のスクリプトのように) ''shebang 行'' (#!) に続いて指定します。 
     7 
     8'''例1''' (''Wiki テキストに 生 HTML を挿入する''): 
     9 
     10{{{ 
     11#!html 
     12<pre class="wiki">{{{ 
     13#!html 
     14&lt;h1 style="color: orange"&gt;これは生 HTML です&lt;/h1&gt; 
     15}}}</pre> 
     16}}} 
     17 
     18'''結果、このように表示されます:''' 
     19{{{ 
     20#!html 
     21<h1 style="color: orange">これは生 HTML です</h1> 
     22}}} 
     23 
     24---- 
     25 
     26'''例2''' (''Wiki テキストに !ReStructured テキストを挿入する''): 
     27 
     28{{{ 
     29#!html 
     30<pre class="wiki">{{{ 
     31#!rst 
     32見出し 
     33------ 
     34脚注 [*]_ 付きの **text** です。 
     35 
     36.. [*] ここは脚注。 
     37}}}</pre> 
     38}}} 
     39 
     40'''結果、このように表示されます:''' 
     41{{{ 
     42#!rst 
     43見出し 
     44------ 
     45脚注 [*]_ 付きの **text** です。 
     46 
     47.. [*] ここは脚注。 
     48}}} 
     49(訳注: !ReStructuredText は国際化が甘いので、使えないかもしれません) 
     50---- 
     51'''例3''' (''Wiki テキストに C 言語ソースコードブロックを挿入する''): 
     52 
     53{{{ 
     54#!html 
     55<pre class="wiki">{{{ 
     56#!c 
     57int main(int argc, char *argv[]) 
     58{ 
     59  printf("Hello World\n"); 
     60  return 0; 
     61} 
     62}}}</pre> 
     63}}} 
     64 
     65'''結果、このように表示されます:''' 
     66{{{ 
     67#!c 
     68int main(int argc, char *argv[]) 
     69{ 
     70  printf("Hello World\n"); 
     71  return 0; 
     72} 
     73}}} 
     74 
     75---- 
     76 
     77== 利用可能なプロセッサ == 
     78以下のプロセッサが Trac の配布に含まれています: 
     79 * '''html''' -- Wiki ページにカスタム HTML を挿入する。 WikiHtml を参照してください。 
     80 * '''rst''' -- Restructured テキスト を Trac でサポートする。 WikiRestructuredText を参照してください。 
     81 * '''textile''' -- [http://dealmeida.net/projects/textile/ Textile] がインストールされていれば、サポートされます。 
     82 
     83=== ソースコードの強調表示サポート === 
     84Trac では、以下のプログラミング言語でのインライン [wiki:TracSyntaxColoring syntax ハイライト] を行うプロセッサを内蔵しています。 
     85 * '''c''' -- C 
     86 * '''cpp''' -- C++ 
     87 * '''python''' -- Python 
     88 * '''perl''' -- Perl 
     89 * '''ruby''' -- Ruby 
     90 * '''php''' -- PHP 
     91 * '''asp''' --- ASP 
     92 * '''sql''' -- SQL 
     93 * '''xml''' -- XML 
     94'''Note:''' ''Trac はシンタックスの色付けを、外部のソフトウェアパッケージに依存しています。詳しくは TracSyntaxColoring をご覧下さい。'' 
     95 
     96プロセッサとして mime-type が指定されると、ソースコードをブラウズするときと同じく、サポートされている言語であれば、シンタックスハイライトを行うことができます。例えば、以下のように書くと: 
     97{{{ 
     98{{{ 
     99#!text/html 
     100<h1>text</h1> 
     101}}} 
     102}}} 
     103 
     104この結果はシンタックスハイライトされた HTML コードになります。サポートされている全ての mime-type でも、これは同じく有効です。 
     105 
     106 
     107ユーザによるプロセッサマクロの開発やコントリビュート: 
     108 * [http://projects.edgewall.com/trac/wiki/ProcessorBazaar ProcessorBazaar] 
     109 * [http://projects.edgewall.com/trac/wiki/MacroBazaar MacroBazaar] 
     110 
     111 
     112== 上級トピック: プロセッサマクロを開発する == 
     113プロセッサの開発は WikiMacros と違いはありません。事実、これらは同じような機能を持ち、シンタックスだけが異なります。詳しくは WikiMacros に記述します。 
     114 
     115'''例:''' (''Restructured テキストプロセッサ''): 
     116{{{ 
     117from docutils.core import publish_string 
     118 
     119def execute(hdf, text, env): 
     120    html = publish_string(text, writer_name = 'html') 
     121    return html[html.find('<body>')+6:html.find('</body>')].strip() 
     122}}} 
     123 
     124---- 
     125See also: WikiMacros, WikiHtml, WikiRestructuredText, TracSyntaxColoring, WikiFormatting, TracGuide