Software/Mediasyntax

Mediasyntax is a plugin for Dokuwiki that enables Mediawiki syntax. It comes with a converter dokuwiki to mediawiki syntax.

Install it

• Log in as Administrator to your dokuwiki
• Choose Admin -> Extension Manager -> Manual install
• Under "install from URL" enter

http://www.staerk.de/files/mediasyntax.tar.gz

and click on "Install".

Doesn't work? Read this!

Symptom If you get a message The plugin manager was unable to decompress the downloaded file. like this: Reason 1 PHP's zlib module is not installed Solution 1 Install PHP's zlib modules and restart the web server, e.g. with SUSE Linux 11.4: yast -i php5-zlib /etc/init.d/apache2 restart Reason 2 When trying to unpack, apache cannot overwrite mediasyntax' files because they have another user than apache. Solution 2 Change the ownership of mediasyntax' folder, e.g. for SUSE Linux like this: /srv/www/htdocs/dokuwiki-2011-05-25a/lib/plugins # chown -R wwwrun:www mediasyntax/

Optional

• To use tables in mediawiki syntax, install the exttab2 plugin.
• If you want the "edit" buttons to be above and not below the section to edit, install the editsections plugin.
• Test your installation by writing a new article starting with '''hello world'''. This should be displayed bold.
• Use the converter at mediasyntax/tools/dokuwiki2mediawiki.php to convert your existing pages.
• To get mediawiki's style, install the monobook skin
• Change your dokuwiki's editing help (wiki:syntax) to look like this

Syntax and usage

After installation, mediawiki syntax is used to display your pages. This also includes the #REDIRECT command.

Tables

Tables stay in the dokuwiki syntax because the mediawiki syntax does not allow for simple tables. If you really want mediawiki-style tables, use the exttab2 plugin.

Demo

Here is a demo.

Compatibility

It is tested with Dokuwiki 2009-12-25, 2010-11-07, 2011-05-25, 2011-11-10, 2012-01-25, 2013-05-10 and 2014-05-05.

Developer's information

The mediasyntax plugin is derived from the cool creole plugin, combined with the goto plugin, which is now the redirect component. To download mediasyntax' latest development code, open a Linux console and type

git clone git://github.com/tstaerk/mediasyntax.git

You can also view the code online.

You can start developing mediasyntax.

See also

• mediasyntax on dokuwiki.org
• how to make dokuwiki a good mediawiki