A MediaWiki extension to DocBook from wiki pages
#Installation
For installation of this extension you need to have ssh access to your server.
- To install the extension, place the entire 'DocBookExport' directory within your MediaWiki 'extensions' directory
- Just enter the following command in the 'extensions' directory: 'git clone https://bitbucket.org/wikiworksdev/docbookexport.git DocBookExport'
- Add the following line to your LocalSettings.php file: 'wfLoadExtension( 'DocBookExport' );'
- Verify you have this extension installed by visiting the /Special:Version page on your wiki.
#Install Dependencies
- Install pandoc.
- See https://github.com/jgm/pandoc/releases for the latest version
- For Ubuntu use the following commands, replace the version number as per the latest release.
- sudo wget https://github.com/jgm/pandoc/releases/download/2.0.5/pandoc-2.0.5-1-amd64.deb
- sudo dpkg -i pandoc-2.0.5-1-amd64.deb
- Configure $wgDocBookExportPandocPath to your Pandoc path in case the "pandoc" command doesn't work
- Install extension Figures - It supports defining figures in MediaWiki
- To download DocBook files in Zip format install the ZipArchive php extension.
- To download DocBook in PDF format install the xsltproc and fop
#Usage To create a book define the page structure using the docbook parser function or tag extension. See examples below.
Parser Function Example:
{{#docbook:
page structure=
- Buying clothes intro,Buying shoes (title=Buying the right clothes, header=Custom Header)
** How I buy shoes
|title=My Guide to Bowling
|cover page=Cover Contents
|header=My Guide to Bowling
|footer=My Guide to Bowling
|index term categories=index terms
|index terms=shoe,clothes
}}
#Credits This extension has been written by Nischay Nahata for wikiworks.com and is sponsored by NATO