Difference between revisions of "Software/Mediasyntax"

From ThorstensHome
Jump to: navigation, search
(Syntax and usage)
(images behave normally now)
 
(5 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
<metadesc>Mediasyntax is a plugin for dokuwiki that enables mediawiki syntax. It comes with a converter.</metadesc>
 
Mediasyntax is a plugin for [http://www.dokuwiki.org/dokuwiki Dokuwiki] that enables [[Help:Contents|Mediawiki syntax]]. It comes with a converter dokuwiki to mediawiki syntax.
 
Mediasyntax is a plugin for [http://www.dokuwiki.org/dokuwiki Dokuwiki] that enables [[Help:Contents|Mediawiki syntax]]. It comes with a converter dokuwiki to mediawiki syntax.
  
 
= Install it =
 
= Install it =
 
* Log in as Administrator to your dokuwiki
 
* Log in as Administrator to your dokuwiki
* Choose Admin->Manage Plugins
+
* Choose Admin -> Extension Manager -> Manual install
* Under "Download and install a new plugin" enter
+
* Under "install from URL" enter
 
  http://www.staerk.de/files/mediasyntax.tar.gz
 
  http://www.staerk.de/files/mediasyntax.tar.gz
and click on "Download".
+
and click on "Install".
  
 
{| class="collapsible collapsed wikitable" id="collapsibleTable"  
 
{| class="collapsible collapsed wikitable" id="collapsibleTable"  
Line 38: Line 39:
  
 
== Optional ==
 
== Optional ==
* To use tables in mediawiki syntax, install the [http://www.dokuwiki.org/plugin:exttab1 exttab1 plugin].
+
* To use tables in mediawiki syntax, install the [https://www.dokuwiki.org/plugin:exttab2 exttab2 plugin].
 
* If you want the "edit" buttons to be ''above'' and not ''below'' the section to edit, install the [http://www.dokuwiki.org/plugin:editsections#dokuwiki-2009-12-25 editsections plugin].
 
* If you want the "edit" buttons to be ''above'' and not ''below'' the section to edit, install the [http://www.dokuwiki.org/plugin:editsections#dokuwiki-2009-12-25 editsections plugin].
 
* Test your installation by writing a new article starting with <nowiki>'''hello world'''</nowiki>. This should be displayed bold.
 
* Test your installation by writing a new article starting with <nowiki>'''hello world'''</nowiki>. This should be displayed bold.
Line 49: Line 50:
  
 
== Tables ==
 
== Tables ==
Tables stay in the dokuwiki syntax because the mediawiki syntax does not allow for simple 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 [https://www.dokuwiki.org/plugin:exttab2 exttab2 plugin].
 
+
== Images ==
+
Images: To add an image, store your image (let's assume it is called myimage.png) into the image folder (e.g. /srv/www/htdocs/dokuwiki/data/media/image). To show it use the syntax
+
<pre>
+
[[Image:myimage.png]]
+
</pre>
+
  
 
== Demo ==
 
== Demo ==
Line 61: Line 56:
  
 
= Compatibility =
 
= Compatibility =
It is tested with Dokuwiki 2009-12-25, 2010-11-07, 2011-05-25, 2011-11-10, 2012-01-25 and 2013-05-10.
+
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 =
 
= Developer's information =

Latest revision as of 08:48, 25 April 2015

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

Contents

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".

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