Manual:How to use DjVu with MediaWiki

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.

How to install on GNU/Linux

 * Install DjVuLibre :
 * − Download the DjVuLibre package (which includes djvudump and ddjvu files). And, in the path :
 * ./configure
 * make
 * make install
 * − Or use Synaptic in Ubuntu
 * If necessary, install QT4 (use Synaptic)
 * install netpbm package (use Synaptic in Ubuntu)
 * Finally, add (or modify) the code lines below in the LocalSettings.php file (not in the DefaultSettings.php):
 * $wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'svg', 'djvu' );
 * $wgDjvuDump = "djvudump";
 * $wgDjvuRenderer = "ddjvu";
 * $wgDjvuPostProcessor = "ppmtojpeg";
 * $wgDjvuOutputExtension = 'jpg';

How to install on Win32
NOTES:
 * 1) Download the DjVuLibre software (which includes djvudump.exe and ddjvu.exe files).
 * 2) Install in "C:\DjVuLibre" (for example).
 * 3) Download the NetPbm complete package (which includes pnmtojpeg.exe, pnmtopng.exe, ... files).
 * 4) Install in "C:\GnuWin32\NetPbm"
 * 5) Add "C:\GnuWin32\NetPbm\bin" to the Windows PATH 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):
 * 7) * $wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg', 'svg', 'djvu' );
 * 8) * $wgDjvuDump = 'C:/DjVuLibre/djvudump.exe';
 * 9) * $wgDjvuRenderer = 'C:/DjVuLibre/ddjvu.exe';
 * 10) * $wgDjvuPostProcessor = 'pnmtojpeg.exe';
 * 11) * $wgDjvuOutputExtension = 'jpg';
 * don't use long paths in the $wgDjvuPostProcessor variable: it returns an Error creating thumbnail when 'C:' or '../' are written in the path.
 * PHP needs memory to create thumbnails: this means a high memory_limit (~ 128MB) in the php.ini.

Next to do

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

Bugs to fix

 * Images don't seem to appear in namespace page :
 * Error creating thumbnail: terminate called after throwing an instance of 'DJVU::GException' ppmtojpeg: EOF / read error reading magic number
 * >>> see the french translation of this page.
 * Error when trying to access to a thumbnail (with onglet image in namespace page)

Other page

 * Extension:Proofread Page
 * Extension:PdfHandler