Following Jim Wilson’s comment I have revisted this subject and now offer my own extension which adds Textile2 to the AlternateSyntaxParser without the need for hacking Jim’s original extension.

You can download the extension here.

Instructions are included in the source, but for convenience, they are repeated here…

Installation:

1. Install the AlternateSyntaxParser extension.
2. Drop this script (AlternateSyntaxParserTextile2.php) into $IP/extensions/AlternateSyntaxParser

1. Enable the extension by adding this line to your LocalSettings.php:

1. Download the Textile2 library
2. Extract the file classTextile.php from the downloaded archive.

1. Drop classTextile.php into $IP/extensions/AlternateSyntaxParser/

Usage:

To use Textile2 in a page, put #MARKUP textile2 at the top of the page:

Alternatively, you may specify a site-wide default alternate language by setting the $wgAlternateSyntaxParserLanguage variable in your LocalSettings.php.

MediaWiki is used extensively for documentation sites simply because it has so many features that make it ideal for this type of wiki application. The primary example is, of course Wikipedia

Naturally, I want to use MediaWiki for my own documentation sites. However, I use Textile – a lightweight, humane web text generator almost exclusively wherever HTML markup would otherwise be used. Also, I have to admit that I find the built-in MediaWiki markup verbose, ugly and counter-intuitive.

So, I was pleased to find a well written and documented MediaWiki extension which provides for alternative parsers, including textile. For some reason, the standard extension does not work on my sites. What I describe here is a simple mechanism to replace the TextilePHP parser with the Textile2 parser.

Step One

Install the MediaWiki AlternativeSyntaxParser extension. Test it and if it works for you you’re done!

Step 2

If the basic installation does not work, or if you want to try Textile2, add the following lines to AlternativeSyntaxParser.php at about line #153

 case 'textile2':
    require_once('classTextile.php');
    $textile = new Textile();
    $text = $textile->TextileThis($parser->mSwappedOutText);
    break;

Step Three

Download the Textile2 source from here& and copy the file classTextile.php to the same directory where the alternative parsers are.

Step Four

Actually, you’re done! You now have another alternative parser ‘textile2’ available.

Once you have installed this, the editor buttons are no longer useful… maybe I’ll integrate TheEditorHelper unless someone else gets it done first.