Help:Images/cs

Tato stránka vysvětluje syntaxi obrázku při editaci wiki. Aby bylo možné použít na stránce obrázek, tak ho musíte nejprve vy nebo někdo jiný do wiki vložit.

Odkaz na obrázek, který je uložen na MediaWiki serveru tvoří, kromě jména souboru, také prefix (předpona) jmenného prostoru  (i když stále lze použít i původní jmenný prostor  ). Jmenný prostor  lze také použít, pokud chceme vytvořit přímý odkaz na vložený soubor (obrázek pak nebude interpretován jako stránka MediaWiki).

Podporované formáty obrázků
Ve výchozím stavu jsou podporovány následující formáty:


 * nebo  - bitmapový obrázek je komprimovaný podle standardu JPEG (ztrátový formát, který se hodí především pro fotografie).
 * - bitmapový obrázek ve formátu PNG (formát Portable Network Graphic specifikovalo konsorcium W3).
 * - bitmapový obrázek ve formátu GIF (Graphics Interchange Format).

Další formáty, které používá Wikimedie, a s nimiž se lze setkat i jinde (jejich použití, ale může vyžadovat další nastavení, takže ve výchozím nastavení nemusí být dostupné):


 * - vektorové obrázky ve formátu SVG (formát Scalable Vector Graphics specifikovalo konsorcium W3). Viz Příručka:Administrace obrázků#SVG.
 * - formát označeného obrázku. Často se používá u fotografií určených pro archivaci, které mají mít zachováno vysoké rozlišení. Obvykle se používá s.
 * ,,   - Formát ogg je určen pro multimediální soubory (může obsahovat obraz i zvuk). Nejde sice přímo o obrazový formát, ale chová se podobně. Obvykle se používá s.
 * - vícestránkové dokumenty ve formátu PDF (Specifikace pro Portable Document Format pochází od Adobe). Obvykle se používá v kombinaci s
 * - bitmapový formát s wavelet kompresí pro vícestránkové dokumenty DejaVu (nejčastěji se s ním lze setkat u naskenovaných knih). Viz
 * Najednou se zobrazí pouze jedna stránka souboru  nebo.

Podporované jsou i další typy souborů, ale ty nelze zobrazit jako obrázek.

Syntaxe
Plná syntaxe pro zobrazení obrázku vypadá takto:

