Extension:PandocUltimateConverter

MediaWiki extensions manual

PandocUltimateConverter Release status: experimental
Implementation	Special page
Description	Pandoc converter extension for mediawiki which imports not only text, but also images
Author(s)	Urfiner (Nikolai Kochkin)
Latest version	0.1.0
MediaWiki	1.39+
License	MIT License
Download	GitHub: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net .

The PandocUltimateConverter is an extension for MediaWiki that converts document files (.docx, .odt) and other files to wikitext. It imports not only text but also images. It is highly inspired by Microsoft's PandocUpload extension but written from scratch to support 1.41 MediaWiki and include image import.

You can see demo here.

Installation

Installation is just a bit more complicated than usual:

1. Install pandoc
2. Download extension
3. Load the extension in LocalSettings.php wfLoadExtension( 'PandocUltimateConverter' );
4. (Optional) Configure path to pandoc binary $wgPandocExecutablePath = 'C:\Program Files\Pandoc\pandoc.exe';. It will work without this param if pandoc is in PATH.
5. (Optional) Configure path to a temp folder where pandoc will store images before upload $wgPandocTmpFolderPath = 'D:\_TMP';. If not specified, it will try to use defualt system temp folder.
6. Allow additional file extensions to be uploaded to MediaWiki

   $wgFileExtensions[] = 'docx';
   $wgFileExtensions[] = 'odt';
   // You can specify other required extensions as well
   

7. Enable uploads if they are not enabled

   $wgEnableUploads = true;
   

Usage

Follow these steps:

1. Go to Special:PandocUltimateConverter page.
   
2. Specify file to convert and target page name.
3. After the file conversion is finished, you will be redirected to the target page
   • Source file will be automatically removed from the wiki
   • All the images will be automatically uploaded to MediaWiki with a name "Pandocultimateconverter-{guid}-{imageOriginalNameAndExtension}"
   • If the image is already present on wiki, the image duplicate will not be uploaded. We will just use the existing image.
   • All the images will be automatically removed from the temp folder

Target page and all the images will be overwriten if they already exist

Limitations

Consider the following limitations:

1. The extension was tested on Windows and Linux.
2. The extension was tested on MediaWiki 1.39, 1.40, 1.41.
3. The list of supported formats can be found on the Pandoc website. For example, it supports docx and odt formats, but does not support pdf format.

See also

• Extension:FlexForm - convert using pandoc