Extension:ImageMap

From mediawiki.org
This page is a translated version of the page Extension:ImageMap and the translation is 100% complete.
Bu uzantı MediaWiki 1.21 ve üstü ile gelir. Böylece tekrar indirmek zorunda değilsiniz. Ancak, verilen diğer talimatları izlemeniz gerekir.
MediaWiki manüel uzantıları
ImageMap
Sürüm durumu: kararlı
Uygulama Etiket
Açıklama Tıklanabilir HTML resim haritalarına izin verir
Yazar(lar) Tim Starlingmesaj
En son sürüm güncellemeler devam etmekte
MediaWiki 1.23+
PHP 5.4+
Composer mediawiki/image-map
Lisans GNU Genel Kamu Lisansı 2.0 veya üstü
İndir
log
Örnek Children's encyclopedia
Quarterly downloads 96 (Ranked 70th)
Public wikis using 10,714 (Ranked 16th)
Translatewiki.net adresinde mevcutsa, ImageMap uzantısını çevirin
Sorunlar Açık görevler · Hata bildir

ImageMap uzantısı tıklanabilir resim haritalarına izin verir. Bir resim haritası, resminin alanlarını birden çok hedefe köprüleyen belirli bir resimdeki koordinatların bir listesidir (resminin tüm alanının tek bir hedefe bağlandığı normal bir resim bağlantısının aksine). Örneğin, bir dünya haritası, her ülkenin o ülke hakkında daha fazla bilgiye köprülenmiş olabilir. Bir resim haritasının amacı, resmini ayrı resmi dosyalarına bölmeden resminin çeşitli kısımlarını birbirine bağlamanın kolay bir yolunu sağlamaktır.

Örnekler

Başlıksız basit örnek

<imagemap>
File:Example2.png|150px|alt=Alternatif metin
default [[Main Page|Ana sayfaya git]]
</imagemap>
Alternatif metin

Yukarıdaki örnek, nereye tıkladığınız önemli değil, her zaman Main Page sayfasına bağlanır. Resim hakkında daha fazla bilgi edinmek için mavi renkli "i" simgesine tıklayın. Bu uzantıyı kullanmadan böyle bir bağlantılı görüntü oluşturmanın alternatif bir yolu, [[File:Example2.png|150px|alt=Alternatif metin|title=Ana sayfaya git|link=Ana Sayfa]] ile olabilir.

Altyazılı karmaşık örnek

Bu örnek, boyutları (genişlik × yükseklik) 500 × 250 piksel olan bir küçük resim görüntüler; orijinal resim 9,600 × 4,800 piksel boyutlarına sahiptir. Her bir köşenokta koordinatları piksel olarak verilir ve orijinal görüntüdeki bir noktayı temsil eder. Örneğin, "Jude" (resimde en sağdan ikinci) çevreleyen çokgen köşelerinin yatay koordinatları vardır (piksel olarak ölçülür solda) 79048635 ile 20963260 arasında değişen dikey koordinatlar (üstten piksel olarak ölçülür), görüntülenen 500 × 250 küçük resmin aralığının çok dışında, ancak 9.600 × 4.800 orijinal resminin aralığı içindedir. "Simon" (resmin en sağında) çevreleyen çokgenin bir tepe noktasının, özellikle 1 koordinatlı tepe noktasının, orijinal 9.600 × 4.800 resminin sınırlarının dışında olduğuna dikkat edin.

<imagemap>
File:The Last Supper - Leonardo Da Vinci - High Resolution 32x16.jpg|thumb|center|500px|alt=Leonardo da Vinci'nin ''Son Akşam Yemeği'' - Tıklanabilir Resim|Resim haritası örneği. Resimdeki bir kişiye tıklamak, tarayıcının uygun maddeyi yüklemesine neden olur.

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>
Leonardo da Vinci'nin Son Akşam Yemeği - Tıklanabilir ResimBartholomewJames MinorAndrewPeterJudasPeterJohnw:JesusThomasJames GreaterPhilipMatthewJudeSimon
Resim haritası örneği. Resimdeki bir kişiye tıklamak, tarayıcının uygun maddeyi yüklemesine neden olur.