Parametr options zastupuje řadu dalších parametrů, které jsou od sebe, odděleny svislítkem (|). Další parametry však nemusí být vůbec uvedeny:


 * Parametr určující formát zobrazení: Lze použít vždy pouze jeden z následujících border, frameless, frame (nebo framed), thumb (nebo thumbnail). Pokud použijete více možností, může být vykreslení obrazu neočekávané.
 * Rozhoduje o tom, jak bude vložený obrázek na stránce vypadat a kam bude vůči zbytku stránky umístěn.


 * Parametr, kterým lze upravit velikost: Opět lze použít jen jednu z následujících možností
 * {šířka}px — Upraví velikost obrázku tak, aby jeho šířka odpovídala uvedené šířce v pixlech, bez ohledu na výšku. (Podporovány jsou pouze hodnoty v celých pixlech. Je povolen mezerník mezi hodnotou šířky a "px".)
 * x{výška}px — Upraví velikost obrázku tak, aby jeho výška odpovídala uvedené výšce v pixlech, bez ohledu na šířku. Podporovány jsou pouze hodnoty v celých pixlech. Je povolen mezerník mezi hodnotou výšky a "px".
 * {šířka}x{výška}px — Upraví velikost obrázku tak, aby se všemi rozměry vešel do uvedené šířky a výšky v pixlech. Podporovány jsou pouze hodnoty v celých pixlech. Je povolen mezerník mezi hodnotou šířky a "px".
 * upright — Upraví velikost obrázku tak, aby výsledná velikost vyhovovala preferencím uživatele (hodí se především u obrázků, které jsou vyšší než širší). Nastavení  zobrazí obrázek ve výchozí šířce obrazu.   zobrazí obrázek na dvojnásobku výchozí šířky.
 * Obrázek si vždy zachová poměr stran.
 * Obrazy v neškálovatelných typech médií lze zmenšit, ale ne zvětšit; např. bitmapové obrázky nelze zvětšit.
 * Nastavení  nevyžaduje znaménko rovná se, tj.   funguje stejně jako.
 * Při použití bez hodnoty nebo znaménka rovná se (např. ), je výchozí hodnota   (ačkoli   je stejné jako  )
 * Pokud jsou přítomny  a , bude první   ignorována. Podrobnosti najdete na stránce.
 * Pokud je mezi "upright" a znaménkem rovná se mezera (např. ) nebo pokud hodnota "upright" obsahuje nečíselné znaky), bude hodnota   ignorována. Podrobnosti najdete na stránce.
 * Maximální velikost zobrazeného obrázku závisí na použitém formátu a velikosti výchozího souboru (což může být závislé na jeho typu).
 * Parametr určující horizontální zarovnání: Může být uveden pouze jeden z následujících left, right, center nebo none. Pokud je k dispozici více z těchto možností, použije se pouze první.
 * Ovlivňuje horizontální zarovnání obrázku vůči textu (ať je vložen jako řádkový, plovoucí či blokový prvek). Ve výchozím nastavení není hodnota zarovnání žádná.
 * Parametr pro vertikální zarovnání: Může být baseline, sub, super, top, text-top, middle, bottom, text-bottom.
 * Ovlivňuje vertikální zarovnání obrázku vůči textu, který se nachází spolu s ním v rámci stejného blokového prvku před ním nebo za ním (výchozí hodnota vertikálního zarovnání je middle). Parametr nemá vliv, pokud je obrázek vložen jako plovoucí.
 * Parametr odkaz: Může být buď:
 * link={cíl odkazu} — Umožňuje změnit cíl vygenerovaného odkazu (zpravidla na nějakou jinou stránku nebo URL), který je aktivní nad celou plochou vygenerovaného obrázku. Např.  se vygeneruje jako Example.jpg (externí link), zatím co   jako Example.jpg (interní link).
 * link= (bez uvedené hodnoty) — (MediaWiki 1.14+) Vygeneruje se jako obrázek bez aktivního linku;   se vygeneruje jako Example.jpg.
 * Pokud je mezi  a znaménkem rovná se mezera, bude odkaz považován za titulek.
 * Použití některých ekvivalentů znaků HTML, například  za , může způsobit, že příkaz odkazu bude považován za titulek (viz T216003).


 * ! pro MW 1.24 a nižší: Pokud nastavíte  (bez nějaké hodnoty), pak se nevygeneruje žádný  . (Viz T23454.)
 * Další možné parametry:
 * alt={alternativní text} — (MediaWiki 1.14+) Definuje alternativní text (mapuje se na HTML atribut  vygenerovaného prvku ) obrázku, který bude vykreslen, pokud buď nelze odkazovaný obrázek stáhnout a vložit, nebo pokud podpůrné médium musí používat alternativní text popisu (např. při použití čtečky Braillova písma nebo s možnostmi přístupnosti nastavenými uživatelem ve svém prohlížeči).
 * Pokud je mezi  a znaménkem rovná se mezera, bude příkaz alt považován za titulek.
 * page={number} - Vykreslí zadané číslo stránky (aktuálně použitelné pouze při zobrazování souboru .djvu nebo .pdf).
 * class={html class}- (MediaWiki 1.20+) Definuje třídy (mapuje na atribut HTML  vygenerovaného prvku ).
 * lang={jazykový kód} - (MediaWiki 1.22+) Pro soubory SVG obsahující příkazy &lt;switch&gt; u atributu systemLanguage vybere, v jakém jazyce se má soubor zobrazit. Výchozí nastavení je jazyk stránky (výchozí jazyk je pro většinu projektů výchozím nastavením).

