Manual:Extending wiki markup/ja

From MediaWiki.org

< Manual:Extending wiki markup

Jump to: navigation, search

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

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

[edit] 標準的なトークタイプに追加する

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