Yukarıdaki örnek, tıkladığınız yere bağlı olarak birçok farklı sayfaya bağlantı verir. Resim hakkında daha fazla bilgi edinmek için çift dikdörtgen simgesine tıklayın.

Sözdizimi açıklaması

‎<imagemap> etiketinin içeriği boş satırlar, yorumlar (# ile başlayan) ve mantıksal satırlardan oluşur.

İlk mantıksal satır, görüntülenecek resmi belirtir. Bu, normal bir MediaWiki resim bağlantısıyla aynı biçimde olmalıdır (resim yardımına bakın), ekteki [[ ve ]] işaretlemesi hariç.

İlk satır bir "thumb" veya "frame" resmi belirtiyorsa, ilk satırın başlığı ve herhangi bir |alt= parametresi, her zamanki gibi resmin başlığı ve alt metni olarak kabul edilir; aksi takdirde, ilk satırın |alt= parametresi (veya yoksa, herhangi bir resim yazısı) resminin alternatif metnini belirtir.

Her iki durumda da resminin kendisinde başlık metni yoktur (genellikle araç ipuçları için kullanılır); herhangi bir başlık metni daha sonraki satırlarda açıklanan bölgelerden alınmıştır.

Diğer satırlar, boşluklarla ayrılmış anahtarlara bölünür. Her satırın işlevi, satırdaki ilk anahtar tarafından belirlenir.

Bir koordinat iki anahtardan oluşur. İlk anahtar yatay (X) konumu ve ikinci anahtar dikey (Y) konumudur. Tüm koordinatlar, görünen resmine değil, tam boyutlu resmine göredir. X ve Y anahtarları, tam boyutlu resminin sol kenarından uzaklık (yatay piksel sayısı) ve üstten uzaklık (dikey piksel sayısı) olarak belirtilmelidir.

desc
Resim açıklamasına bağlanan mavi bir "i" simgesinin konumunu belirtir. Olası değerler: top-right, bottom-right (varsayılan), bottom-left, top-left, none. Bu parametre "thumb" veya "frame" resimleri için yoksayılır, bunun yerine normal çift dikdörtgen simgesi kullanılır.
poly
Bir çokgen. Köşelerin koordinatları verilir ve ardından köşeli parantez içinde bir bağlantı verilir.
rect
Bir dikdörtgen. Parametreler, sol üst ve sağ alt köşelerin koordinatlarıdır ve ardından köşeli parantez içinde bağlanılacak bir başlık gelir.
Örnek
<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
Bir daire. İlk iki parametre merkezin koordinatlarıdır, üçüncüsü yarıçaptır. Koordinatları köşeli parantez içinde bir bağlantı takip eder.
default
Bu, başka hiçbir bölgenin belirtilmediği varsayılan bağlantıyı verir.

Tüm koordinatlar kaynak resmine göre belirlenir. Resim, küçük resim sözdizimi kullanılarak ölçeklenebilir, bu durumda görüntü haritası koordinatları da otomatik olarak ölçeklenir.

Tüm bağlantılar ya [[Sayfa başlığı]] ya da [[Sayfa başlığı|açıklama]] biçiminde verilir. İkinci durumda, "|" borusundan sonraki kısım bağlantının başlık özelliği olur. Çoğu tarayıcıda, kullanıcı üzerine geldiğinde bir araç ipucu olarak açılır; borudan sonraki kısım da bağlantının alternatif metni olur. Açık bir bağlantı açıklaması verilmezse, sayfa başlığı kullanılır.

Örtüşen alanlar, listelenen ilk bağlantıya öncelik verir.

Kurulum

Bu uzantı MediaWiki 1.21 ile birlikte gelir ve üzeridir. Böylece tekrar indirmek zorunda değilsiniz.

Yüklemelerin ve ImageMagick'in kurulu olduğundan emin olun:

$wgEnableUploads = true;
$wgUseImageMagick = true;
$wgImageMagickConvertCommand = "/usr/bin/convert";
  • Dosyaları indirin ve extensions/ klasörünüzdeki ImageMap adlı dizine yerleştirin.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ImageMap
  • LocalSettings.php dosyanızın altına aşağıdaki kodu ekleyin:
    wfLoadExtension( 'ImageMap' );
    
  • Yes Yapıldı – Uzantının başarıyla yüklendiğini doğrulamak için vikinizde Special:Version seçeneğine gidin.
Sorun giderme
  1. Php DOM'nizin açık olup olmadığını kontrol edin. Değilse yüklemeniz gerekebilir.
  2. Bu uzantı yeniden boyutlandırma için /usr/bin/convert üzerinde bağlı olduğundan ImageMagick kurulu olup olmadığını kontrol edin. Mevcut değilse, yalnızca XML hataları olan bir sayfa elde edebilirsiniz (ipucu: sayfayı düzenleyebilmeniz için tarayıcıdaki geri düğmesini kullanın).
  3. OVH karşılıklılaştırılmış barındırmada $wgUseImageMagick şöyle olmalıdır: $wgUseImageMagick=false;

Composer

Bu uzantıyı yerleşik Composer desteğini kullanarak da yükleyebilirsiniz.

composer require mediawiki/image-map @dev
Bu uzantıyı yüklemek için Composer'ı kullanmak, her "composer update --no-dev" komutu yaptığınızda bu uzantının en son geliştirme sürümünün yüklenmesine neden olur.

Şablonlar, sihirli kelimeler veya ayrıştırıcı işlevleriyle kullanım.

Bu uzantının (çoğu etiket uzantısında olduğu gibi) şablon parametrelerini, sihirli kelimeleri veya ayrıştırıcı işlevlerini ayrıştırmasını istiyorsanız, w:Template:Click yaptığı gibi #tag sözdizimi kullanmanız gerekir. Bu durumda dikey çubuk |, şablonun kaynak metninin | olduğu (bağlantılar veya parametreler içinde göründükleri durumlar hariç) bir şablon {{!}} ile değiştirilmelidir.

Örnek - standart form
<imagemap>
File:ExamplePlant80.png|60px|ExamplePlant
rect 0 107 294 260 [[Plants/ExamplePlant|ExamplePlant]]
desc none
</imagemap>
Örnek - {{PAGENAME}} değişkeni ile
{{#tag:imagemap|
File:ExamplePlant80.png{{!}}60px{{!}}ExamplePlant
rect 0 107 294 260 [[{{PAGENAME}}/ExamplePlant|ExamplePlant]]
desc none
}}
Örnek – Resim boyutunu kontrol etmek için bir giriş parametresini kabul edecek şekilde değiştirildi

Bu değişiklikler, şablon boyutunun düzenlenen (hedef) sayfada ayarlanmasına izin verir ve çeşitli resim boyutlarında yinelenen şablonlar oluşturma ihtiyacını ortadan kaldırır.

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

Burada {{{1|640px}}}, "1" giriş parametresidir ve varsayılan resim boyutu 640 pikseldir.

Not: giriş parametresinin düzgün çalışması için "px" ile biten bir metin dizesi gerekir.

Örneğin, {{TemplateName|400px}} şablonunu çağırmak, şablonu 400 pikselde görüntüler.

Standart (mevcut) resim haritalarını bu isteğe bağlı biçime dönüştürmek için:

  • İlk ‎<imagemap> olarak {{#tag:imagemap| ile değiştirin
  • Resim adından sonra {{!}}{{{1|640px}}} ekleyin (varsayılan resim boyutunu mevcut boyutla eşleşecek şekilde değiştirin).
Not: Varsayılan boyutu (bu örnekte 640 piksel) geçerli resim boyutuna değiştirerek, mevcut şablon çağrılarının hiçbirinin değiştirilmesi gerekmeyecek ve doğru şekilde görüntülenecektir. Mevcut şablon çağrıları daha sonra giriş parametresi kullanılarak değiştirilebilir.
  • Son ‎</imagemap> olarak }} (sondaki parantezler) ile değiştirin.

Ayrıca bakınız

Talimatlar
Viki araçları
Çevrimiçi araçlar
Benzer işlevler