Pokud parametr neodpovídá žádné další možnosti, předpokládá se, že se jedná o text titulku. Je-li přítomen více než jeden neparametrový řetězec, použije se jako titulek finální neparametrový řetězec. Text titulků se zobrazuje pod obrázkem ve formátech thumb a frame nebo jako text nápovědy v jakémkoli jiném formátu. Text titulků zobrazený ve formátech thumb a frame může obsahovat odkazy wiki a další formátování. Rozšíření MediaWiki mohou přidávat další možnosti.

Pokud není zadán 'alt' a je k dispozici popisek, bude alternativní text vytvořen automaticky z titulku, zbavený formátování. S výjimkou případů, kdy je v režimu thumb nebo frame, protože titulek je již čitelný pro čtečky obrazovky.

Formát
Následující tabulka ukazuje účinek všech dostupných formátů.

Pokud je výška obrázku v náhledu větší než jeho šířka (tj. v orientaci na výšku, nikoli na šířku) a zjistíte, že je příliš velká, můžete zkusit možnost, kde N je poměr stran obrázku (jeho šířka dělená jeho výškou, výchozí nastavení je 0,75). Alternativou je explicitně zadat požadovanou maximální výšku (v pixelech).

Pamatujte si, že napsáním  můžete pro miniaturu použít jiný obrázek.

Velikost a rámeček
U různých formátů se účinek parametru size může lišit, jak je ukázáno níže.

Obrázek s  vždy ignoruje specifikaci velikosti. Původní obrázek bude zmenšen, pokud překročí maximální velikost definovanou v uživatelských preferencích.
 * Informace o tom, jak se zobrazuje, když není uvedena jeho velikost, viz odstavec Formát uvedený výše.
 * Pokud formát není zadán nebo je upraven pouze  (ohraničení), lze velikost zmenšit případně zvětšit na libovolnou zadanou velikost.
 * V příkladech níže je původní velikost obrázku 400 × 267 pixelů.
 * Velikost obrázku s  nebo   lze zmenšit, ale nelze ji zvětšit nad původní velikost obrázku.

Horizontální zarovnání
Při použití formátů  nebo   bude výchozí vodorovné zarovnání right pro jazyky zleva doprava a left pro jazyky zprava doleva.

Vertikální zarovnání
Možnosti svislého zarovnání se projeví pouze v případě, že je obrázek vykreslen jako vložený prvek a není plovoucí. Mění způsob, jakým bude inline obrázek svisle zarovnán s textem přítomným ve stejném bloku před a nebo za tímto obrázkem zobrazeném na stejném řádku.

Všimněte si, že vykreslený řádek textu, do kterého jsou vloženy obrázky (a řádky textu zobrazené po aktuálním), může být posunut dolů (To zvětší výšku řádku podmíněnou dalším rozestupem řádků. Stejně jako to může nastat při rozpětí textu s proměnnou velikostí písma nebo s horními a dolními indexy.), aby bylo možné s tímto omezením zarovnání plně zobrazit výšku obrázku.



Pro jasnější zobrazení výsledku zarovnání, je rozpětí textu označené nahoře a dole linkou. Velikost písma se zvětšuje na 200% a blok odstavce je vyznačen tenkým okrajem. Navíc jsou zarovnávány obrázky různých velikostí:

 text top: text

 text text-top: text

 text super: text

 text baseline: text

 text sub: text

 text default: text

 text middle: text

 text text-bottom: text

 text bottom: text

