# Podrobný manuál k aplikaci Živé vzpomínky na dovolenou

Tento manuál poskytuje podrobné technické a uživatelské informace o fungování aplikace, možnostech importu fotografií a způsobu publikace vygenerovaných map.

---

## 1. Důležitý předpoklad: Geolokace (GPS) při focení

Pro správné fungování automatického mapování a stahování informací z Wikipedie je nezbytné, aby vaše fotografie obsahovaly **GPS EXIF metadata**.

### Jak zajistit uložení GPS do fotografií?
- **Chytré telefony (Android / iOS):** V nastavení fotoaparátu musíte mít povoleno **ukládání polohy (geotagging)**. Dále je nutné mít v telefonu při focení zapnuté polohové služby (GPS).
- **Klasické fotoaparáty:** Pokud váš fotoaparát nemá vestavěný GPS modul, fotografie nebudou obsahovat souřadnice. V takovém případě můžete souřadnice k bodům v aplikaci přidat ručně nebo použít externí GPS tracker a data spárovat předem (např. přes GPX soubory).

---

## 2. Nahrání (import) fotografií

Aplikace pracuje s **lokální složkou** ve vašem počítači, kde máte uložené fotografie. 

### Jak použít fotky z Google Fotek nebo cloudu?
Chcete-li použít fotky z Google Fotek, stáhněte si je nejprve lokálně do počítače:
1. **Ruční stažení:** Označte fotky na webu Google Fotky a stáhněte je (při ručním stažení z webu Google GPS data v EXIFu ponechává).
2. **Google Takeout:** Pro stažení celých alb můžete použít nástroj [Google Takeout](https://takeout.google.com/).
3. Vybalte stažené soubory do složky na svém počítači a tuto složku následně zvolte v aplikaci.

### Jak import z lokální složky funguje?
Zvolíte složku ve svém počítači a aplikace:
1. Prohledá složku a najde všechny soubory `.jpg` a `.jpeg`.
2. Načte z nich GPS souřadnice a čas pořízení.
3. **Optimalizace (Downscaling):** Původní fotky z fotoaparátů mají často velikost přes 10 MB. Aplikace automaticky vytvoří optimalizované verze:
   - **Webové verze:** Zmenší snímky na max. rozměr 1600 px s optimální kompresí pro web (cca 300–500 KB).
   - **Miniatury (Thumbnails):** Vytvoří malé náhledy o velikosti 300 px (cca 30 KB) pro rychlé zobrazení na mapě.

---

## 3. Export na web a jeho fungování

Jakmile dokončíte úpravy itineráře a popisků v Kroku 3, přichází na řadu export.

### Jak funguje vygenerovaný web (Static Site)?
Aplikace nevyžaduje žádný databázový server ani backend. Generuje tzv. **statický web**, který se skládá z:
- `index.html` – Struktura stránky.
- `style.css` – Responzivní vzhled (přizpůsobí se mobilům i počítačům) podle vybraného barevného schématu.
- `script.js` – Logika interaktivní mapy postavené na bezplatné knihovně **Leaflet.js** a vykreslení trasy.
- `data.js` – Veškerá textová data, souřadnice zastávek a odkazy na fotky.
- složky `fotky/` – Optimalizované webové verze snímků a jejich miniatury.

### Zabezpečení stránek heslem (Klientské AES-256 šifrování)
Pokud zaškrtnete možnost "Zamknout stránku heslem", vaše soukromá data budou chráněna:
1. Veškerý obsah souboru `data.js` se před uložením zašifruje pomocí symetrického šifrovacího algoritmu **AES-256** s vaším heslem.
2. Na vygenerovaném webu se bez zadání hesla nezobrazí mapa, fotky ani texty, protože prohlížeč nemá jak data dešifrovat.
3. Dešifrování probíhá lokálně v prohlížeči návštěvníka po zadání správného hesla. Vaše heslo se nikam neposílá.

### Možnosti bezplatného publikování na internetu
Vygenerovanou složku můžete prohlížet offline přímo ve svém počítači poklepáním na soubor `index.html`. Pokud ji chcete ukázat přátelům na internetu, můžete využít bezplatné služby:

1. **Netlify Drop (Doporučeno & Integrováno):**
   - Aplikace v posledním kroku automaticky vytvoří ze složky webu ZIP archiv.
   - Otevře vám webové rozhraní Netlify Drop, kam stačí tento ZIP soubor jednoduše přetáhnout myší (Drag & Drop).
   - Během několika sekund získáte veřejnou adresu (např. `moje-dovolena.netlify.app`), kterou můžete poslat známým.
2. **Cloudflare Pages:**
   - Podobná služba nabízející neomezený přenos dat zdarma. Složku lze rovněž nahrát přetažením v administraci Cloudflare.
