Extension:AlternateSyntaxParser/ja

AlternateSyntaxParser 拡張機能は、標準のウィキテキスト パーサーの代わりに、別の構文エンジン (Markdown、Textile など) を使用できるようにします.

これは、ページ単位で設定することも、またはサイト全体の既定として設定することもできます.


 * プロジェクトのホームページ: AlternateSyntaxParser 拡張機能 - Jimbojw.com
 * ソース コード: AlternateSyntaxParser.php
 * ライセンス: AlternateSyntaxParser is released under MIT ライセンス.

インストール
require_once('extensions/AlternateSyntaxParser/AlternateSyntaxParser.php'); $wgEnableParserCache = false;
 * 1) Create a folder in your   directory called.
 * Note:  is your MediaWiki install dir.
 * 1) Download AlternateSyntaxParser, and be sure to rename the downloaded file to.
 * 2) Drop this script in
 * 3) Enable the extension by adding this line to your  :
 * 1) Download the required libraries for chosen alternate syntaxes as specified below
 * ''Note: If you don't download the libraries, the extension won't work!

構成 (任意)

サイト全体の既定の代替構文として指定したい場合、LocalSettings.php ファイルでグローバル変数  にその言語を設定します. 例えば、サイト全体の既定として Markdown を指定するには、以下のコードを追加します: $wgAlternateSyntaxParserLanguage = 'markdown';

Markdown
To support Markdown syntax you must:
 * 1) Download Michel Fortin's PHP Markdown or PHP Markdown Extra library (either one):
 * http://www.michelf.com/projects/php-markdown/
 * 1) Extract the file 'markdown.php' from the zip archive.
 * 2) Drop markdown.php into

Textile
To support Textile syntax you must:
 * 1) Download Textpattern's TextilePHP library:
 * https://code.google.com/p/textpattern/source/browse/releases/4.3.0/source/textpattern/lib/classTextile.php
 * 1) Drop classTextile.php into

使用法
サイト全体の既定として設定していない場合に、特定のページで代替構文を使用するには、そのページの上部に以下のコードを追加します:


 * 1) MARKUP language

'language' はマークアップ言語の例です - 例えば 'markdown' と 'textile' が含まれます.

以下の注記のように、指定したマークアップ言語で好きなページ内容を追加してください. 以上です!

実装の注記
この拡張機能の発想は Simon Dorfman の Extension:MarkdownSyntax での成果から生まれました. この拡張機能はコンテンツをレンダリングする別のアプローチを取っています. AlternateSyntaxParser は代替言語の出力を保存するために MediaWiki パーサーのステップのほぼすべてを回避します. 一方で MarkdownSyntax が MediaWiki のウィキテキストの構文解析よりも 先に Markdown の構文規則に従ってマークアップをレンダリングします.

このことは MarkdownSyntax が、カテゴリ、リンク、(異なる MediaWiki 機能の間で) テンプレート システムを使用できる一方で AlternateSyntaxParser はそうではないことを意味します. 対してヘッダーや節の対応といったことに関して AlternateSyntaxParser は構文の衝突に悩みません (MarkdownSyntax 拡張機能のページに説明されています).

特定の用途に対してどちらの手法がより適切かは、利用される方の練習問題とします.

--Jimbojw 20:33, 3 June 2007 (UTC)

関連ページ
See also modified version 5 Fix apr. 2013, MW 1.20 - v 0.1p1 on the Talk page.