Poznámky:


 * 1) "Střední" vertikální poloha obrázku (která je také výchozí) se obvykle vztahuje na střed mezi výškou x a základní linkou textu (na který bude vertikální střed obrázku zarovnán a na který obvykle může být text překreslený), ale ne do středu výšky řádku výšky písma, která odkazuje na mezeru mezi pozicemi "horního indexu" a "dolního indexu". Výška písma nezahrnuje:
 * 2) * další rozteč řádků je normálně rozdělena rovnoměrně na dva okraje řádků (zde 0,5em, podle výšky řádku nastavené na 200%) nad a pod výškou písma).
 * 3) * další řádkování, která mohou být přidána horními a dolními indexy.
 * 4) Pokud však výška obrázku způsobí, že jeho horní nebo dolní pozice přejde nad nebo pod normální celou výšku řádku, bude střední pozice upravena zvětšením horního a nebo spodního okraje, aby se obraz mohl správně umístit a zarovnat. Všechny obrázky (včetně obrázků s menšími výškami) budou svisle vystředěny na upravené střední poloze (pro výpočet efektivní výšky řádku se bere do úvahy text každé vykreslené řady s větší výškou písma).
 * 5) Pozice zarovnání "horního indexu" a "dolního indexu" také vylučují zvláštní řádkování přidané pomocí horních a dolních indexů, ale ne další řádkování definované výškou řádku.
 * 6) Pozice zarovnání "nahoru" a "dolu" berou v úvahu všechna tato nadbytečná řádkování (včetně horních a dolních indexů, pokud jsou přítomny ve vykresleném rozmezí řádků). Pokud zarovnání obrazu omezí růst obrázku nad nebo pod normální rozteč čar a obraz není umístěn absolutně, způsobí, že se upraví pozice "horní" a "dolní" (stejně jako horní a dolní index), takže efektivní výška řádku mezi vykreslenými řádky textu bude vyšší.
 * 7) Pozice "podtržení nahoře" (underline), "podtržení" (overline) a "přeškrtnutí" (overstrike) by měla být někde v rámci těchto dvou limitů a může záviset na typu a výšce použitých fontů (mohou být brány v úvahu styly horního a dolního indexu, v některých prohlížečích jsou tyto styly obvykle ignorovány a umístění těchto úprav nemusí být upraveno). Takže tyto úpravy obvykle neovlivňují vertikální polohu obrázků, relativně k textu.

Zastavení toku textu
Příležitostně je žádoucí zabránit tomu, aby text (nebo jiné vložené plovoucí obrázky) tekly kolem plovoucího obrazu. V závislosti na rozlišení obrazovky webového prohlížeče apod., může tok textu na pravé straně obrázku způsobit, že se záhlaví sekce (například == Moje záhlaví == ) zobrazí napravo od obrázku. Místo pod ním, jak chce uživatel. Tok textu lze zastavit umístěním   (nebo pokud chcete, ) před text, který by měl začínat pod plovoucím obrazem. (To lze také provést bez prázdného řádku zabalením sekce s plovoucími obrázky kódem, který vymaže všechny plovoucí prvky uvnitř sekce  .)

Všechny obrázky jsou vykresleny jako bloky (včetně plovoucích obrazů center left nebo right, stejně jako framed nebo thumbnail) a implicitně přerušují okolní řádky textu (ukončení aktuálního bloku textu před obrázkem a vytvoření nového odstavce pro text za nimi). Poté se budou ukládat svisle podél levého nebo pravého okraje podle určeného zarovnání (nebo podél středové čáry mezi těmito okraji pro editační obrázky zarovnané na střed).

Změna výchozího cíle odkazu
Následující tabulka ukazuje, jak změnit cíl odkazu (jehož výchozím je stránka s popisem obrázku) nebo jak jej odstranit. Změna odkazu nezmění formát popsaný v předchozích částech.

Varování:
 * Licenční požadavky na vaší wiki vám možná neumožní odstranit všechny odkazy na stránku s popisem, která zobrazuje požadované autorství, prohlášení o autorských právech, příslušné licenční podmínky nebo úplnější popis zobrazeného obrazu (včetně historie jeho úprav).
 * Pokud změníte nebo odstraníte cílový odkaz obrázku, budete muset někde jinde na své stránce uvést explicitní odkaz na tuto stránku s popisem nebo zobrazit prohlášení o autorských právech a autorovi a odkaz na příslušnou licenci, pokud jsou liší od prvků použitelných na samotnou stránku pro vkládání.
 * Vaše wiki pravidla mohou omezovat použití parametru alternativního odkazu nebo mohou dokonce vynucovat zákaz alternativních parametrů odkazu pro vložené mediální soubory (v takovém případě bude parametr odkazu ignorován) nebo mohou být přijaty pouze po ověření oprávněnými uživateli nebo správci.

Syntaxe galerie
Vytvoření galerie miniatur pomocí značky je snadné. Syntaxe je:

