Manual:Extending wiki markup/ja

From MediaWiki.org
Jump to navigation Jump to search

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

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

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

  • パーサー関数拡張機能: パーサー関数拡張機能はパラメータ化したテンプレート処理を拡張して、典型的には次のようなものになります {{#funcname ...}}。"テンプレート名"が使用できますが、上記の例のように、カスタム拡張機能は常に#を伴う関数名で始まります。他のパーサー関数名はMediaWikiコアが使用するために確保されます。

    When {{#funcname ...}}はパーサー関数として実装され、通常のテンプレート記事の代わりにテンプレートパラメータをPHP関数に渡します。この関数はパラメータ化したテンプレートを置き換えるウィキテキスト]]の文字列を返します。パーサー機能は通常のテンプレートライティングテクニックを使うことが複雑過ぎるまたは混乱を招くロジックを含むウィキテキスト生成を取り扱うために使用されます。

  • 変数拡張機能: 変数拡張機能はパラメータのないテンプレート処理を拡張します。

    通常の記事のトランスクルージョンの代わりに、{{XXX}}はそれを置き換えるウィキテキストを返すPHP関数に関連付けされます。それらは通常システム情報をwikiマークアップに差し込むために使用されます(例えば、現在の時刻、現在のページなど)。

  • XMLマークアップ拡張機能: XMLマークアップ拡張機能(タグ拡張機能としても知られます)はウィキテキストのカスタムのXMLスタイルタグを定義します:
    <tagname parname="parvalue" ... parname="parvalue"> some text </tagname>
    タグ間のテキストはタグの内容を解析してタグとテキストを置き換える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 __NOTOC__. 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.

新しいトークンタイプを追加する[edit]

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

関連項目[edit]

  • Manual:拡張機能 - 拡張機能の探し方、インストール。書き方についての一般的な手引きです。
言語: English  • Deutsch • 日本語