Extension:PagedTiffHandler/fr

Manuel des extensions MediaWiki

PagedTiffHandler État de la version : stable
Implémentation	Média
Description	permet d'afficher les fichiers tiff
Auteur(s)	Hallo Welt! Medienwerkstatt GmbH for Wikimedia Deutschland e. V.
Dernière version	mises à jour continues
Politique de compatibilité	Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
PHP	7.0+
Modifie la base de données	Non
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: parcourir le dépôt (Phabricator · GitHub) relecture Gerrit du code historique Git des validations (commits) Télécharger le tarball source
Paramètres $wgImageMagickIdentifyCommand $wgTiffUseExiv $wgTiffUseTiffinfo $wgTiffTiffinfoCommand $wgTiffIntermediaryScaleStep $wgTiffIdentifyRejectMessages $wgTiffIdentifyBypassMessages $wgTiffIdentifyRejectMessages $wgTiffTiffinfoRejectMessages $wgTiffMaxEmbedFiles $wgTiffMaxMetaSize $wgTiffErrorCacheTTL
Accroches fournies PagedTiffHandlerTiffData PagedTiffHandlerExifData PagedTiffHandlerRenderCommand
Traduire l’extension PagedTiffHandler sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

L'extension PagedTiffHandler vous permet de téléverser et d'afficher des fichiers tiff sur votre wiki. Elle peut gérer des images sur plusieurs pages et en faire le rendu en vignettes par page.

Utilisation

Vous pouvez inclure des images en utilisant la syntaxe habituelle des images. De plus il y a deux nouveaux paramètres :

Paramètre	Exemple	Fonction
page	[[Image:Test.tiff|page=2]]	Génère une vignette pour la seconde page de test.tiff. Les numéros de page commencent à 1. (par défaut : 1).
lossy	[[Image:Test.tiff|lossy=false]]	Si la valeur est false, les vignettes seront générées en tant que png, sinon en tant que jpg. Si aucune valeur n'est définie, PagedTiffHandler détermine la valeur basée sur l'existence d'un canal alpha. Si le canal alpha existe, la vignette est rendue en png. Les valeurs possibles pour jpg sont : 1, true, lossy. Les valeurs possibles pour png sont : 0, false, lossless. Exemples : Rendu comme png; lossy=false Rendu comme jpg; lossy=true

Prérequis

Nécessaires

Paquet	Description	Lien
"imagemagick" pour identify	Réalise le redimensionnement dynamique des images et la génération des vignette	www.imagemagick.org

Entrez ceci d'abord dans votre shell pour vérifier que les éléments ci-dessus sont installés :

which identify

Optionnels

Paquet	Description	Lien
"exiv2" pour exiv2	Exiv2 est une bibliothèque C++ multi plateforme et un utilitaire en mode ligne de commande pour gérer les métadonnées des images. Fournit le support pour recupérer le EXIF des fichiers TIFF.	www.exiv2.org
"libtiff-tools" pour tiffinfo	Identifier et récupérer les métadonnées de base de TIFF (plus efficace que ImageMagick)	www.simplesystems.org/libtiff/

Entrez ceci d'abord dans votre shell pour vérifier que les éléments ci-dessus sont installés :

which exiv2 tiffinfo

Pour obtenir des performances supplémentaires sur les très gros fichiers TIFF, vous pouvez installer et configurer l'extension VipsScaler .

Installation

• Téléchargez et placez le(s) fichier(s) dans un répertoire appelé PagedTiffHandler dans votre dossier extensions/.
  Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PagedTiffHandler
  

• Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :

  wfLoadExtension( 'PagedTiffHandler' );
  

• Configurez si nécessaire.
• Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

PagedTiffHandler dépend de divers programmes externes pour traiter les images Tiff.

