====== Plugin Gallery ====== ^ Parametr ^ Výchozí hodnota ^ Popis ^ | ''////x////'' | ''%%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. | | ''////X////'' | ''%%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. | | ''////'' | ''0'' | Počet obrázků na řádek v tabulce galerie. Pokud zadáte ''0'', obrázky se přizpůsobí automaticky. | | ''=////'' | ''=0'' | Omezí výstup na daný počet obrázků. ''0'' znamená všechny. | | ''+////'' | ''+0'' | Přeskočí prvních několik obrázků. Užitečné ve spojení s předchozí volbou. | | ''~////'' | ''~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. :jmenny_prostor:obrazek.jpg https://example.com/obrazek2.jpg 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 ''|''. :jmenny_prostor:obrazek.jpg Můj kůň | Podívej se na mého koně, je úžasný! https://example.com/obrazek2.jpg Titulek jen ==== 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.