Manual:Extending wiki markup/ja

MediaWikiは簡単にカスタマイズできる標準的なマークアップテキストを提供します. 小規模と大規模の両方のカスタマイゼーションが可能です:


 * 標準的なトークンタイプを追加する: MediaWikiのマークアップをカスタマイズする標準的な方法は組み込みのMediaWikiのXMLタグやテンプレート、もしくはリンクマークアップの )のような新しいマークアップをを追加することです.
 * カスタムトークンタイプを追加する: エクステンションの中には新しいトークンタイプを定義するものがあります. 例えば、Extension:ParserPhase2は次のようなトークンタイプを追加します: 、 、と
 * パーサへの根本的な変更: わずかなエクステンションが標準的なwikiマークアップの代わりに他のある程度のwikiからのマークアップとコンテントマネジメントが使用できるように(使用しなければならないように？)パーシング戦略を根本的に変更することを試みています.

標準的なトークタイプに追加する
 パーサ関数エクステンション: パーサ関数エクステンションはパラメータ化したテンプレート処理を拡張して、典型的には次のようなものになります. "テンプレート名"が使用できますが、上記の例のように、カスタムエクステンションは常に # を伴う関数名で始まります. 他のパーサ関数名はMediaWikiコアが使用するために確保されます. When はパーサ関数として実装され、通常のテンプレート記事の代わりにテンプレートパラメータをPHP関数に渡します. この関数はパラメータ化したテンプレートを置き換えるwikiテキスト]]の文字列を返します. パーサ機能は通常のテンプレートライティングテクニックを使うことが複雑過ぎるもしくは混乱を招くロジックを含むwikiテキスト生成を取り扱うために使用されます.  変数エクステンション: 変数エクステンションはパラメータのないテンプレート処理を拡張します. 通常の記事のトランスクルージョンの代わりに、 はそれを置き換えるwikiテキストを返すPHP関数に関連付けされます. それらは通常システム情報をwikiマークアップに差し込むために使用されます(例えば、現在の時刻、現在のページなど).  XMLマークアップエクステンション: XMLマークアップエクステンション(タグエクステンションとしても知られます)はwikiテキストのカスタムのXMLスタイルタグを定義します:  some text  タグ間のテキストはタグの内容を解析してタグとテキストを置き換えるHTML文字列を返すPHP関数に渡されます. タグ内部の内容はwikiマークアップ、ストレートなテキスト、タグに特有の整形ルールを伴うテキストかもしれません. エクステンションの実装者次第です. 個別のエクステンションのドキュメントを確認して下さるようお願いします. リンクマークアップエクステンション: リンクマークアップエクステンションはMediaWikiが内部リンクを解釈する方法を変更します、すなわち、 ... 形式のwikiマークアップです.  

新しいトークンタイプを追加する
新しいトークンタイプを追加するもしくは全体のマークアップ戦略を変更するために、実装者は新しい関数を一つかそれ以上の様々なパーサとページ出力フックに追加する必要があります:

 Category:ParserBeforeStrip extensions ParserBeforeStripフックに依存します.  Category:ParserAfterStrip extensions ParserAfterStripフックに依存します. </li> Category:ParserBeforeInternalParse extensions ParserBeforeInternalParseフックに依存します. </li> Category:OutputPageBeforeHTML extensions OutputPageBeforeHTMLフックに依存します. </li> Category:ParserBeforeTidy extensions ParserBeforeTidyフックに依存します. </li> Category:ParserAfterTidy extensions ParserAfterTidyフックに依存します. </li> </ul>

関連項目

 * Manual:Extensions/ja - エクステンションの探し方、インストール. 書き方についての一般的な手引きです.