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.

Link na obrázek, který je uložen na MediaWiki serveru tvoří, kromě jména souboru, také prefix 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ý link 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:


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

Další formáty, které používá Wikimedia, 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é):


 * .svg : vektorové obrázky ve formátu SVG (formát Scalable Vector Graphics specifikovalo konsorcium W3). Viz Manuál:Administrace obrázků#SVG.
 * .tiff : Tag Image format file - neoficiální standard pro ukládání obrázku ve formátu pro tisk. Č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.
 * .ogg, .oga, .ogv : 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.
 * .pdf : vícestránkové dokumenty ve formátu PDF (Specifikace pro Portable Document Format pochází od Adobe). Obvykle se používá v kombinaci s
 * .djvu : 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
 * Ze souboru ve formátu .pdf nebo .djvu lze v jednom okamžiku na stránce zobrazit pouze jednu stránku.

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 (|), které však nemusí být uvedeny vůbec:


 * Parametr určující formát zobrazení: lze použít vždy pouze jeden z následujících border, frameless, frame, thumb (nebo thumbnail). Pokud je k dispozici více z těchto možností, použije se pouze první;
 * 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. (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
 * {šíř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
 * 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 na výchozí šířce obrazu uživatele.   zobrazí obrázek na dvojnásobku výchozí šířky uživatele.
 * 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ř. ), výchozí hodnota je   (ačkoli   je stejné jako  )
 * Pokud jsou přítomny  a , bude první   ignorována. Další podrobnosti na.
 * Pokud je mezi „upright“ a znaménkem rovná se mezera (např. ) nebo pokud hodnota „upright“ obsahuje nečíselné znaky, hodnota   bude ignorována). Další podrobnosti na.
 * 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, 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ť již je vložen jako řádkový, plovoucí či blokový element). 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 elementu 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í element.
 * 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+) Se vygeneruje jako obrázek bez aktivního linku;   se vygeneruje jako Example.jpg.
 * Pokud je mezi  a znaménkem rovná se mezera, bude odkaz na odkaz považován za titulek.


 * ! pro MW 1.24 a nižší: Pokud nastavíte  (bez nějaké hodnoty), pak se nevygeneruje žádný  . (Viz T23454.)
 * Další možné parametry:
 * alt={alternative text} - (MediaWiki 1.14+) Definuje alternativní text (mapuje na atribut HTML  vygenerovaného   prvek) obrazu, který bude vykreslen, pokud nelze odkazovaný obrázek stáhnout a vložit nebo pokud podpůrné médium musí použít alternativní text popisu (např. při použití čtečky Braillova písma nebo s možnostmi usnadnění přístupu) nastaveno uživatelem v 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 vykreslit. Výchozí nastavení je jazyk stránky (výchozí nastavení je výchozí jazyk pro většinu projektů).

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. Alternativní text bude 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í nastaveno na 0,75). Alternativou je explicitně zadat požadovanou maximální výšku (v pixelech).

Pamatujte, ž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.


 * Informace o tom, jak se zobrazuje, když není uvedena jeho velikost, viz část Formát výše.
 * Pokud formát není zadán nebo je upraven pouze  (ohraničení), velikost lze zmenšit a zvětšit na libovolnou zadanou velikost.
 * V příkladech níže je původní velikost obrázku 400 × 267 pixelů.
 * Obrázek s rámečkem  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.
 * 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í.

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 na stejném vykresleném řádku.

Všimněte si, že vykreslený řádek textu, do kterého jsou vloženy vložené obrázky (a řádky textu vykreslené po aktuálním), může být posunut dolů (to zvýší výšku řádku podmíněné 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í jsou rozpětí textu podtržené nahoře a dole. Velikost písma se zvětšuje na 200% a blok odstavce je vyznačen tenkým okrajem. Navíc jsou zarovná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í" poloha svislého zarovnání obrázku (která je také výchozí) se obvykle vztahuje ke středu mezi výškou x a základní linií textu (na kterém bude zarovnán vertikální střed obrázku a na které obvykle může být text přepsán), ale ne uprostřed řádkové výšky fontové výšky, která odkazuje na mezeru mezi pozicemi „text-top“ a „text-bottom“; 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 po zvětšení horního a nebo spodního okraje, aby se obraz mohl správně umístit a zarovnat a 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 vezme v úvahu text každé vykreslené řady s větší výškou písma).
 * 5) Pozice zarovnání „text-top“ a „text-bottom“ 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í „nahoře“ a „dole“ berou v úvahu všechna tato nadbytečná řádkování (včetně horních a dolních indexů, pokud jsou přítomna ve vykresleném rozmezí řádků). Když zarovnání obrazu omezí růst obrázku nad nebo pod normální rozteč čar a obraz není absolutně umístěn, 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) The "underline", "overline" and "overstrike" text-decoration positions should be somewhere within these two limits and may depend on the type and height of fonts used (the superscript and subscript styles may be taken into account in some browsers, but usually these styles are ignored and the position of these decorations may not be adjusted); so these decorations normally don't affect the vertical position of images, relatively to the text.

Stopping the text flow
On occasion it is desirable to stop text (or other inline non-floating images) from flowing around a floating image. Depending on the web browser's screen resolution and such, text flow on the right side of an image may cause a section header (for instance, == My Header == ) to appear to the right of the image, instead of below it, as a user may expect. The text flow can be stopped by placing   (or if you prefer,  ) before the text that should start below the floating image. (This may also be done without an empty line by wrapping the section with the floating images with …, which clears all floats inside the   element.)

