Jak přidat fotky do galerie
jedním řádkem v configu

Stránka galerie.html se negeneruje ručně. Skládá se ze dvou částí:

• data/in/fotky/fotky.cfg — textový seznam fotek. Jeden řádek = jedna fotka (soubor, popis, kategorie, příp. umístění na hl. stránce).
• galerie-VZOR.html / index-VZOR.html — šablony se vším ostatním (hlavička, záložky, struktura stránky). Řešíš je jen při změně designu.

Skript tools/galerie-build.sh z configu a šablon složí galerie.html i hlavní stránku index.html. Pro přidání nebo výměnu fotky tedy stačí upravit řádek v fotky.cfg a skript spustit — žádné HTML.

Fotky v galerii se zobrazují v mřížce, ne na celou obrazovku. Originál z foťáku (klidně 7 MB) je zbytečně velký a zpomalil by web hlavně na mobilu.

Pokud používáš vlastní úpravu (Lightroom, Photoshop…), exportuj rovnou na 1200 px. Jednorázově to zvládne i online nástroj na zmenšení obrázku.

Snímek ulož do zdrojové složky data/in/fotky/ (smí být i v podadresáři, např. 2026/cerven/fotka.jpg). Odtud ho build sám zkopíruje do web/stage/fotky/ — ručně do fotky/ nic nedávej.

Každá fotka má atribut data-cat se slugem kategorie (krátký kód bez diakritiky). Podle něj galerie fotku zařadí pod správný filtr. Slug je shodný s hashtagem kategorie na hlavní stránce.

Otevři data/in/fotky/fotky.cfg a na konec (nebo kam chceš fotku v pořadí) přidej jeden řádek. Tři pole oddělená svislítkem |:

soubor.jpg|alt text|hashtag1 hashtag2 @umisteni

Příklad:

keramicka-dilna-ruce.jpg|Ruce hnětou hlínu na hrnčířském kruhu|neviditelnypribeh

• soubor.jpg — cesta k souboru v data/in/fotky/ (přesně, i velikost písmen; smí mít podadresář).
• alt text — krátký popis fotky (pro čtečky, SEO; ukáže se i pod zvětšenou fotkou).
• hashtagy — slug(y) kategorie z tabulky v kroku 3 (určují, kde je fotka v galerii).
• @umístění — nepovinné; kde se fotka objeví na hlavní stránce (viz box níže).

# reportáž v galerii + 2. fotka v karuselu i v náhledu
na_dune.jpg|Konverzace na duně|svedeknereziser @karusel-2 @nahled-2

# tahle fotka uvádí kartu kategorie „Přirozený portrét"
portret.jpg|Přirozený portrét|esencecloveka @esencecloveka

Fotka může patřit do víc kategorií zároveň (např. focení komunitní akce = reportáž i komunity). Slugy napiš do třetího pole oddělené mezerou:

akce.jpg|Společná oslava klubu|svedeknereziser sdilenacesta

Taková fotka se pak ukáže ve filtru Reportáž i ve filtru Komunity a spolky a samozřejmě i ve „Vše".

Z kořene projektu spusť skript. Ten nejdřív zkontroluje celý config a teprve když je vše v pořádku, přepíše galerie.html i index.html:

# jen kontrola configu (nic nezapíše)
tools/galerie-build.sh --check

# kontrola + složení galerie.html a index.html
tools/galerie-build.sh

Vypíše počet fotek, kolik jich je v které kategorii a přehled @umístění. Pak fotku dostaneš do produkce stejně jako každou jinou změnu ve stage — přes tools/promote.sh --go a tools/deploy.sh --go.

Skript při každém běhu kontroluje a při jakékoli chybě nic nezapíše (vypíše, co je špatně a na kterém řádku):

• řádek má přesně tři pole oddělená |;
• soubor opravdu existuje v data/in/fotky/ (odchytí překlep ve jméně);
• alt text není prázdný;
• každý hashtag je platný slug kategorie (jinak hlásí překlep);
• každé @umístění je platné a počty sedí (@okruh-*/@about právě 1, @nahled násobek 3, @karusel aspoň 2) — jinak index.html nesloží;
• každá kategorie má titulní fotku karty (@<slug>) u právě jedné fotky.

