Jump to content

Extension:ImageMap

From mediawiki.org
This page is a translated version of the page Extension:ImageMap and the translation is 100% complete.
This extension comes with MediaWiki 1.21 and above. To znamená, že jej nemusíte stahovat samostatně. Musíte se nicméně stále řídit pokyny k jeho použití.
Příručka k rozšířením MediaWiki
ImageMap
Stav rozšíření: stabilní
Implementace Značka
Popis Umožňuje klikací HTML obrázkové mapy
Autoři Tim Starlingdiskuse
Nejnovější verze průběžné aktualizace
MediaWiki 1.23+
PHP 5.4+
Composer mediawiki/image-map
Licence GNU General Public License 2.0 nebo novější
Stáhnout
log
Příklad Children's encyclopedia
Čtvrtletní stahování 79 (Ranked 59th)
Veřejné wiki používající rozšíření 10,714 (Ranked 16th)
Přeložte rozšíření ImageMap, používá-li lokalizaci z translatewiki.net
Problémy Otevřené úkoly · Nahlásit chybu

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

<imagemap>
File:Example2.png|150px|alt=Alternativní text
default [[Main Page|Jít na hlavní stránku]]
</imagemap>
Alternativní text

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í [[File:Example2.png|150px|alt=Alternativní text|title=Jít na hlavní stránku|link=Main Page]]

Složitější příklad s popisem

Tento příklad zobrazí miniaturu s rozměry (šířka × výška) 500 × 250 pixelů. Původní obrázek 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í 79048635 a vertikálními souřadnicemi (měřeno v pixelech shora) v rozmezí mezi 20963260, 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í 9625 3301, leží mimo hranice původního obrazu 9 600 × 4 800.

<imagemap>
File:The Last Supper - Leonardo Da Vinci - High Resolution 32x16.jpg|thumb|center|500px|alt='' The Last Supper '' od Leonardo da Vinci - klikněte na obrázek|Příklad mapy obrazu. Kliknutím na osobu na obrázku způsobí, že prohlížeč načte příslušný článek.