All images rendered as blocks (including non-floating centered images, left- or right-floating images, as well as framed or thumbnailed floating images) are implicitly breaking the surrounding lines of text (terminating the current block of text before the image, and creating a new paragraph for the text after them). They will then stack vertically along their left or right alignment margin (or along the center line between these margins for centered images).

Altering the default link target
The following table shows how to alter the link target (whose default is the image description page) or how to remove it. Changing the link does not alter the format described in the previous sections.

Warning:
 * The licencing requirements on your wiki may not allow you to remove all links to the description page that displays the required authors attributions, the copyrights statements, the applicable licencing terms, or a more complete description of the rendered image (including its history of modifications).
 * If you change or remove the target link of an image, you will then have to provide somewhere else on your page an explicit link to this description page, or to display the copyright and author statement and a link to the applicable licence, if they are different from the elements applicable to the embedding page itself.
 * Your wiki policy may restrict the use of the alternate link parameter, or may even enforce a prohibition of alternate link parameters for embedded media files (in which case, the link parameter will be ignored), or may only accept them after validation by authorized users or administrators.

Gallery syntax
It's easy to make a gallery of thumbnails with the  tag. The syntax is:

Mode parameter
Starting in 1.22 a  parameter is available, taking options as follows:


 * is the original gallery type used by MediaWiki.
 * is similar to, but with no border lines.
 * causes images to have the same height but different widths, with little space between the images. The rows in this responsive mode organize themselves according to the width of the screen.
 * shows the caption overlaid on the image, in a semi-transparent white box.
 * is similar to, but with the caption and box only showing up on hover.
 * creates a slideshow of the images.

For example:

Gives (mode: packed-hover):

Optional gallery attributes
The gallery tag itself takes several additional parameters, specified as attribute name-value pairs:

Row of images that will wrap to browser width
One way that works for a row of images with varying widths is not to use "thumb" or "left" or "none". If "thumb" is not used (and thus no captions) a row of images will wrap to the browser width. If necessary, narrow the browser window to see the images wrap to the next row.





To wrap images of varying widths with captions it is necessary to use div HTML for an unordered list. Along with. For more info and ideas see: Give Floats the Flick in CSS Layouts.

     <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> <li style="display: inline-block;"> </li> </ul>

Some wiki farms do not have all gallery options (such as "widths"). Also, sometimes one wants varying widths for images in a row. Outside of a gallery, or the div HTML, it is impossible to have individual captions for images in a row of images that will wrap to the browser width. Try it and see. Nothing else using wikitext works correctly. Images will either overlap stuff on the right, or force a horizontal scroll bar.

Using a left float ("left") for some images, combined with "none" for some of the images, will not work consistently either, especially if there is also a right sidebar of images. Weird things will occur. At narrower browser or screen widths an image out of the row may appear far down the page after the end of the right sidebar of images.

Link behavior
By default an image links to its file description page. The "link=" option modifies this behavior to link to another page or website, or to turn off the image's linking behavior.

Alternatively, you can create a text link to a file description page or to the file itself. See.

Display image, link it to another page or website
Use "link=" option to link image to another page or website:

Clicking on the below image will take you to MediaWiki:





Clicking on the below image will take you to example.com:





Display image, turn off link
Use "link=" option with no value assigned to turn link off entirely; the below image is not a link:





Link to an image
Add  as a prefix to the link you need to create.

File:Wiki.png File:Wiki.png Wiki Wiki

Directly linking to an image
The above examples link to the image's description page. To directly link to an image, the pseudo-namespace  can be used on MediaWiki pages:

[[Media:Wiki.png]]

Direct links from external sites
Another possibility is to use the Special:Redirect/file page (or its alias Special:Filepath). Unlike the above example, you can link to it from external websites as well as from MediaWiki pages.

The parameters  and   can also be added to return a specific size of the image. The image aspect ratio is always preserved.

Obtaining the full URL of an image
To obtain the full path of an image (without going through redirects as shown above), some can be used.

Becomes:



In the event that this is used from a template where the  namespace needs to be removed,   can do so:

Becomes:



Requisites
Before using images in your page, the system administrator of your wiki must have enabled file uploads and a user has to upload the file. System administrators may also set the wiki to accept files from foreign repositories, such as the Wikimedia Commons. For server side image resizing it is necessary to have a scaler configured (such as GD2, ImageMagick, etc.).

Files at other websites
You can link to an external file available online using the same syntax used for linking to an external web page. With these syntaxes, the image will not be rendered, but only the text of the link to this image will be displayed.



Or with a different displayed text:

link text here

Additional MediaWiki markup or HTML/CSS formatting (for inline elements) is permitted in this displayed text (with the exception of embedded links that would break the surrounding link):

Example  rich   link text  here.

which renders as: Example  rich   link text  here.

If it is enabled on your wiki (see ), you can also embed external images. To do that, simply insert the image's URL: http://url.for/some/image.png Embedded images can be resized by the CSS  property. They also may be formatted by surrounding MediaWiki markup or HTML/CSS code.

If this wiki option is not enabled, the image will not be embedded but rendered as a textual link to the external site, just like above, unless the site's has a value.