Extension:ZWIMaker

The ZWIMaker extension exports MediaWiki articles to the ZWI file format used by the Encyclosphere project of the Knowledge Standards Foundation. It allows downloading ZWI files, as well as for a direct submission to the Encyclosphere network.

After the installation, you will see the button "ZWI export" (in the Timeless skin, it is located on the top-right side above the edit area). MediaWiki version 1.37 is fully supported. Version 1.34, 1.35 has a limited support (ZWI files will not include previous revisions of articles).

Download
Go to the MediaWiki install directory, and then go to the directory "extensions".

You will see the directory "ZWIMaker". Then you should make sure that the web server can write into the directory "ZWIMaker/tmp". If you run Apache under Linux, make sure the owner and group is "www-data".

Configuration
The extension requires several parameters. Add these lines at the bottom of LocalSettings.php of your MediaWiki configuration file:

You will see an additional button "ZWI export" above the edit area (this depends on the MediaWiki skin).


 * - ZWI file will be  downloaded (it will not be submitted to the Encyclosphere network).
 * - the ZWI file will be submitted to the Encyclosphere network. Note only the authors who contributed to the text of this article can submit it to the Encyclosphere. Also you need to be properly registered and login on this MediaWiki. In addition, you will need to specify the password that will allow to submit the article to the network. The password can be obtained from the KSF.
 * - the article will be created in the directory "extensions/ZWIMaker/tmp/" without any further actions. It will be removed after new request.

The option 2 should never be used for public MediaWiki installations. This option is only useful for publishers who want to create ZWI files locally. One can trigger ZWI file creation using "wget". For example, this command:

If  is set to false, any user (after login) can submit an article to Encyclosphere. If this parameter is set to true, only authors (contributors) can do the submission.

Image configuration
This ZWI builder works only if you configure MediaWiki such that all images are cached inside the "/thumb/". If you do not do this, only images that have been uploaded to MediaWiki will be included. Any external images from Wikimedia Commons will be ignored. In order to include external images, please add these lines to "LocalSettings.php ":