DokuWiki

Stránka je pouze pro čtení. Můžete zobrazit zdrojový kód, ale nemůžete ho měnit.
Pokud si myslíte, že je to chyba, kontaktujte správce.
====== Plugin Gallery ======

^ Parametr                                ^ Výchozí hodnota    ^ Popis                                                                                                                                                                                                                                                                  ^
| ''//<number>//x//<number>//''           | ''%%150x150%%''    | Nastaví velikost náhledů. Pokud není aktivní volba oříznutí, jedná se o ohraničující rámeček, do kterého se náhled přizpůsobí při zachování poměru stran.                                                                                                              |
| ''//<number>//X//<number>//''           | ''%%1600X1200%%''  | Nastaví maximální velikost obrázků při zobrazení v lightboxu. Jedná se o ohraničující rámeček, do kterého se obrázek přizpůsobí při zachování poměru stran. Pozor na velké ''X''. Jedná se o maximum – lightbox automaticky zmenší obrázek podle velikosti obrazovky.  |
| ''//<number>//''                        | ''0''              | Počet obrázků na řádek v tabulce galerie. Pokud zadáte ''0'', obrázky se přizpůsobí automaticky.                                                                                                                                                                       |
| ''=//<number>//''                       | ''=0''             | Omezí výstup na daný počet obrázků. ''0'' znamená všechny.                                                                                                                                                                                                             |
| ''+//<number>//''                       | ''+0''             | Přeskočí prvních několik obrázků. Užitečné ve spojení s předchozí volbou.                                                                                                                                                                                              |
| ''~//<number>//''                       | ''~0''             | Přidá stránkování náhledů s daným počtem obrázků na stránku. ''0'' stránkování vypne. Stránkování je přidáno pomocí JavaScriptu – pokud není JavaScript dostupný, zobrazí se všechny náhledy.                                                                          |
| ''cache''                               | enabled            | Výstup vytvořené galerie se obvykle ukládá do mezipaměti. Pokud se obrázky ve vybraném jmenném prostoru změní, je třeba ručně vynutit aktualizaci stránky galerie ([[:caching|mezipaměť]]). Pro vypnutí mezipaměti nastavte volbu ''nocache''.                         |
| ''crop''                                | enabled            | Vytvoří náhledy přesně ve zvolené velikosti, ořízne je podle potřeby.                                                                                                                                                                                                  |
| ''direct''                              | disabled           | Propojí náhledy přímo s originálem místo s detailní stránkou.                                                                                                                                                                                                          |
| ''lightbox''                            | enabled            | Zobrazí obrázky v elegantním JavaScriptovém modálním okně. Podrobnosti viz níže.                                                                                                                                                                                       |
| ''reverse''                             | disabled           | Obrátí pořadí zobrazených obrázků.                                                                                                                                                                                                                                     |
| ''recursive''                           | enabled            | Vyhledá obrázky ve zvoleném jmenném prostoru a všech jeho podprostorech.                                                                                                                                                                                               |
| ''random''                              | disabled           | Seřadí obrázky náhodně. Doporučuje se použít i volbu ''nocache''.                                                                                                                                                                                                      |
| ''modsort''                             | disabled           | Seřadí obrázky podle data poslední úpravy souboru.                                                                                                                                                                                                                     |
| ''datesort''                            | disabled           | Seřadí obrázky podle data vytvoření z EXIF informací.                                                                                                                                                                                                                  |
| ''titlesort''                           | disabled           | Seřadí obrázky podle názvu z EXIF informací.                                                                                                                                                                                                                           |
| ''showname''                            | disabled           | Zobrazí název souboru pod náhledy.                                                                                                                                                                                                                                     |
| ''showtitle''                           | disabled           | Zobrazí EXIF značku ''Headline'' jako titulek pod náhledy.                                                                                                                                                                                                             |
| ''showcaption''                         | disabled           | Zobrazí EXIF značku ''Caption'' jako popisek pod náhledy.                                                                                                                                                                                                              |
| cokoliv obsahující ''*'' (hvězdičku)    |                    | Lze použít pro filtrování seznamu souborů ve zvoleném jmenném prostoru. ''*'' funguje jako jednoduchý zástupný symbol (wildcard).                                                                                                                                      |
| ''full'',''left'',''center'',''right''  | ''full''           | [[#Zarovnání]] jak je popsáno výše.                                                                                                                                                                                                                                    |


====== Gallery Plugin ======

Tento Syntax plugin umožňuje vložit automaticky vytvořenou galerii obrázků na stránku  

screenshot_img:

{{https://i.imgur.com/rj4v2c3.png}} 
 
----

Tento plugin zobrazí seznam miniatur obrázků s odkazy na jejich větší verze.


===== Syntaxe =====

Obrázky lze vybírat ze tří různých zdrojů a lze použít různé [[#alignment|zarovnání]] a [[#options]] (volby).

==== Zdroj: Jmenný prostor / Obrázek ====

Galerii můžeš přidat zadáním [[:namespaces|jmenného prostoru]] takto:

  {{gallery>:jmenny_prostor}}

Všechny obrázky v tomto jmenném prostoru budou přidány do galerie. Nezapomeň na dvoutečku před jmenným prostorem.

Místo celého jmenného prostoru můžeš také specifikovat jeden obrázek:

  {{gallery>:jmenny_prostor:nazevobrazu.jpg}}

[[#Options]] (viz níže) se přidávají za jmenný prostor / obrázek, oddělují se otazníkem ''?''.

  {{gallery>:jmenny_prostor:nazevobrazu.jpg?volby}}

==== Zdroj: Media Feed ====

Místo jmenného prostoru můžeš také uvést HTTP(s) URL na RSS nebo ATOM feed obsahující obrázky (když ho například vytvoří většina foto serverů jako Flickr):

  {{gallery>https://www.23hq.com/rss/schabloni}}

Poznámka: protože otazník se používá k oddělení [[#options]], nemůže URL obsahovat otazník (?). Pokud URL obsahuje, použij některý z URL zkracovačů, např. [[https://bit.ly]].

Volby opět přidáváš za otazník ''?''.

  {{gallery>https://www.23hq.com/rss/schabloni?volby}}

==== Zdroj: Seznam obrázků ====

Jiný způsob přijímá seznam obrázků, každý na samostatném řádku. Obrázky mohou být lokální i externí. [[#options]] patří do otevíracího tagu.

<code>
<gallery volby>
:jmenny_prostor:obrazek.jpg
https://example.com/obrazek2.jpg
</gallery>
</code>

Tento režim dovoluje také manuální nastavení titulku a popisku obrázku. Titulek se odděluje mezerou od názvu obrázku, popisek oddělíš znakem ''|''.

<code>
<gallery volby>
:jmenny_prostor:obrazek.jpg Můj kůň | Podívej se na mého koně, je úžasný!
https://example.com/obrazek2.jpg Titulek jen
</gallery>
</code>

==== Zarovnání ====

Galerie může být zarovnána 4 způsoby:

  * ''full'' -- plně responzivní rozložení využívající celou šířku stránky. Galerie se automaticky přizpůsobí. Toto je výchozí a doporučené nastavení.
  * ''center'' -- zarovná galerii na střed, využívá jen potřebnou šířku. Pravděpodobně budeš chtít nastavit počet sloupců ručně.
  * ''left'' -- zarovná galerii vlevo, následující obsah bude obtékat zprava. Pravděpodobně budeš chtít nastavit počet sloupců ručně.
  * ''right'' -- zarovná galerii vpravo, následující obsah bude obtékat zleva.

Zarovnání se nastavuje buď výše uvedeným klíčovým slovem v [[#options]] nebo mezerou (kromě režimu seznamu):


  {{gallery> jmenny_prostor?volby}} (zarovnáno vpravo)  
  {{gallery>jmenny_prostor?volby }} (zarovnáno vlevo)  
  {{gallery> jmenny_prostor?volby }} (zarovnáno na střed)

==== Volby ====

Parametry nastavuješ vypsáním za otazník v syntaxi, oddělují se znakem ''&'' nebo mezerou. Výchozí hodnoty lze nastavit v konfiguraci pluginu. Pokud je parametr aktivní ve výchozím nastavení, můžeš ho zakázat přidáním předpony ''no''. Například parametr ''cache'' je normálně zapnutý a zakážeš ho pomocí ''nocache''. Následuje seznam rozpoznaných parametrů:

^ Parameter                                  ^ Výchozí hodnota    ^ Popis                                                                                                                                                                                                                                         ^
| ''//<číslo>//x//<číslo>//''                | ''%%150x150%%''    | Nastaví velikost miniatur. Pokud není použito crop, miniatura se přizpůsobí do tohoto rámečku při zachování poměru stran.                                                                                                                     |
| ''//<číslo>//X//<číslo>//''                | ''%%1600X1200%%''  | Nastaví maximální velikost obrázků pro zobrazení v lightboxu. Jedná se o rámeček, do kterého se obrázek přizpůsobí s uložením poměru stran. Pozor na velké písmeno ''X''. Lightbox automaticky zmenší obrázek, pokud je větší než obrazovka.  |
| ''//<číslo>//''                            | ''0''              | Počet obrázků na řádek v galerii. Pokud je zadáno 0, obrázky se automaticky přizpůsobí.                                                                                                                                                       |
| ''=//<číslo>//''                           | ''=0''             | Omezí výstup na daný počet obrázků. ''0'' znamená všechny.                                                                                                                                                                                    |
| ''+//<číslo>//''                           | ''+0''             | Přeskočí prvních daný počet obrázků. Užitečné s předchozím parametrem.                                                                                                                                                                        |
| ''~//<číslo>//''                           | ''~0''             | Přidá stránkování, které zobrazuje daný počet náhledů na stránku. ''0'' stránkování vypíná. Přidáno přes JavaScript - pokud je JavaScript vypnutý, zobrazí se všechny náhledy.                                                                |
| ''cache''                                  | zapnuto            | Výstup galerie je obvykle cachován. Při změně obrázků v jmenném prostoru musíš ručně vyprázdnit cache galerie. Pro vypnutí cache na dané stránce použij ''nocache''.                                                                          |
| ''crop''                                   | zapnuto            | Miniatury jsou přesně oříznuty na zadanou velikost.                                                                                                                                                                                           |
| ''direct''                                 | vypnuto            | Link miniatur je směřován na originální obrázek místo na detailní stránku                                                                                                                                                                     |
| ''lightbox''                               | zapnuto            | Obrázky se zobrazují ve fancy JavaScript okně (modal) - viz níže.                                                                                                                                                                             |
| ''reverse''                                | vypnuto            | Obrátí pořadí obrázků v galerii                                                                                                                                                                                                               |
| ''recursive''                              | zapnuto            | Hledá obrázky v daném jmenném prostoru a ve všech podprostorech                                                                                                                                                                               |
| ''random''                                 | vypnuto            | Náhodné řazení obrázků. Vhodné kombinovat s ''nocache''.                                                                                                                                                                                      |
| ''modsort''                                | vypnuto            | Řazení obrázků podle data poslední změny                                                                                                                                                                                                      |
| ''datesort''                               | vypnuto            | Řazení obrázků podle data EXIF vytvoření                                                                                                                                                                                                      |
| ''titlesort''                              | vypnuto            | Řazení obrázků podle EXIF tagu ''Headline''                                                                                                                                                                                                   |
| ''showname''                               | vypnuto            | Zobrazení názvu souboru pod miniaturami                                                                                                                                                                                                       |
| ''showtitle''                              | vypnuto            | Zobrazení EXIF tagu ''Headline'' jako titulku pod miniaturami                                                                                                                                                                                 |
| ''showcaption''                            | vypnuto            | Zobrazení EXIF tagu ''Caption'' jako popisku pod miniaturami                                                                                                                                                                                  |
| cokoli obsahující ''*'' (hvězdičku)        |                    | Můžeš použít k filtrování souborů v daném jmenném prostoru. ''*'' je jednoduchý wildcard symbol.                                                                                                                                              |
| ''full'', ''left'', ''center'', ''right''  | ''full''           | [[#Zarovnání]] jak je popsáno výše                                                                                                                                                                                                             |

=== Příklad ===

  {{gallery>obrazky:dovolena?image_*.jpg&80x80&nocrop&showtitle}}

Zobrazí všechny obrázky začínající na ''image_'' a končící na ''.jpg'' z jmenného prostoru ''obrazky:dovolena''. Miniatury nebudou oříznuté a ve velikosti 80x80 pixelů. Titulky obrázků budou zobrazeny v galerii.

=== Příklad ===

  {{gallery>?crop&lightbox}}

Zobrazí všechny obrázky v aktuálním jmenném prostoru s 2 parametry. Volby začínají otazníkem ''?'' a jednotlivé odděluješ znakem ''&''.

===== O lightbox režimu =====

Tento režim otevře kliknutý obrázek uvnitř aktuálního okna prohlížeče bez toho, aby stránku opustil.

Obrázek zavřeš kliknutím na tlačítko X v pravém horním rohu. Můžeš také přecházet na další nebo předchozí obrázek pomocí šipek v dolní liště. Navigaci lze dělat i klávesnicí:

^ Klávesa  ^ Akce               ^
| ''->''   | další obrázek      |
| ''<-''   | předchozí obrázek  |
| ''ESC''  | zavření zobrazení  |

Pro mobilní uživatele je podpora gesta potažení (swipe) a lze využít tlačítko zpět pro uzavření.

Zobrazované obrázky lze zvětšovat kolečkem myši nebo gesty na dotykových zařízeních.

=== Na titulky a popisky =====

U interních obrázků se titulky a popisky čtou z EXIF/IPTC tagů, což jsou metadata uvnitř souboru obrázku. Tento plugin čte metadata jen pro JPEG obrázky v UTF-8 kódování.

Metadata se dají upravit v [[:fullscreen-mediamanager|fullscreen mediamanager]].

[[#Zdroj: Seznam obrázků]] dovoluje manuálně nastavit titulky a popisky u jednotlivých obrázků.

==== Cache ====

Výstup galerie je standardně cachován. Po přidání nových obrázků nemusí být vidět okamžitě. Buď počkej, až vyprší [[doku>config:cachetime]], nebo použij parametr ''purge=true'' v URL pro vyprázdnění cache.

Volitelně použij parametr ''nocache'', ale obvykle se to nedoporučuje.