DokuWiki Syntax

Last modified by Michael Hamann on 2024/04/29 00:01

cogDokuWiki Syntax Parser
TypeJAR
CategorySyntax
Developed by

Thomas Mortagne, Shubham Jain, Neha Gupta, Michael Hamann

Active Installs20
Rating
0 Votes
LicenseGNU Lesser General Public License 2.1
Compatibility

Due to a breaking change in XWiki 16.2.0, versions prior to 3.0 don't work with XWiki versions >= 16.2.0 and versions >= 3.0 of this extension cannot be installed on XWiki < 16.2.0.

Installable with the Extension Manager

Description

This is DokuWiki Syntax rendering parser. It supports full DokuWiki syntax, except for extensions, column/row span in tables (see DOKUWIKI-43) and embedding of video and audio files (see DOKUWIKI-42). For DokuWiki syntax reference guide please review: https://www.dokuwiki.org/wiki:syntax

Although it's original created for the DokuWiki importer extension, this extension can be used by other extensions to parse DokuWiki pages. It uses XWiki's rendering API, and generates generic output, which can be used to convert to any output filter, including XWiki's own syntax.

PHP and HTML content

Even though support for PHP and HTML content has been removed in DokuWiki, this parser still supports them. HTML content is converted to the HTML macro. DokuWiki <2.0 PHP content is converted to the PHP macro.DokuWiki 2.0+ As executing PHP code is not the default in DokuWiki, was never recommended, and the PHP code from DokuWiki most likely won't work in XWiki, PHP content is converted to the code macro and thus displayed verbatim without being executed. If PHP was used for scripting in pages and the scripts shall be used in XWiki, it is recommended to convert the PHP code to Velocity which has much better support in XWiki than PHP.

 

Prerequisites & Installation Instructions

We recommend using the Extension Manager to install this extension (Make sure that the text "Installable with the Extension Manager" is displayed at the top right location on this page to know if this extension can be installed with the Extension Manager).

You can also use the manual method which involves dropping the JAR file and all its dependencies into the WEB-INF/lib folder and restarting XWiki.

Dependencies

Dependencies for this extension (org.xwiki.contrib.dokuwiki:dokuwiki-syntax 3.0):

Get Connected