バージョン 1 から バージョン 2 における更新: WikiProcessors

差分発生行の前後
無視リスト:
更新日時:
2010/01/20 13:35:09 (15 年 前)
更新者:
trac
コメント:

--

凡例:

変更なし
追加
削除
変更

  • WikiProcessors

    v1 v2  
    1 = Wiki プロセッサ = 
     1= Wiki プロセッサ = #WikiProcessors 
    22 
    3 プロセッサは [TracWiki Trac Wiki エンジン] が、 Wiki 以外のフォーマットを提供するために設計された WikiMacros です。プロセッサは ''ユーザが編集したテキストを処理するマクロ機能'' と考えることができます。 
     3プロセッサは [WikiMacros Wiki マクロ] の一種です。 [TracWiki Trac Wiki エンジン] 以外のマークアップフォーマットを使用するために設計されています。プロセッサは ''ユーザが編集したテキストを処理するマクロ機能'' と考えることができます。 
    44 
    5 Trac 内の全ての Wiki テキストにおいて、 [wiki:WikiRestructuredText Restructured Text], [wiki:WikiHtml raw HTML] および [http://www.textism.com/tools/textile/ textile] をプロセッサとして使用することができます。 
     5Trac 内の全ての Wiki テキストにおいて、 Wiki エンジンにプロセッサを使わせることによって [wiki:WikiRestructuredText Restructured Text], [wiki:WikiHtml raw HTML] および [http://www.textism.com/tools/textile/ textile] を使用することができます。 
    66 
    7 == プロセッサを使用する == 
     7 
     8== プロセッサを使用する == #UsingProcessors 
    89 
    910テキストブロックでプロセッサを使うには、 Wiki のコードブロックを使用し、プロセッサの名前を (Unix 系 OS のスクリプトのように) ''shebang 行'' (#!) に続いて指定します。 
    1011 
    11 '''例1''' (''Wiki テキストに 生 HTML を挿入する''): 
     12'''例1''' (''Wiki テキストに raw HTML を挿入する''): 
    1213 
    1314{{{ 
    … …  
    1516<pre class="wiki">{{{ 
    1617#!html 
    17 &lt;h1 style="color: orange"&gt;これは生 HTML です&lt;/h1&gt; 
     18&lt;h1 style="color: orange"&gt;これは raw HTML です&lt;/h1&gt; 
    1819}}}</pre> 
    1920}}} 
    … …  
    2223{{{ 
    2324#!html 
    24 <h1 style="color: orange">これは生 HTML です</h1> 
     25<h1 style="color: orange">これは raw HTML です</h1> 
    2526}}} 
     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). 
    2629 
    2730---- 
    … …  
    5053.. [*] ここは脚注。 
    5154}}} 
    52 (訳注: !ReStructuredText は国際化が甘いので、使えないかもしれません) 
    5355---- 
    5456'''例3''' (''Wiki テキストに C 言語ソースコードブロックを挿入する''): 
    … …  
    7880---- 
    7981 
    80 == プロセッサ一覧 == 
     82== プロセッサ一覧 == #AvailableProcessors 
    8183以下のプロセッサが Trac の配布に含まれています: 
    8284 * '''html''' -- Wiki ページにカスタム HTML を挿入する。 WikiHtml を参照してください。 
     85 * '''div''' -- Wiki ページの内容を任意の <div> 要素でラップする (''0.11 以降'')。 WikiHtml を参照してください。 
     86 * '''span''' -- Wiki ページの内容を任意の <span> 要素でラップする (''0.11 以降'')。 WikiHtml を参照してください。 
    8387 * '''rst''' -- Restructured テキスト を Trac で利用可能にする。 WikiRestructuredText を参照してください。 
    84  * '''textile''' -- [http://dealmeida.net/projects/textile/ Textile] をインストールすれば利用可能です。 [http://hobix.com/textile/ a Textile reference] を参照。 
     88 * '''textile''' -- [http://cheeseshop.python.org/pypi/textile Textile] をインストールすれば利用可能です。 [http://www.textism.com/tools/textile/ Textile リファレンス] を参照してください。 
     89 * '''comment''' -- セクション内のテキストを処理しません。(セクションの内容はレンダリングされた Wiki ページには出力されず、プレーンテキストにのみ保持されます。) 
    8590 
    86 上記の Textile のリンクは切れています。 [http://www.textism.com/tools/textile/ このサイト] は動いていて、試しに使ってみることが可能です。 
    87  
    88 === ソースコードの強調表示対応 === 
     91=== ソースコードの強調表示対応 === #CodeHighlightingSupport 
    8992Trac では、以下のプログラミング言語でのインライン [wiki:TracSyntaxColoring シンタックスハイライト] を行うプロセッサが組み込まれています。 
    9093 * '''c''' -- C 
    … …  
    9497 * '''ruby''' -- Ruby 
    9598 * '''php''' -- PHP 
    96  * '''asp''' --- ASP 
     99 * '''asp''' -- ASP 
     100 * '''java''' -- Java 
     101 * '''js''' -- Javascript 
    97102 * '''sql''' -- SQL 
    98103 * '''xml''' -- XML 
     104 * '''sh''' -- Bourne/Bash shell 
     105 
    99106'''Note:''' ''Trac はシンタックスの色付けを、外部のソフトウェアパッケージに依存しています。詳しくは TracSyntaxColoring をご覧下さい。'' 
    100107 
    … …  
    107114}}} 
    108115 
    109 この結果はシンタックスハイライトされた HTML コードになります。対応している全ての mime-type でも、これは同じく有効です。 
     116この結果はシンタックスハイライトされた HTML コードになります: 
     117{{{ 
     118#!text/html 
     119<h1>text</h1> 
     120}}} 
     121 
     122対応している全ての mime-type でも、これは同じく有効です。 
    110123 
    111124 
    … …  
    113126 * [http://trac.edgewall.org/wiki/ProcessorBazaar ProcessorBazaar] 
    114127 * [http://trac.edgewall.org/wiki/MacroBazaar MacroBazaar] 
     128 * [http://trac-hacks.org/ Trac Hacks] コミュニティサイト 
    115129 
    116130 
    117 == 上級トピック: プロセッサマクロを開発する == 
    118 プロセッサの開発は WikiMacros と違いはありません。事実、これらは同じような機能を持ち、シンタックスだけが異なります。詳しくは WikiMacros に記述します。 
     131== 上級トピック: プロセッサマクロを開発する == #AdvancedTopics:DevelopingProcessorMacros 
     132プロセッサの開発は Wiki マクロと違いはありません。事実、これらは同じような機能を持ち、シンタックスだけが異なります。詳しくは WikiMacros を参照してください。 
    119133 
    120 '''例:''' (''Restructured テキストプロセッサ''): 
    121 {{{ 
    122 #!python 
    123 from docutils.core import publish_string 
    124  
    125 def execute(hdf, text, env): 
    126     html = publish_string(text, writer_name = 'html') 
    127     return html[html.find('<body>')+6:html.find('</body>')].strip() 
    128 }}} 
    129134 
    130135----