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 ?

Example

Example - Page 5

• 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:

  ./configure
  make
  make install
  

  − 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):

  $wgFileExtensions[] = 'djvu';
  $wgDjvuDump = "djvudump";
  $wgDjvuRenderer = "ddjvu";
  $wgDjvuTxt = "djvutxt";
  $wgDjvuPostProcessor = "pnmtojpeg";
  $wgDjvuOutputExtension = 'jpg';
  

• For better thumbnails quality:

  $wgDjvuPostProcessor = "ppmtojpeg -quality=100";
  

• Can also use png thumbnails with

$wgDjvuPostProcessor = "pnmtopng";
$wgDjvuOutputExtension = 'png';

How to install on Win32

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):

   $wgFileExtensions[] = 'djvu';
   $wgDjvuDump = 'C:/DjVuLibre/djvudump.exe';
   $wgDjvuRenderer = 'C:/DjVuLibre/ddjvu.exe';
   $wgDjvuTxt = 'C:/DjVuLibre/djvutxt.exe';
   #$wgDjvuPostProcessor = 'pnmtojpeg.exe';
   $wgDjvuOutputExtension = 'jpg';
   

NOTES:

• 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.

   brew install djvulibre netpbm
   

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:

  $rel = substr( $url, strlen( $thumbBase ) + 1 ); // plus one for slash

  by

  $rel = urldecode(substr( $url, strlen( $thumbBase ) + 1 )); // plus one for slash

Other page

• Extension:Proofread Page
• Extension:PdfHandler
• Extension:PagedTiffHandler

See also

• Creating a DjVu file

English  • français