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マークアップです.  Extended syntax extensions: Extended syntax extensions, mostly Magic Word extensions, add to the list of MediaWiki Magic Words, such as. Usually, a specific PHP function interprets these words, and either replaces them with something, or sets some conditions for later processing during output generation, or both. Most usually, the replacement is the empty string; that is, the Magic Word is deleted, and nothing is shown in its place. Altered processing may involve addition of an extra piece of CSS, or suppression of user preference settings during page generation, and can be almost anything. 

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

 Category:ParserBeforeStrip extensions ParserBeforeStripフックに依存します. </li> 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 - 拡張機能の探し方、インストール. 書き方についての一般的な手引きです.