• Fotka zmenšená na 1600–2048 px delší strana, JPG, ~400–800 KB.
• Název souboru bez diakritiky a mezer, uložený do data/in/fotky/.
• Do data/in/fotky/fotky.cfg přidán řádek soubor.jpg|alt|hashtagy @umístění.
• Hashtag = slug kategorie z tabulky (víc kategorií oddělit mezerou); @umístění jen pokud má jít i na hl. stránku.
• Spuštěn tools/galerie-build.sh — bez chyb.
• Ověřeno otevřením galerie.html?kat=<slug> (a u homepage index.html) — fotka je na správném místě.

Někdy chceš galerii, která nepatří do hlavního portfolia: grafika pro sociální sítě, dlouhodobý projekt, nebo galerie k jednomu blogu. To je galerie projektů (ad-hoc): žije samostatně na vlastní adrese /g/<slug>/, ale je dosažitelná z webu (pruh na hlavní stránce, odkaz na stránce Galerie, rozcestník /g/, patička).

Princip je stejný jako u hlavní galerie — složka s configem → build složí stránku — jen je každá galerie ve své vlastní složce a má vlastní jednoduchou stránku (mřížka + lightbox).

Pro každou galerii jedna složka v data/in/galerie/. Jméno složky je slug (malá písmena bez diakritiky a mezer) — objeví se i v URL.

# např. galerie pro grafiku na sociální sítě
data/in/galerie/socialni-grafiky/

Do složky nahraj obrázky — klidně do podsložek (např. 2025/leto/akce.jpg).

Do složky přidej textový soubor galerie.cfg. Nahoře meta — řádky #! klíč: hodnota. Hodnota je celý zbytek řádku (žádné komentáře za hodnotou):

# meta galerie
#! titul:    Sociální grafiky
#! intro:    Grafiky pro Facebook, Instagram a Threads.
#! slug:     socialni-grafiky
#! verejne:  ano
#! homepage: ano
#! cover:    ukazka-1.jpg

Pod meta přidej řádky cesta|popis (třetí pole „tagy" je u galerie projektů nepovinné). Pořadí řádků = pořadí v galerii. Cesta je relativně ke složce galerie.

ukazka-1.jpg|Popisek grafiky
2025/leto/akce.jpg|Z letní akce

# sdílená fotka z hlavní galerie
../../fotky/bar.jpg|Sdílená fotka z hlavní galerie

# jen tahle galerie (rychlé)
tools/galerie-adhoc-build.sh socialni-grafiky

# nebo všechno najednou (hlavní web + všechny galerie projektů)
tools/galerie-build.sh

# jen kontrola, nic nezapíše
tools/galerie-adhoc-build.sh --check

Vznikne web/stage/g/<slug>/index.html (+ složka fotky/ s kopiemi vlastních fotek) a přestaví se rozcestník web/stage/g/index.html. Skript zkontroluje existenci fotek a neprázdné popisky; upozorní na velké soubory.

Galerie je samostatná, ale ne skrytá — vede na ni:

• Rozcestník /g/ — karty všech galerií s verejne: ano.
• Hlavní stránka — pruh „Galerie projektů" (odkaz na rozcestník).
• Stránka Galerie — odkaz „Galerie projektů →" nad patičkou.
• Patička (na index i galerii) — tichý odkaz na /g/.

Stejné nástroje jako u hlavní galerie, jen jim dáš složku galerie jako argument — hodí se při více grafikách najednou:

# doplní nové obrázky do galerie.cfg jako prázdné řádky
tools/fotky-scan.sh data/in/galerie/socialni-grafiky

# tabulka s náhledy → vyplníš popisky v SeaMonkey → zpět
tools/fotky-html.py to-html data/in/galerie/socialni-grafiky
tools/fotky-html.py to-cfg  data/in/galerie/socialni-grafiky

fotky.html vznikne přímo ve složce galerie (vedle galerie.cfg); sdílené fotky ../../fotky/… v ní needituj.

• Složka data/in/galerie/<slug>/ s obrázky.
• galerie.cfg: meta (aspoň titul a verejne: ano) + řádky cesta|popis.
• (volitelně) fotky z hlavní galerie přes ../../fotky/<soubor>.
• Spuštěn tools/galerie-adhoc-build.sh — bez chyb.
• Ověřeno otevřením web/stage/g/<slug>/ a rozcestníku web/stage/g/.