Manuel:Comment utiliser DjVu avec MediaWiki

Redirigé de DjVu . Cette page explique comment MediaWiki fonctionne avec DjVu. Pour les pages d'aide sur la manière de créer un fichier DjVu à partir d'un PDF, voir Créer un fichier DjVu.

Fonctionnement

Exemple

Exemple - Page 5

• Manuel:$wgDjvuDump — Chemin de l'exécutable djvudump.
• Manuel:$wgDjvuOutputExtension — Extension de fichier pour les sorties du post processeur DjVu.
• Manuel:$wgDjvuPostProcessor — Chemin du post-processeur DjVu.
• Manuel:$wgDjvuRenderer — Chemin du moteur de rendu ddjvu DjVu.
• Manuel:$wgDjvuTxt — Chemin de l'exécutable djvutxt.

Installer sous GNU/Linux

Pour MediaWiki-Docker , exécutez la commande suivante pour installer tous les paquets nécessaires.

docker compose exec -u 0 mediawiki bash -c 'apt update && apt install djvulibre-bin netpbm'

• Installer DjVuLibre :

  − Télécharger le paquet DjVuLibre (qui contient les fichiers djvudump et ddjvu). Et dans le chemin :

  ./configure
  make
  make install
  

  − Ou utiliser aptitude ou Synaptic dans les dérivés Debian (paquet djvulibre-bin)

• Installer les paquets netpbm et netpbm-progs (utiliser aptitude ou Synaptic dans les dérivés Debian)
• Enfin, ajoutez (ou modifiez) les lignes de code ci-dessous du fichier LocalSettings.php (et non pas dans DefaultSettings.php) :

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

• Pour une meilleure qualité des vignettes :

  $wgDjvuPostProcessor = "ppmtojpeg -quality=100";
  

• Vous pouvez également utiliser les vignettes png avec :

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

Installer sous Win32

1. Télécharger le logiciel DjVuLibre (qui contient les fichiers djvudump.exe et ddjvu.exe).
2. Installer dans C:\DjVuLibre (par exemple).
3. Télécharger le paquet complet NetPbm (qui contient les fichiers pnmtojpeg.exe, pnmtopng.exe, ...).
4. Installer dans C:\GnuWin32\NetPbm
5. Ajouter C:\GnuWin32\NetPbm\bin à la variable environnement Windows PATH (et redémarrer l'ordinateur).
6. Enfin, ajouter (ou modifier) les lignes de code ci-dessous dans le fichier LocalSettings.php (et non pas dans DefaultSettings.php) :

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

PHP a besoin de mémoire pour créer les vignettes : cela signifie une grande valeur pour memory_limit (~ 128Mo) dans php.ini.

Installer sous OS X

1. Installer djvu et netpbm en utilisant le gestionnaire de paquets Homebrew.

   brew install djvulibre netpbm
   

2. Suivre la dernière étape de l'installation sous GNU/Linux

A faire ensuite

• Comment installer DjVuLibre, Qt et netpbm sur un serveur.

Problèmes et solutions

• Si vous obtenez le message “Error creating thumbnail: terminate called after throwing an instance of 'DJVU::GException' ppmtojpeg: EOF / read error reading magic number” lorsque vous affichez un fichier, augmentez $wgMaxShellMemory .
• Under $wgDjvuOutputExtension = 'jpg' you can force pictures to PNG format with a client-side script. Utile partout où vous ne contrôlez pas les paramètres de MediaWiki.

Autres pages

• Extension:Proofread_Page
• Extension:PdfHandler
• Extension:PagedTiffHandler

Voir aussi

• Créer un fichier DjVu