Extension:Proofread Page/fr

L'extension Proofread Page (page corrigée) crée un livre :


 * 1) soit en tant que page de texte OCR située en miroir d'un facsimilé image,
 * 2) soit coupé en chapitres ou poèmes. Le contenu d'un document apparaît dans la page MediaWiki par transclusion.

L'extension est conçue pour permettre une comparaison visuelle aisée entre le texte saisi et l'original.

Cette extension permet la lecture du texte de plusieurs manières sans avoir à dupliquer l'original.

Utilisation
L'extension est installée sur toutes les versions linguistiques des Wikisource. Pour la syntaxe, voir s:mul:Wikisource:ProofreadPage (en anglais). Elle est également utilisée sur Bibliowiki.



Exigences et recommandations

 * L'accès à la ligne de commande est requis si le lancement du script de mise à jour (maintenance/update.php) depuis le navigateur web échoue (voir la documentation ici et là).
 * Si vous utilisez des fichiers DjVu (optionnel mais recommandé), un gestionnaire natif de prise en charge des fichiers DjVu sera nécessaire dans la configuration. Voir aussi.
 * De surcroît, l'usage de Proofread Page est beaucoup amélioré par l'utilisation des extensions suivantes :
 * (Fortement recommandé)
 * (le pied de page par défaut contient
 * (peut nécessiter des modules PHP complémentaires) — Ajoute une aide à la gestion des fichiers PDF
 * (Active le CSS spécifique à l'Index)
 * (Active la Bibliothèque Lua de relecture)
 * (Active le CSS spécifique à l'Index)
 * (Active la Bibliothèque Lua de relecture)
 * (Active la Bibliothèque Lua de relecture)

Affichage des vignettes
L'extension pointe directement sur la vignette de l'image, qui souvent n'existe pas. Vous devez trouver les erreurs 404 et générer les vignettes manquantes. Vous pouvez faire cela en utilisant l'une des solutions suivantes :


 * Définissez un RewriteRule Apache dans .htaccess à pour les vignettes manquantes :
 * ou déclarez le gestionnaire Apache 404 comme étant thumb-handler de Wikimedia. Il s'agit d'un gestionnaire 404 générique avec du code spécifique à Wikimedia, et pas simplement un générateur de vignettes.
 * Pour les versions de MediaWiki >= 1.20, vous pouvez simplement rediriger vers thumb_handler.php :
 * Ou en apache2.conf :
 * Pour les versions de MediaWiki >= 1.20, vous pouvez simplement rediriger vers thumb_handler.php :
 * Ou en apache2.conf :
 * Ou en apache2.conf :

Espaces de noms
ProofreadPage crée par défaut deux espaces de noms personnalisés, nommés respectivement « Page » et « Index » en anglais, portant respectivement les IDs 250 et 252.

Leurs noms sont traduits si votre wiki utilise une autre langue. .

Vous pouvez personnaliser leur nom ou leur ID : créez les espaces de noms manuellement et définissez leur ID dans en utilisant la variable globale $wgProofreadPageNamespaceIds. Voici un exemple :

La personnalisation de l’id des espaces de noms n’est pas recommandée et peut ne plus être prise en charge à l’avenir.

Configuration

 * Pour pouvoir utiliser le système d'évaluation des pages, il est nécessaire de créer cinq catégories. Le nom de ces catégories doit être défini dans MediaWiki:Proofreadpage_quality0_category à MediaWiki:Proofreadpage_quality4_category.
 * Assurez-vous que vous avez installé



Configuration des index de noms
Pour plus de détails, voir 
 * Vous devez créer MediaWiki:Proofreadpage_index_template de manière à afficher les pages d'index. Cette page est un modèle qui reçoit en paramètre les valeurs du formulaire de modification.
 * Vous devez créer MediaWiki:Proofreadpage_index_data_config.json qui contient la configuration du format de l'index. Cette nouvelle page de configuration remplace MediaWiki:Proofreadpage_index_attributes et MediaWiki:Proofreadpage_js_attributes.

La configuration est un tableau JSON de propriétés. Voici la structure d'une propriété du tableau, tous les paramètres sont facultatifs, les valeurs par défaut sont utilisées :

Le paramètre  peut avoir les valeurs suivantes : "type", "language", "title", "author", "translator", "illustrator", "editor", "school", "year", "publisher", "place", "progress"



Séparateur de pages
L’extension place un séparateur entre chaque page transcluse et la suivante, définie par. La valeur par défaut est  (une espace). Définissez  pour supprimer le séparateur.



Relier les mots comportant un tiret étalés sur deux pages
Lorsqu’un mot est coupé sur deux pages à l'aide d'un trait d’union, l’extension recolle les deux moitiés du mot. Exemple : his- et toire devient histoire. La caractère de « jointure » est défini par  et, par défaut, est « - » (le caractère trait d’union ASCII).



Configurer le marquage des modifications (facultatif)
Voir Changer le balisage pour configurer les balises de changement.

Utilisation


Créer votre première page (exemple avec DjVu)

 * Avant de suivre ces étapes, assurez-vous que vous avez suivi les instructions du.
 * (quand et dans quel espace e noms a été téléversé le fichier djvu lui-même ?)
 * Créez une page dans l’espace de noms « Page » (ou sa traduction si vous n’utilisez pas un wiki en anglais). Par exemple, si votre espace de noms est 'Page', créez.
 * Créez le fichier commons:File:Carroll - Alice's Adventures in Wonderland.djvu correspondant pour cette page (ou définissez à  ).
 * Créez la page d’index.
 * Insérez la balise dans les champs des Pages pou visualiser la liste des pages.
 * Pour modifier la page 5 du livre, visitez 'Page:Carroll - Alice's Adventures in Wonderland/5' et cliquez sur Modifier.

Syntaxe
L’extension introduit les balises suivantes : ,