Příručka k rozšířením MediaWiki

PagedTiffHandler Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace	MédiaCategory:Media handling extensions/cs
Popis	Umožňuje zobrazit soubory TIFF
Autoři	Hallo Welt! Medienwerkstatt GmbH for Wikimedia Deutschland e. V.
Nejnovější verze	průběžné aktualizace
Zásady kompatibility	Vydání snímků současně s MediaWiki. Hlavní vývojová větev není zpětně kompatibilní.
PHP	7.0+
Změny v databázi	Ne
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball Category:Extensions in Wikimedia version control/cs
Parametry $wgImageMagickIdentifyCommand $wgTiffUseExiv $wgTiffUseTiffinfo $wgTiffTiffinfoCommand $wgTiffIntermediaryScaleStep $wgTiffIdentifyRejectMessages $wgTiffIdentifyBypassMessages $wgTiffIdentifyRejectMessages $wgTiffTiffinfoRejectMessages $wgTiffMaxEmbedFiles $wgTiffMaxMetaSize $wgTiffErrorCacheTTL
Poskytované háčky (hooks) PagedTiffHandlerTiffData PagedTiffHandlerExifData PagedTiffHandlerRenderCommand
Čtvrtletní stahování	8 (Ranked 88th)
Veřejné wiki používající rozšíření	922 (Ranked 261st)
Přeložte rozšíření PagedTiffHandler, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

The PagedTiffHandler extension allows to upload and display tiff-files into your wiki. Dokáže zpracovat vícestránkové obrázky a vykreslit je do miniatur na stránce.

Použití

Obrázky můžete vkládat pomocí standardní syntaxe obrázků. Navíc jsou zde dva nové parametry:

Předpoklady

which identify

which exiv2 tiffinfo

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného PagedTiffHandler ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PagedTiffHandler
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'PagedTiffHandler' );
  

• Nakonfigurujte podle potřeby.
• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Nastavení

PagedTiffHandler depends on various external programs in order to process Tiff images.

• ImageMagick is used to reject/accept the image and render thumbail images. PagedTiffHandler will not work on any locally uploaded image without ImageMagick.
• tiffinfo can be used to reject/accept the image instead of ImageMagick, but it does not provide rendering (optional).
• Exiv2 is used to extract image metadata (optional).
• VipsScaler extension can be used for fast processing of large image files (optional).

Example configuration:

// Path to identify
$wgImageMagickIdentifyCommand = '/usr/bin/identify';
// Use exiv2? if false, MediaWiki's internal EXIF parser will be used
$wgTiffUseExiv = false;
// Path to exiv2 (MediaWiki core configuration option)
$wgExiv2Command = '/usr/bin/exiv2';
// Use tiffinfo? if false, ImageMagick's identify command will be used
$wgTiffUseTiffinfo = false;
// Path to tiffinfo
$wgTiffTiffinfoCommand = '/usr/bin/tiffinfo';

When thumbnailing very large images to very small sizes, it can be better better to downscale to an intermediary size first, instead of resizing in one go. By default PagedTiffHandler will downsize images larger than $wgTiffIntermediaryScaleStep (2048 pixels wide by default) first to $wgTiffIntermediaryScaleStep before downsizing to even smaller dimensions.

Example configuration:

// For thumbnails smaller than this, first scale to this amount
// Set to 0 to disable
$wgTiffIntermediaryScaleStep = 2048;

PagedTiffHandler rejects images based on error messages of ImageMagick or tiffinfo. There are three options:

• Images are rejected if the error message matches $wgTiffIdentifyRejectMessages or $wgTiffTiffinfoRejectMessages
• Images are accepted without moaning if the error message matches $wgTiffIdentifyBypassMessages or $wgTiffTiffinfoBypassMessages
• In other cases, images are accepted but the error message is recorded in the image metadata.

Example configuration (all of the parameters show the default configuration):

$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 also checks a few parameters of the image in order to be able to control the necessary processing time.

Example configuration:

// Maximum number of embedded files in tiff image
$wgTiffMaxEmbedFiles = 10000;
// Maximum size of meta data
$wgTiffMaxMetaSize = 64*1024; // 64kB

When thumbnailing fails for an image, PagedTiffHandler will not try again to render this image for some time. The setting below controls after how many seconds thumbnailing may be tried again.

Example configuration:

// TTL of Cacheentries for Errors
$wgTiffErrorCacheTTL = 84600;

Defaults

All of the above shown parameters are set as default in the configuration of the extension.

See also

• Extension:PdfHandler

Toto rozšíření se používá na jednom nebo více projektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborech CommonSettings.php a InitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wiki Special:Version.

Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: Miraheze Category:Extensions included in Miraheze/cs WikiForgeCategory:Extensions included in WikiForge/cs Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček.