• NAME
• SYNOPSIS
• DESCRIPTION
• Supported features
• Unsupported features
• Unsupportable features
• Additional features
• INSTALLATION
• AUTHOR
• LICENSE
• AVAILABILTY

NAME

media.py - A MediaWiki parser plugin for MoinMoin

SYNOPSIS

  #format media

  ==MediaWiki level 1 header==
  * Bullet without indentation
  ** On level two - as MediaWiki likes

DESCRIPTION

media.py is a parser plugin for MoinMoin. It can parse a subset of MediaWiki syntax and use it for MoinMoin.

Supported features

Currently a substantial subset of MediaWiki is supported. These constructs are recognized:

  MediaWiki syntax      Meaning                         Notes

  ''x''                 Italics
  '''x'''               Bold
  '''''x'''''           VeryStrong
  <sup>x</sup>          Superscript text
  <sub>x</sub>          Subscript text
  <small>x</small>      Small text
  <u>x</u>              Underline
  <tt>x</tt>            Preformatted embedded text
  <i>x</i>              Italics
  <b>x</b>              Bold
  &x;                   HTML entities
  <br>                  Breaking paragraphs

  ----                  Divider

  http://x              External Link
  [http://x]            External Link                   [5]
  [http://x y]          External Link with text

  [[x]]                 Link                            [1]
  [[x|y]]               Link with text                  [1]
  [[#Anchor]]           Setting an anchor in a page

  ==x==                 Header level 1
  ===x===               Header level 2
  ...
  * x                   Bullet list level 1
  ** x                  Bullet list level 2
  ...
  # x                   Numbered list level 1
  ## x                  Numbered list level 2
  ...
  *#*                   Mixed lists
  : x                   Indented paragraph level 1
  :: x                  Indented paragraph level 2
  ...
  ;x:y                  Definition level 1
  ;;x:y                 Definition level 2              [2]
  ...
  <pre>x</pre>          Preformatted uninterpreted text
  <nowiki>x</nowiki>    Uninterpreted text              [3]

  <!-- x -->            Comments                        [4]

[1]

These restrictions currently apply:

Stuff in parentheses is not hidden from display.
Namespaces are not hidden. Instead they are transformed to top level MoinMoin pages (the most natural mapping of namespaces).
Interwiki and language linking MediaWiki is not really supported well.
Special namespace Special: is not supported. Such links map to a macro in MoinMoin.
Dates. Done by a macro in MoinMoin.

These adaptions are made:

The User: namespace is dropped silently to map the MediaWiki logic into MoinMoin logic.
Special namespaces Image: and Media: used to embed pictures or to attach arbitrary data are mapped to the attachment: for MoinMoin so they are effectively mapped to the attachment feature of MoinMoin.
The Talk: namespace is mapped to a sub page /Talk.
Namespace operation is currently supported for English and German.

[2]

This is probably an extension to MediaWiki original syntax.

[3]

<nowiki> is handled the same as <pre>. I.e. the whitespace structure is kept.

[4]

Comments are only recognized if they appear on a single physical line.

[5]

The missing link text is not replaced by an automatically generated number.

Each non-discussion page gets an automatic link to its discussion page.

Unsupported features

These things are not yet supported:

  MediaWiki syntax      Meaning

  <center>x</center>    Centered text
  ISBN x                Link to a book by its ISBN
  RFC x                 Link to an RFC
  <strike>x</strike>    Stroke text
  <math>x</math>        TeX markup
   x                    Preformatted text line

Moreover these features are not yet supported:

• Tables
  
• HTML
  
• MediaWiki templates
  

If you are really missing a feature please check

  http://en.wiki.oekonux.org/OekonuxWiki/Help/MediaWikiFAQ/FeatureRequests

Feel free to add your feature request there.

Unsupportable features

The following things are beyond a parser because they are replaced while processing an edit of before displaying a page actually. While editing the MoinMoin counterparts must be used:

  MediaWiki syntax      MoinMoin syntax         Meaning

  ~~~                   @USERNAME@              Insert user name
  ~~~~                  @SIG@                   Insert user name and current time
  #REDIRECT [[x]]       #REDIRECT x             Page redirection

Additional features

The following things are inherited from MoinMoin and can be used:

  MoinMoin syntax       Meaning                         Notes

  [[macro(arguments)]]  Macros present in MoinMoin      [1]
  someone@example.com   Mail addresses

[1]

You must use parentheses even if there are no arguments. Otherwise macro syntax would conflict with page names.

INSTALLATION

See

        http://moinmoin.wikiwikiweb.de/ParserMarket#head-17c33967bbb4345a453627b944bad1f1bc4b2791

AUTHOR

Stefan Merten <smerten@oekonux.de>

LICENSE

This program is licensed under the terms of the GPL. See

        http://www.gnu.org/licenses/gpl.txt

AVAILABILTY

See

        http://www.merten-home.de/FreeSoftware/media4moin/

``''``