Manual:How to use DjVu with MediaWiki


 * DjVu redirects here. This page explains how MediaWiki could work with DjVu. For help page on how to create a DjVu file from a PDF, see Creating a DjVu file

How that works ?

 * Manual:$wgDjvuDump - Path of the djvudump executable.
 * Manual:$wgDjvuOutputExtension - File extension for the DJVU post processor output.
 * Manual:$wgDjvuPostProcessor - Path of the DJVU post processor.
 * Manual:$wgDjvuRenderer - Path of the ddjvu DJVU renderer.
 * Manual:$wgDjvuToXML - Path of the djvutoxml executable.
 * Manual:$wgDjvuTxt - Path of the djvutxt executable.

How to install on GNU/Linux

 * Install DjVuLibre :
 * − Download the DjVuLibre package (which includes djvudump and ddjvu files). And, in the path:
 * − Or use aptitude or Synaptic in Debian derivatives (package djvulibre-bin)
 * install netpbm and netpbm-progs packages (use aptitude or Synaptic in Debian derivatives)
 * Finally, add (or modify) the code lines below in the LocalSettings.php file (not in the DefaultSettings.php):
 * For better thumbnails quality:
 * Can also use png thumbnails with

How to install on Win32
NOTES:
 * 1) Download the DjVuLibre software (which includes djvudump.exe and ddjvu.exe files).
 * 2) Install in   (for example).
 * 3) Download the NetPbm complete package (which includes pnmtojpeg.exe, pnmtopng.exe, ... files).
 * 4) Install in "C:\GnuWin32\NetPbm"
 * 5) Add   to the Windows   Environment Variable (and reboot the computer).
 * 6) Finally, add (or modify) the code lines below in the LocalSettings.php file (not in the DefaultSettings.php):
 * PHP needs memory to create thumbnails: this means a high memory_limit (~ 128MB) in the php.ini.

How to install on OS X

 * 1) Install djvu and netpbm using the homebrew package manager.
 * 2) Follow last step of install on GNU/Linux

Next to do

 * How to install DjVuLibre, Qt and netpbm on a server.

Problems and solutions

 * If you got «Error creating thumbnail: terminate called after throwing an instance of 'DJVU::GException' ppmtojpeg: EOF / read error reading magic number» when view file, increase the $wgMaxShellMemory.
 * Thumbnails of DjVu-file with non-Latin name are absent in a namespace Page. If you use extension WebStore in your own wiki, then in file $IP/extensions/WebStore/404-handler.php replace next string:
 * by
 * by

Other page

 * Extension:Proofread Page
 * Extension:PdfHandler
 * Extension:PagedTiffHandler