• ImageMagick est utilisé pour rejeter ou accepter l'image et générer les images des vignettes. PagedTiffHandler ne fonctionne pas sur les images téléversées localement sans ImageMagick.
• tiffinfo peut être utilisé pour rejeter ou accepter l'image au lieu de ImageMagick, mais il ne génère pas les vignettes (optionnel).
• Exiv2 est utilisé pour extraire les métadonnées de l'image (optionnel)
• l'extension VipsScaler peut être utilisée pour le traitement rapide des gros fichiers d'images (optionnel).

Exemple de configuration :

// Chemin de identify
$wgImageMagickIdentifyCommand = '/usr/bin/identify';
// Utiliser exiv2? si la valeur est false, l'analyseur syntaxique interne EXIF de MediaWiki sera utilisé
$wgTiffUseExiv = false;
// Chemin de exiv2 (option de configuration du noyau MediaWiki)
$wgExiv2Command = '/usr/bin/exiv2';
// Utiliser tiffinfo? si la valeur est false, la commande identify de ImageMagick sera utilisée
$wgTiffUseTiffinfo = false;
// Chemin de tiffinfo
$wgTiffTiffinfoCommand = '/usr/bin/tiffinfo';

Lors de la génération de très petites vignettes à partir d'images très grandes, il est préférable de réduire d'abord ces dernières à des tailles intermédiaires, plutôt que de les redimensionner dans le traitement. Par défaut PagedTiffHandler va d'abord réduire à $wgTiffIntermediaryScaleStep la taille des images plus grandes que $wgTiffIntermediaryScaleStep (par défaut 2048 pixels en largeur) avant même de passer à des dimensions plus petites.

Exemple de configuration :

// Les vignettes dont la taille est inférieure sont d'abord redimensionnées à cette valeur.
// Mettre 0 pour désactiver
$wgTiffIntermediaryScaleStep = 2048;

PagedTiffHandler rejette les images basées sur les messages d'erreur ImageMagick ou tiffinfo. Il existe trois options :

• Les images sont rejetées si le message d'erreur est $wgTiffIdentifyRejectMessages ou $wgTiffTiffinfoRejectMessages
• Les images sont acceptées sans problème si le message d'erreur est $wgTiffIdentifyBypassMessages ou $wgTiffTiffinfoBypassMessages
• Dans les autres cas, les images sont acceptées mais le message d'erreur est enregistré dans les métadonnées de l'image.

Exemple de configuration (tous les paramètres sont à leur valeur par défaut)

$wgTiffIdentifyRejectMessages = [
	'/^identify: Compression algorithm does not support random access/',
	'/^identify: Old-style LZW codes, convert file/',
	'/^identify: Sorry, requested compression method is not configured/',
	'/^identify: ThunderDecode: Not enough data at scanline/',
	'/^identify: .+?: Read error on strip/',
	'/^identify: .+?: Can not read TIFF directory/',
	'/^identify: Not a TIFF/',
];

$wgTiffIdentifyBypassMessages = [
	'/^identify: .*TIFFReadDirectory/',
	'/^identify: .+?: unknown field with tag .+? encountered/'
];

PagedTiffHandler vérifie également quelques paramètres de l'image afin de pouvoir contrôler le temps nécessaire au traitement.

Exemple de configuration :

// Nombre maximum de fichiers inclus dans l'image tiff
$wgTiffMaxEmbedFiles = 10000;
// Taille maximale des métadonnées
$wgTiffMaxMetaSize = 64*1024; // 64kB

Lorsque la génération de la vignette échoue pour une image donnée, PagedTiffHandler n'essayera pas de regénérer cette image pendant un certain temps. Les déclarations ci-dessous concernent le délai après lequel les vignettes sont de nouveau à générer.

Exemple de configuration :

// TTL de Cacheentries pour les erreurs
$wgTiffErrorCacheTTL = 84600;

Valeurs par défaut

Tous les paramètres que nous avons décrits ci-dessus sont initialisés par défaut dans la configuration de l'extension.

Voir aussi

• Extension:PdfHandler