Extension:ImageMap/cs

Rozšíření ImageMap umožňuje klikací obrazové mapy. Mapa obrazu je seznam souřadnic v konkrétním obrázku, který hypertextové oblasti obrazu odkazuje do více cílů (na rozdíl od normálního obrazového spojení, ve kterém se celá oblast obrazu odkazuje na jeden cíl). Například mapa světa může mít každou zemi hypertextovou pro další informace o této zemi. Záměrem obrazové mapy je poskytnout snadný způsob propojení různých částí obrázku bez rozdělení obrázku do samostatných obrazových souborů.

Příklady


Jednoduchý příklad, obrázek bez popisu
U výše uvedeného příkladu budete odkázáni na Main Page, bez ohledu na to, na které místo obrázku kliknete. Chcete-li se o obrázku dozvědět víc, klikněte na modrou ikonu "i". Alternativní způsob, jak vytvořit takový obrázek a aktivním odkazem, bez použití tohoto rozšíření je následující



Složitější příklad s popisem
Tento příklad zobrazí miniaturu s rozměry (šířka × výška) 500 × 250 pixelů. má rozměry 9 600 × 4 800 pixelů. Souřadnice každého vrcholu jsou uvedeny v pixelech a představují bod na původním obrázku. Takže například vrcholy polygonu obklopující "Jude" (pohledem napřímo vpravo na obrázku) mají horizontální souřadnice (měřené v pixelech odleva) v rozmezí  –   a vertikálními souřadnicemi (měřeno v pixelech shora) v rozmezí mezi   – , které jsou daleko mimo rozsah zobrazené miniatury 500 × 250, ale v rozmezí původního obrazu 9 600 × 4 800. Všimněte si, že jeden vrchol polygonu obklopujícího "Simon" (vpravo na obrázku), konkrétně vrchol s souřadnicí, leží mimo hranice původního obrazu 9 600 × 4 800.

Výše uvedený příklad odkazuje na mnoho různých stránek v závislosti na tom, kde na něj kliknete. Chcete-li se dozvědět více o obrázku, klikněte na ikonu s dvojrámečkem



Popis syntaxe
Obsah značky se skládá z prázdných řádků, komentářů (počínaje #) a logických řádků.

První logický řádek určuje zobrazený obrázek. To musí být ve stejném formátu jako obyčejný odkaz MediaWiki Image (viz Images Help), s výjimkou bez ohraničení  a.

Pokud první řádek určí obrázek " " nebo " ", pak se titulek prvního řádku a jakýkoli parametr alt považuje za titulek a alt textu obvyklým způsobem. Jinak parametr první řádek alt (nebo, pokud chybí, jakýkoli titulek) určuje text ALT obrázku.

V žádném případě nemá obrázek sám o sobě text titulu (často používaný pro popis). Jakýkoli text titulu je převzat z regionů popsaných v pozdějších řádcích.

Další řádky jsou rozděleny symboly, oddělenými mezerou. Funkce každého řádku je určena prvním symbolem v řádku.

Souřadnice se skládá ze dvou symbolů. Prvním symbolem je horizontální (X) poloha a druhým symbolem je vertikální (Y) poloha. Všechny souřadnice jsou podle obrazu v plné velikosti, nikoli podle viditelného obrázku. Symboly X a Y by měly být specifikovány jako vzdálenost od levého okraje (vodorovný počet pixelů) a vzdálenost od horního okraje (vertikální počet pixelů) obrazu v plné velikosti.


 * desc
 * Určuje umístění modré ikony "i" Desc-i.svg, která odkazuje na popis obrázku. Možné hodnoty:,   (výchozí),  ,  ,  . Tento parametr je ignorován pro obrázky " " nebo " ", které místo toho používají obvyklou ikonu s dvojrámečkem Magnify-clip.png.


 * poly
 * Polygon. Souřadnice vrcholů jsou uvedeny, následuje odkaz v hranatých závorkách.


 * rect
 * Obdélník. Parametry jsou souřadnice levých horních a pravých dolních rohů, následované názvem pro odkaz v hranatých závorkách.
 * Příklad


 * circle
 * Kruh. První dva parametry jsou souřadnice středu, třetím je poloměr. Po souřadnicích následuje odkaz v hranatých závorkách.


 * default
 * To poskytuje výchozí odkaz, kde nejsou zadány žádné jiné regiony.

Všechny souřadnice jsou specifikovány vzhledem ke zdrojovému obrazu. Obrázek lze upravovat pomocí syntaxe miniatury, v takovém případě budou souřadnice mapy obrazu také automaticky upraveny.

Všechny odkazy jsou uvedeny buď ve formě název stránky nebo popis. Ve druhém případě část po svislítku "|" se stává atributem názvu odkazu - ve většině prohlížečů se objeví jako nástroj, když se nad ním uživatel přejede myší. Část po svislítku se také stane alt textem pro odkaz. Pokud není uveden žádný explicitní popis odkazu, použije se název stránky.

Oblasti, které se překrývají, dávají přednost prvnímu uvedenému odkazu.

Instalace
Ujistěte se, že jsou nainstalovány aktualizace a ImageMagick:


 * Odstraňování problémů
 * 1) Zkontrolujte, zda je váš PHP DOM zapnutý. Možná jej budete muset nainstalovat, pokud tomu tak není.
 * 2) Zkontrolujte, zda je nainstalováno, protože toto rozšíření se opírá o /usr/bin/převedení pro změnu. Pokud není přítomno, můžete získat stránku pouze s chybami XML (tip: Použijte zpětné tlačítko v prohlížeči, protože stránku můžete stále upravovat).
 * 3) Na OVH, který má hosting , by měl být jako:

Composer
Toto rozšíření můžete také nainstalovat pomocí vestavěné podpory.

composer require mediawiki/image-map @dev



Použití se šablonami, magickými slovy nebo funkcí analyzátoru
Pokud chcete tímto rozšířením (stejně jako u většiny rozšíření značek) analyzovat parametry šablony, magická slova nebo analyzátorové funkce, budete muset použít  syntaxi, například w:Template:Click. V tomto případě musí být vertikální lišta  nahrazena šablonou , kde je zdrojový text šablony   (s výjimkou případů, kdy se objevují uvnitř odkazů nebo parametrů).


 * Příklad - standardní formulář:


 * Příklad - s proměnnou :


 * Příklad - upraveno tak, aby přijalo vstupní parametr pro řídicí velikost obrazu:

Tyto úpravy umožňují nastavení velikosti šablony na stránce upravené (cíl) a eliminují potřebu vytvořit duplicitní šablony různých velikostí obrazu.

Kde  je vstupní parametr "1" a výchozí velikost obrazu 640 px.

POZNÁMKA: Vstupní parametr vyžaduje, aby textový řetězec končící "px" správně fungoval.

Například volání šablony  zobrazí šablonu na 400 pixelů.

Chcete-li převést standardní (existující) mapy obrázků do tohoto volitelného formátu:
 * Nahraďte počáteční na
 * Add  after the image name (change the default image size to match the currently existing size).
 *  Note: By changing the default size (640px in this example) to the current image size, none of the existing template calls will have to be modified and will display correctly. Existing template calls can still be modified later by using the input parameter. 


 * Replace the final with   (the trailing braces).