Extension:PagedTiffHandler/cs

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

PagedTiffHandler Stav rozšíření: stabilní
Implementace	Média
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
Parametry $wgImageMagickIdentifyCommand $wgTiffUseExiv $wgTiffUseTiffinfo $wgTiffTiffinfoCommand $wgTiffIntermediaryScaleStep $wgTiffIdentifyRejectMessages $wgTiffIdentifyBypassMessages $wgTiffIdentifyRejectMessages $wgTiffTiffinfoRejectMessages $wgTiffMaxEmbedFiles $wgTiffMaxMetaSize $wgTiffErrorCacheTTL
Poskytované háčky (hooks) PagedTiffHandlerTiffData PagedTiffHandlerExifData PagedTiffHandlerRenderCommand
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
Přeložte rozšíření PagedTiffHandler, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření PagedTiffHandler umožňuje nahrávat a zobrazovat soubory TIFF do vaší 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:

Parametr	Příklad	Funkce
page	[[Image:Test.tiff|page=2]]	Zobrazí miniaturu druhé stránky souboru test.tiff. Čísla stránek začínají číslicí 1. Výchozí hodnota je $1.
lossy	[[Image:Test.tiff|lossy=false]]	Pokud je nastaveno na false, miniatury se vykreslují jako png, jinak jako jpg. Pokud není nastavena žádná hodnota, PagedTiffHandler určuje hodnotu na základě přítomnosti alfa kanálu. S alfa kanálem se miniatura vykreslí jako png. Možné hodnoty pro jpg jsou: 1, true, lossy. Možné hodnoty pro png jsou: 0, false, lossless. Příklady: Zobrazeno jako png; lossy=false Zobazeno jako jpg; lossy=true

Předpoklady

Povinné

Balík	Popis	Odkaz
"imagemagick" pro identifikaci	Provádí dynamické změny velikosti a miniatury obrázků	www.imagemagick.org

Abyste nejprve zjistili, zda máte výše uvedené nainstalované, zadejte do svého shellu následující příkaz:

which identify

Povinné (volitelně)

Balík	Popis	Odkaz
"exiv2" pro exiv2	Exiv2 je multiplatformní knihovna C++ a nástroj příkazového řádku pro správu metadat obrázků. Poskytuje podporu pro načtení EXIF ​​ze souborů TIFF.	www.exiv2.org
"libtiff-tools" pro tiffinfo	Identifikace a načtení základních metadat TIFF (efektivnější než ImageMagick)	www.simplesystems.org/libtiff/

Abyste nejprve zjistili, zda máte výše uvedené nainstalované, zadejte do svého shellu následující příkaz:

which exiv2 tiffinfo

Pro zvýšení výkonu při práci s velmi velkými soubory TIFF můžete chtít nainstalovat a nakonfigurovat rozšíření VipsScaler .

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 závisí na různých externích programech pro zpracování obrázků TIFF.

• ImageMagick se používá k odmítnutí/přijetí obrázku a vykreslení miniatur. PagedTiffHandler nebude fungovat na žádném lokálně nahraném obrázku bez ImageMagick.
• tiffinfo může být použito k odmítnutí/přijetí obrázku místo ImageMagick, ale neposkytuje zobrazení (volitelné).
• Exiv2 se používá k extrakci metadat obrázku (volitelné).
• Rozšíření VipsScaler lze použít pro rychlé zpracování velkých obrazových souborů (volitelné).

Příklad konfigurace:

// Cesta identifikace
$wgImageMagickIdentifyCommand = '/usr/bin/identify';
// Pokud je hodnota false, použijte exiv2?, bude použit interní EXIF ​​parser MediaWiki.
$wgTiffUseExiv = false;
// Cesta k exiv2 (možnost konfigurace jádra MediaWiki)
$wgExiv2Command = '/usr/bin/exiv2';
// Pokud je hodnota false, použijte tiffinfo?, použije se příkaz identify z ImageMagick.
$wgTiffUseTiffinfo = false;
// Cesta k tiffinfo
$wgTiffTiffinfoCommand = '/usr/bin/tiffinfo';

Při zmenšování náhledů velmi velkých obrázků na velmi malé velikosti může být lepší nejprve zmenšit na střední velikost, než měnit velikost najednou. Ve výchozím nastavení PagedTiffHandler zmenší obrázky větší než $wgTiffIntermediaryScaleStep (standardně 2048 pixelů na šířku) nejprve na $wgTiffIntermediaryScaleStep a poté na ještě menší rozměry.

Příklad konfigurace:

// U menších miniatur nejprve upravte velikost na tuto hodnotu.
// Nastavením na 0 zakážete
$wgTiffIntermediaryScaleStep = 2048;

PagedTiffHandler odmítá obrázky na základě chybových hlášení ImageMagick nebo tiffinfo. Existují tři možnosti:

• Obrázky jsou odmítnuty, pokud chybová zpráva odpovídá $wgTiffIdentifyRejectMessages nebo $wgTiffTiffinfoRejectMessages.
• Obrázky jsou přijímány bez reklamací, pokud chybová zpráva odpovídá $wgTiffIdentifyBypassMessages nebo $wgTiffTiffinfoBypassMessages.
• V ostatních případech jsou obrázky akceptovány, ale chybová zpráva je zaznamenána v metadatech obrázku.

Příklad konfigurace (všechny parametry zobrazují výchozí konfiguraci):

$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 také kontroluje několik parametrů obrazu, aby bylo možné řídit potřebnou dobu zpracování.

Příklad konfigurace:

// Maximální počet vložených souborů v obrázku TIFF
$wgTiffMaxEmbedFiles = 10000;
// Maximální velikost metadat
$wgTiffMaxMetaSize = 64*1024; // 64kB

Pokud selže zobrazení miniatur obrázku, PagedTiffHandler se po nějakou dobu nepokusí tento obrázek znovu vykreslit. Níže uvedené nastavení určuje, po kolika sekundách lze náhled znovu zkusit.

Příklad konfigurace:

// TTL položek mezipaměti pro chyby
$wgTiffErrorCacheTTL = 84600;

Výchozí

Všechny výše uvedené parametry jsou v konfiguraci rozšíření nastaveny jako výchozí.

Související odkazy

• Extension:PdfHandler