The "MediaWiki API" module is designed to provide the core
functionality to allow Drupal modules to integrate with a MediaWiki
sever via the MediaWiki
API. It does not provide any significant end user functionality to
Drupal but is intended to support modules that do.
Currently the "MediaWiki API Filter" module is the only module
packaged with "MediaWiki API" and dependent on it. If you have it
enabled see here for
more information.
Alternatives
There are alternative ways to filter MediaWiki syntax in Drupal:
- http://drupal.org/project/mediawiki - Wraps the MediaWiki PHP
directly so benefits from the full MediaWiki syntax but the downside is
that this module therefore tightly coupled with the MedaiWiki release
it was developed against and may not work with the most recent
MediaWiki release. At the time of writing this is in need of some
maintenance and an upgrade to Drupal 6.0.
- http://drupal.org/project/pearwiki_filter - Uses the PEAR if
they want a simple alternative the parses a subset of the MediaWiki
syntax. The upside of using this module is that there is no need to
download the entire MediaWiki code base. the downside is that the PEAR
modules it relies on do not seem to have been maintained for some time
and worse of all the MediaWiki code that has been released does not
contain all the bug fixes that are available in the development code
repository.
- This module. Using this module has some advantages:
- There is no tight coupling with the MediaWiki codebase, all
re-use of MediaWiki code is done via the API.
- Notwithstanding any major changes to the MediaWiki API it
should be easy to use this module with future releases of MediaWiki
and therefore the latest MediaWiki sytax
- You get to use the full MediaWiki syntax, including any
install extensions
TODO
- Provide additional functions from the API to Drupal
- Prevent MediaWiki inserting "edit" links
- Provide an option to prevent MediaWiki inserting a table of contents
- Provide overrides for links [[Link]] images [image:] to be handled by Drupal
See also
API reference: http://www.mediawiki.org/wiki/API
MediaWiki Syntax reference: http://www.mediawiki.org/wiki/Help:Formatting
MediaWiki extensions: http://www.mediawiki.org/wiki/Category:Extensions