Jump to content

Příručka:$wgUseInstantCommons

From mediawiki.org
This page is a translated version of the page Manual:$wgUseInstantCommons and the translation is 100% complete.
Sdílená nahrávání: $wgUseInstantCommons
Povoluje InstantCommons , tzn. použití Wikimedia Commons jako sdíleného zdroje
Zavedeno od verze:1.16.0 (r58652)
Odstraněno od verze:stále se používá
Povolené hodnoty:(boolean)
Výchozí hodnota:false

Použití

Pro povolení InstantCommons přidejte do svého LocalSettings.php následující řádek:

$wgUseInstantCommons = true;

Podrobnosti

Nastavení konfiguračního parametru na true povoluje InstantCommons , které umožňuje na místní wiki automaticky používat soubory nahrané na Wikimedia Commons.

Nastavení tohoto konfiguračního parametru je zkratkou pro následující nastavení $wgForeignFileRepos :

$wgForeignFileRepos[] = [
	'class' => ForeignAPIRepo::class,
	'name' => 'wikimediacommons',
	'apibase' => 'https://commons.wikimedia.org/w/api.php',
	'url' => 'https://upload.wikimedia.org/wikipedia/commons',
	'thumbUrl' => 'https://upload.wikimedia.org/wikipedia/commons/thumb',
	'hashLevels' => 2,
	'transformVia404' => true,
	'fetchDescription' => true,
	'descriptionCacheExpiry' => 43200,
	'apiThumbCacheExpiry' => 0,
];

Poznámka

Povolením tohoto konfiguračního parametru nezabráníte žádnému využití místa na disku na serveru, na kterém běží místní wiki. Až do MediaWiki 1.26 toto nastavení skutečně generovalo náhledy na místní disk pro účely ukládání do mezipaměti. V případě, že jsou při vkládání souboru na stránku v místní wiki překročeny rozměry původního souboru na Wikimedia Commons, bude soubor v původní velikosti uložen na místní disk.

Od MediaWiki 1.27 (gerrit:251556), $wgUseInstantCommons automaticky spojuje obrázky z Commons namísto stahování originálů a jejich lokálních miniatur.

To umožňuje wikinám šetřit na CPU a šířce pásma a zároveň zkrátit čas na první bajt pro stránky, a to i bez obslužného programu miniatur. Díky tomu může vaše wiki vypadat mnohem rychlejší.

Pokud máte například na stránce 100 obrázků InstantCommons, vaše wiki odešle 400 požadavků API na Commons API při načítání stránky a první bajt stránky nebude vrácen po dobu asi 30 sekund. To lze poněkud zlepšit deaktivací $wgResponsiveImages . Můžete raději přepsat výchozí descriptionCacheExpiry vytvořením vlastního záznamu $wgForeignFileRepos , nebo možná vůbec nepoužívat úložiště cizích souborů a místo toho zkopírovat obrázky z Commons na svou vlastní wiki pomocí importImages.php . Všimněte si, že proti intuici je apiThumbCacheExpiry nejrychlejší, pokud je nastaveno na 0. Dalším aspektem, který má velký vliv na výkon, je doba ukládání metadat do mezipaměti. Bohužel to v současné době není konfigurovatelné a pevně zakódované na 3600 sekund (1 hodina), což je poměrně krátká doba [1].

Vylepšení najdete v dokumentaci konfiguračního parametru $wgForeignFileRepos.

Související odkazy