poly 550 2550 750 2400 1150 2300 1150 2150 1200 2075 1500 2125 1525 2300 1350 2800 1450 3000 1700 3300 1300 3475 650 3500 550 3300 450 3000 [[w:Bartholomew the Apostle|Bartholomew]] 
poly 1575 2300 1625 2150 1900 2150 1925 2500 1875 2600 1800 2750 1600 3250 1425 3100 1400 2800 1375 2600 [[w:James, son of Alphaeus|James Minor]]
poly 1960 2150 2200 2150 2350 2500 2450 2575 2375 2725 2375 2900 2225 3100 2225 3225 1600 3225 1825 2700 1975 2450 1925 2300 [[w:Saint Andrew|Andrew]]
poly 2450 2575 2775 2500 2700 2650 2800 2700 2600 3000 2600 3250 2300 3250 2200 3200 2300 3000 [[w:Saint Peter|Peter]]
poly 2750 2500 2950 2400 3125 2600 3175 2700 3300 2850 3700 3200 3750 3200 3650 3350 3400 3200 3000 3350 2600 3325 2750 2800 2900 2700 2700 2650 [[w:Judas Iscariot|Judas]]
poly 3000 2350 3300 2350 3350 2660 3560 2600 3565 2690 3250 2800 3125 2575 [[w:Saint Peter|Peter]]                                     
poly 3332 2338 3528 2240 4284 3024 4074 3332 3864 3290 3780 3150 3668 3192 3598 3024 3374 2870 3388 2772 3542 2800 3668 2702 3542 2590 3430 2604 3350 2600 3300 2500[[w:John the Apostle|John]]
poly 4775 2184 4915 2128 5055 2212 5083 2352 5111 2464 5181 2604 5307 2744 5573 3052 5615 3192 5657 3290 5573 3402 5461 3332 5335 3248 4495 3248 4439 3388 4243 3388 4075 3360 4173 3136 4327 3010 4509 2730 4663 2520 4733 2394 [[w:Jesus]]
poly 5900 2100 5900 2150 5800 2400 5800 2500 5675 2589 5480 2671 5438 2507 5425 2301 5589 2452 5630 2301 5650 2100 [[w:Thomas the Apostle|Thomas]]
poly 5918 2150 6041 2109 6137 2246 6192 2411 6110 2589 6110 2726 6192 2822 6302 2740 6589 3109 5658 3178 5575 2918 5300 2698 5233 2589 5274 2438 5370 2507 5521 2685 5617 2671 5712 2575 5822 2507 5808 2287 5822 2175 [[w:James, son of Zebedee|James Greater]]
poly 6137 2013 6439 2013 6863 2260 7110 2515 6726 2675 6507 2548 6425 2630 6356 2753 6548 2849 6699 2781 7082 2794 7178 3109 6699 3178 6548 2986 6397 2835 6165 2775 6110 2589 6233 2438 6302 2383 6151 2287 6096 2164 [[w:Philip the Apostle|Philip]]
poly 7635 2123 7800 2013 8000 2055 8025 2287 7950 2438 8000 2698 8055 2918 7959 3164 7233 3164 7124 2972 7124 2794 6548 2794 6384 2781 6384 2671 6493 2575 6750 2650 7075 2550 7219 2400 7625 2300 [[w:Matthew the Apostle|Matthew]]
poly 8325 2096 8600 2109 8635 2493 8615 2726 8439 2781 8274 2740 8125 2835 8151 2931 8400 2975 8411 3068 8589 3041 8617 3205 7987 3260 8124 3027 7987 2644 7904 2493 7959 2425 8096 2356 [[w:Judas Thaddaeus|Jude]]
poly 8800 2150 8900 2125 9055 2150 9125 2397 9400 2475 9550 2931 9625 3301 9151 3397 8535 3219 8726 3014 8466 3068 8411 2918 8178 2931 8124 2835 8329 2753 8535 2794 8726 2603 8725 2342 [[w:Simon the Zealot|Simon]]
</imagemap>
The Last Supper od Leonardo da Vinci - klikněte na obrázekBartholomewJames MinorAndrewPeterJudasPeterJohnw:JesusThomasJames GreaterPhilipMatthewJudeSimon
Příklad mapy obrazu. Kliknutím na osobu na obrázku způsobí, že prohlížeč načte příslušný článek.

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 ‎<imagemap> 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 "thumb" nebo "frame", 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" , která odkazuje na popis obrázku. Možné hodnoty: top-right, bottom-right (výchozí), bottom-left, top-left, none. Tento parametr je ignorován pro obrázky "thumb" nebo "frame", které místo toho používají obvyklou ikonu s dvojrámečkem .
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
<imagemap>
File:PolierMartinWombwellZoffany.jpg|thumb|200px|Colonel Antoine Polier
rect 269 140 344 305 [[Claude Martin]]
rect 124 147 181 298 [[Antoine Polier|Antoine-Louis Polier]]
desc none
</imagemap>
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ě [[Page title|název stránky]] nebo [[Page title|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

Toto rozšíření je součást MediaWiki 1.21 a vyšší. To znamená, že jej nemusíte stahovat samostatně.

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

$wgEnableUploads = true;
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";
  • Stáhněte soubor/y a vložte je do adresáře pojmenovaného ImageMap 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/ImageMap
  • Na konec vašeho souboru LocalSettings.php přidejte následující kód:
    wfLoadExtension( 'ImageMap' );
    
  • Yes Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.
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 ImageMagick , 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 $wgUseImageMagick, by měl být jako: $wgUseImageMagick=false;

Composer

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

composer require mediawiki/image-map @dev
Použití Composeru k instalaci tohoto rozšíření způsobí instalaci nejnovější verze vývoje tohoto rozšíření pokaždé, když provedete příkaz "composer update --no-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 #tag 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ář
<imagemap>
File:ExamplePlant80.png|60px|ExamplePlant
rect 0 107 294 260 [[Plants/ExamplePlant|ExamplePlant]]
desc none
</imagemap>
Příklad - s proměnnou {{PAGENAME}}
{{#tag:imagemap|
File:ExamplePlant80.png{{!}}60px{{!}}ExamplePlant
rect 0 107 294 260 [[{{PAGENAME}}/ExamplePlant|ExamplePlant]]
desc none
}}
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.

{{#tag:imagemap|
Image:Examplename.jpg {{!}}{{{1|640px}}}
rect 0 107 294 260
circle 360 114 70
poly 357 216 363 417 211
desc none
}}

Kde {{{1|640px}}} 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 {{TemplateName|400px}} 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í ‎<imagemap> na {{#tag:imagemap|
  • Přidejte {{!}}{{{1|640px}}} po názvu obrázku (změní výchozí velikost obrázku tak, aby odpovídala aktuálně existující velikosti).
Poznámka: Změna výchozí velikosti (640 px v tomto příkladu) na aktuální velikost obrázku nebude muset být žádným ze stávajících volání šablony modifikována a bude se správně zobrazovat. Existující volání šablony lze později upravit pomocí vstupního parametru.
  • Nahraďte konečný ‎</imagemap> za }} (koncová složená závorka).

Související odkazy

Instrukce
Wiki nástroje
Online nástroje
Podobné funkce