Extension:Proofread Page/fr

L'extension Proofread Page affiche chaque image d'un livre numérisé en vis-à-vis d'un texte que l'on peut modifier (comme par exemple le résultat d'une ROC). Le texte peut ensuite être affiché dans d'autres pages correspondant à l'organisation logique du livre (en chapitres par exemple).

Le but de cette extension est de permettre une vérification facile d'un texte à partir des images du livre original et d'utiliser ce texte de plusieurs manières sans avoir à le recopier. D'autres usages sont possibles (transcriptions de manuscripts et traductions par exemple).

Les pages utilisées par cette extension ne sont pas dans l'espace principal et ne sont donc pas comptabilisées dans les statistiques.

Cette extension est utilisée dans l'ensemble des sous-domaines de Wikisource.

Installer Proofread

 * 1) Téléchargez l'extension depuis Git ou téléchargez un instantané correspondant à la version de MediaWiki que vous utilisez, et copiez les fichiers dans le dossier « extensions » de votre wiki (tous les fichiers de l'extension doivent être dans le sous-dossier « extensions/ProofreadPage »).
 * 2) Ajoutez la ligne suivante dans votre fichier LocalSettings.php :
 * 3) Lancez update.php (situé dans le dossier maintenance de votre wiki) ou copiez le contenu de ProofreadPage.sql dans la section sql de phpmyadmin pour créer les tables nécessaires au fonctionnement de l'extension.

Formats DjVu, pdf et autres
Proofread Page peut être utilisé avec différents formats d'images : jpg, png, DjVu, pdf, etc.

Des formats d'image comme jpg et png peuvent être utilisés immédiatement ; en revanche, si vous souhaitez utiliser les formats Djvu et pdf, reportez-vous à Comment utiliser le format DjVu avec MediaWiki et à PdfHandler.

En bref, pour le format DjVu, il suffit d'installer DjVuLibre et netpbm et de configurer le fichier LocalSettings.php. Pour le format pdf, l'installation est similaire, avec ghostscript, pdfinfo et imagemagick, souvent déjà installés sous Gnu/Linux.

Génération des vignettes
Afin de générer des vignettes utilisables par l'extension, ajoutez en bas du ficher apache2.conf la ligne :
 * ErrorDocument 404 /w/thumb_handler.php

L'extension est maintenant installée, et il reste à configurer votre wiki.

Mediawiki 1.19.2
La version de l'extension correspondant à mediawiki 1.19 doit être configurée comme suit :


 * Le modèle MediaWiki:Proofreadpage_index_template vous permettra d'organiser les informations sur un livre (titre, auteur, date de parution, etc.) dans l'index qui lui est consacré. Les champs peuvent être modifiés dans « MediaWiki:Proofreadpage index attributes ».
 * Si vous recopiez le modèle MediaWiki:Proofreadpage_index_template de Wikisource, il faut :
 * installer Extension:ParserFunctions ;
 * Recopier les modèles Modèle:! et Modèle:!-.
 * Afin que les espaces Page et Livre soient correctement pris en charge par MediaWiki, il faut ajouter dans le fichier LocalSettings.php quelque chose du type :
 * Pour changer les noms d'espace utilisés par l'extension (en n'oubliant pas de modifier également les noms ci-dessus) : Mediawiki:Proofreadpage_namespace et Mediawiki:Proofreadpage_index_namespace.
 * Pour les notes, l'extension ajoute automatiquement une balise

Mediawiki 1.21alpha
Pour les dernières versions de l'extension, la configuration est simplifiée :
 * les espaces de nom sont créés par l'exention ; « Page » et « Livre » ont par défaut les identifiants 250 et 252 et il n'y a rien à faire de plus. En revanche, si vous mettez à jour l'extension et que ces données par défaut ne correspondent pas à votre configuration, vous pouvez faire des ajustements dans LocalSettings.php :
 * la configuration des couleurs dans Commons.css n'est plus nécessaire ;
 * des images de commons peuvent être utilisées grâce à $wgUseInstantCommons, ce qui est valable pour des formats comme .jpg, mais les fichiers djvu ne fonctionneront pas directement.

Problèmes rencontrés

 * Aucune vignette n'est créée, d'où :
 * les images ne s'affichent pas dans l'espace page.
 * les images ne s'affichent pas quand on clique sur l'onglet image de l'espace page.
 * Solution : vérifiez le chemin du fichier thumb_handler.php dans la configuration d'apache.
 * vérifiez que php5-curl est installé.


 * Les vignettes ne sont pas créées et l'accès aux images est interdit :
 * Solution : relancez apache.


 * Message d'erreur : « Error creating thumbnail: terminate called after throwing an instance of 'DJVU::GException' ppmtojpeg: EOF / read error reading magic number »
 * Solution : ajoutez $wgMaxShellMemory dans votre fichier localsettings, avec une valeur suffisante, par exemple : $wgMaxShellMemory = 202400; Vérifiez également que le paramètre memory_limit dans votre fichier php.ini possède une valeur suffisante (128)


 * Message d'erreur : « Fatal error: Call to undefined function curl_init »
 * Solution : installez php5-curl


 * La coloration des liens ne fonctionne pas.
 * Solution : Vérifiez que votre css contient la configuration :
 * /* ProofreadPage */
 * .quality4 { background-color: #90ff90; }
 * .quality3 { background-color: #ffe867; }
 * .quality2 { background-color: #b0b0ff; }
 * .quality1 { background-color: #ffa0a0; }
 * .quality0 { background-color: #ddd; }

Utiliser DjVu et pdf

 * Comment utiliser le format DjVu avec MediaWiki
 * PdfHandler

Documentations

 * Documentation de Wikisource.

Autres

 * Quelques statistiques concernant Wikisource