Všimněte si, že kód obrázku není při uzavírání do značek galerie uzavřen v závorce.

Titulky jsou volitelné a mohou obsahovat wiki odkazy nebo jiné formátování.

Lze zde také použít některé parametry řídící výstup thumb, konkrétně ty, které upravují soubor (na rozdíl od těch, které určují, kde na stránce se obrázek zobrazuje). Například u vícestránkových médií, jako jsou pdf, můžete použít kód jako.

Předponu  lze vynechat. Je však užitečné zahrnout ji jako pomůcku pro rychlé nalezení specifikátorů obrázků ve wikitextu (například při čištění rozvržení stránky).

Například:

je formátován jako:

Parametr režimu
Počínaje verzí 1.22 je k dispozici parametr módu, který má následující možnosti:


 * je původní typ galerie používaný MediaWiki.
 * je podobné, ale bez hraničních čar.
 * způsobí, že obrázky budou mít stejnou výšku, ale různé šířky, s malou mezerou mezi obrázky. Řádky v režimu responzivní se uspořádají podle šířky obrazovky.
 * zobrazuje titulek v poloprůhledném bílém poli překrývající obrázek.
 * je podobné překrytí, ale s titulkem a rámečkem se zobrazuje pouze na hover.
 * vytvoří prezentaci obrázků.

Například:

Poskytuje (režim: ):

Nepovinné atributy galerie
Samotná značka galerie umožňuje několik dalších parametrů zadaných jako párový atribut název-hodnota:


 * : (Text titulků mezi dvojitými uvozovkami pro více než jedno slovo) Nastaví titulek na střed galerie. V titulku lze použít pouze prostý text - formátování, šablony a podobně nebudou fungovat.
 * : Nastavuje (max.) šířky obrázků; výchozí hodnota je 120 pixelů. Všimněte si množného čísla: šířky.
 * : Nastavuje (max.) výšky obrázků; výchozí hodnota je 120 pixelů.
 * : Nastavuje počet obrázků na řádek. 0 znamená automatické nastavení podle šířky obrazovky.
 * : Zobrazuje názvy souborů obrázků v jednotlivých titulcích pro každý obrázek (1.17+).
 * : Viz část výše (1.22+; 1.28+ pro "přehrávání obrázků").
 * : Pouze v režimu "přehrávání obrázků" (slideshow) zobrazíte pruh s miniaturami obrázků pod slideshow ve výchozím nastavení (1.29+).


 * Příklad 1

Syntaxe:

Výsledek:

Řádek obrázků, který se zalomí na šířku prohlížeče
Jedním ze způsobů, který funguje pro řadu obrázků s různou šířkou, je nepoužívat "thumb", "left" nebo "none". Pokud není použit "thumb" (a tedy žádné titulky), řádek obrázků se zalomí do šířky prohlížeče. Pokud je to nutné, zužte okno prohlížeče a uvidíte obrázky zalomené na další řádek.





Pro zalamování obrázků s různou šířkou s titulky je nutné použít div HTML pro neuspořádaný seznam. Spolu se. Další informace a nápady viz: Give Floats the Flick in CSS Layouts.

        </li>  </li>  </li>  </li>  </li> </ul>

Chcete-li zarovnat horní okraj obrázků, přidejte příkaz svislé zarovnání

<ul>  </li>  </li>  </li>  </li>  </li>  </li>  </li>  </li> </ul>

Některé farmy wiki nemají všechny možnosti galerie (například "šířky"). Někdy také potřebujete různé šířky obrázků v řadě. Mimo galerii nebo div HTML není možné mít jednotlivé popisky pro obrázky v řadě obrázků, které se zalomí na šířku prohlížeče. Zkuste to a uvidíte. Nic jiného pomocí wikitextu nefunguje správně. Obrázky budou buď překrývat obsah vpravo nebo si vynutí vodorovný posuvník.

Použití levého float ("left") pro některé obrázky v kombinaci s "none" pro některé z obrázků nebude fungovat důsledně, zejména pokud existuje také pravý postranní panel obrázků. Objeví se divné věci. Při užších šířkách prohlížečů nebo obrazovek se může obraz mimo řádek objevit až příliš daleko za stránkou na konci pravého postranního panelu obrázků.

