|This extension stores its source code on a wiki page. Please be aware that this code may be unreviewed or maliciously altered. They may contain security holes, outdated interfaces that are no longer compatible etc.
request access to MediaWiki's code repository to address this.
||This extension is currently not actively maintained! Meaning any reports for additional features and/or bugfixes will more than likely be ignored. Volunteers are encouraged to take on the task of developing and maintaining it. As a courtesy, you may want to contact the author. You should also remove this template and list yourself as maintaining the extension in the page's
Release status: unmaintained
|Description||Provides ability to use alternate syntax engines (such as Markdown and Textile) instead of the standard wikitext parser.|
|Author(s)||Jim R. Wilson (Jimbojwtalk)|
|Latest version||0.1 (2007-06-03)|
|MediaWiki||1.6.x, 1.9.x, 1.10.x or higher|
|License||The MIT License|
Translate the AlternateSyntaxParser extension if it is available at translatewiki.net
|Check usage and version matrix; code metrics|
This can be done on a page-by-page basis, or by setting a site-wide default.
- Project Homepage
- AlternateSyntaxParser Extension - Jimbojw.com
- Source Code
- AlternateSyntaxParser is released under The MIT License.
Installation[edit | edit source]
- Create a folder in your
$IPis your MediaWiki install dir.
- Download AlternateSyntaxParser, and be sure to rename the downloaded file to
- Drop this script in
- Enable the extension by adding this line to your
require_once('extensions/AlternateSyntaxParser/AlternateSyntaxParser.php'); $wgEnableParserCache = false;
- Download the required libraries for chosen alternate syntaxes as specified below
- Note: If you don't download the libraries, the extension won't work!
If you'd like to specify a site-wide default alternate syntax, set the
$wgAlternateSyntaxParserLanguage global variable to the chosen language in your LocalSettings.php file. For example, to set Markdown as the site-wide default, you'd put:
$wgAlternateSyntaxParserLanguage = 'markdown';
Markdown[edit | edit source]
To support Markdown syntax you must:
- Download Michel Fortin's PHP Markdown or PHP Markdown Extra library (either one):
- Extract the file 'markdown.php' from the zip archive.
- Drop markdown.php into
Textile[edit | edit source]
To support Textile syntax you must:
- Download Textpattern's TextilePHP library:
- Drop classTextile.php into
Usage[edit | edit source]
To use an alternate syntax in a page, if you haven't set a site-wide default, put the following at the top of the page:
Where 'language' is the markup language - examples include 'markdown' and 'textile'.
Below that, add any desired page content in the markup language specified. That's it!
Implementation notes[edit | edit source]
The inspiration for this extension was born out of Simon Dorfman's work on Extension:MarkdownSyntax, which takes a different approach to rendering the content. AlternateSyntaxParser bypasses nearly all of the MediaWiki Parser's steps in order to preserve the alternate language's output, while MarkdownSyntax renders the markup according to Markdown rules prior to MediaWiki's wikitext parsing.
This means that MarkdownSyntax will still be able to use the category, namespace and template systems (among other MediaWiki features), while AlternateSyntaxParser will not. On the other hand, AlternateSyntaxParser does not suffer from syntactical conflicts such as header/section mapping (as described on the MarkdownSyntax extension page).
It is left as an exercise for the user to decide which method is more appropriate for their particular use case.
--Jimbojw 20:33, 3 June 2007 (UTC)
See also[edit | edit source]
See also modified version 5 Fix apr. 2013, MW 1.20 - v 0.1p1 on the Talk page.