Chování odkazu
Ve výchozím nastavení obrázek odkazuje na stránku s popisem souboru. Možnost "link=" upravuje toto chování tak, že odkazuje na jinou stránku nebo web nebo vypíná chování při propojování obrázku.

Alternativně můžete vytvořit textový odkaz na stránku popisu souboru nebo na samotný soubor. Podrobnosti najdete na stránce.

Zobrazení obrázku, odkazu na jinou stránku nebo web
Pomocí možnosti "link=" můžete propojit obrázek s jinou stránkou nebo webem:

Kliknutím na obrázek níže se dostanete na MediaWiki:





Kliknutím na obrázek níže se dostanete na stránku example.com:





Zobrazení obrázku, vypnutí odkazu
Použijte možnost "link=" bez přiřazené hodnoty k úplnému vypnutí odkazu. Níže uvedený obrázek není odkaz:





Odkaz na obrázek
Přidejte  (dvojtečku) jako předponu k odkazu, který potřebujete vytvořit.

File:MediaWiki-2020-logo.svg File:MediaWiki-2020-logo.svg Wiki Wiki

Přímé propojení s obrázkem
Výše uvedené příklady odkazují na stránku popisu obrázku. K přímému odkazu na obrázek lze na stránkách MediaWiki použít pseudojmenný prostor :

[[Media:MediaWiki-2020-logo.svg]]

Přímé odkazy z externích webů
Další možností je použít stránku Special:Redirect/file (nebo její alias Special:Filepath). Na rozdíl od výše uvedeného příkladu na ně můžete odkazovat z externích webů i ze stránek MediaWiki.

Parametry  a   lze také přidat, aby se vrátila konkrétní velikost obrázku. Poměr stran obrazu je vždy zachován.

Získání úplné URL adresy obrázku
Chcete-li získat úplnou cestu k obrázku (bez přesměrování, jak je ukázáno výše), lze použít stránku.

Stane se:



V případě, že je to použito ze šablony, kde je potřeba odstranit jmenný prostor,   to může udělat:

Stane se:



Požadavky
Před použitím obrázků na stránce musí správce systému vaší wiki povolit nahrávání souborů a uživatel musí nahrát soubor. Správci systému mohou také nastavit wiki, aby přijímala soubory z cizích repozitářů, například Wikimedia Commons. Pro změnu velikosti obrazu na straně serveru je nutné mít nakonfigurován škálovač (například GD2, ImageMagick atd.).

Soubory na jiných webech
Na externí soubor dostupný online můžete odkazovat pomocí stejné syntaxe jako při odkazování na externí webovou stránku. S těmito syntaxemi nebude obraz vykreslen, ale bude zobrazen pouze text odkazu na tento obrázek.



Nebo s jiným zobrazeným textem:

text odkazu je zde

V tomto zobrazeném textu je povoleno další označení MediaWiki nebo formátování HTML/CSS (pro vložené prvky) (kromě vložených odkazů, které by narušily okolní odkaz):

Příklad  rich   text odkazu  zde.

která se zobrazí jako: Příklad  rich   text odkazu  je zde.

Pokud je to na vaší wiki povoleno (viz ), můžete také vložit externí obrázky. Chcete-li to provést, jednoduše vložte adresu URL obrázku: http://url.for/some/image.png Velikost vložených obrázků lze změnit pomocí vlastnosti CSS. Mohou být také formátovány okolním značením MediaWiki nebo kódem HTML/CSS.

Pokud tato možnost wiki není povolena, obrázek nebude vložen. Bude vykreslen jako textový odkaz na externí web. Stejně jako výše, když nemá hodnotu.

Související stránky

 * Wikipedie:Rozšířená syntaxe obrazu
 * Kategorie:Wikipedie pomoc s obrázkem
 * Wikipedie:Návod k obrázkům
 * Nápověda:Štítek galerie
 * T113101 - reakce na problémy
 * Extension:PageImages
 * Extension:PageImages