# Návod k použití — DOXA (v26.07.01)

### Vytvoření nové poznámky

    Klikni na tlačítko ➕ Nová poznámka a zadej název.
    Položka se objeví v seznamu. Klikem načteš název a obsah do editoru nahoře.
    Uprav obsah a klikni Uložit nyní.

## Tagy

Tagy jsou slova nebo fráze, která popisuje obsah poznámky. V aplikaci Doxa díky nim můžete filtrovat poznámky podle tagu.

  * Klikni do pole tagy a zadej název tagu (uloží se stejně s poznámkou).
  * Poznámku pomocí tagu pak vyhledáš v poli s lupou Filtrovat poznámky podle tagu....

### Editace a mazání

    * Inline: klikni na poznámku, uprav obsah a stiskni Uložit nyní.
    * Modal: klikni na ikonu ✎ vedle položky pro pokročilou editaci v modal okně.
    * Mazání: ikona 🗑 u položky — po potvrzení se poznámka smaže.

### Přesouvání pořadí poznámek

    Použij šipky ↑ / ↓ u položek.
    Nebo přetahuj položky (drag & drop) na požadované místo — při přetažení se ukáže indikátor vložení.

### Přepínání vzhledu

V horním menu najdeš tlačítko pro přepínání vzhledu. Aplikace podporuje tři režimy:

    * Světlý — ikona: ☀️
    * Tmavý — ikona: 🌙
    * Respektovat systém — ikona: 🌓 — aplikace bude sledovat systémovou volbu (prefers-color-scheme) a automaticky se přepne, pokud se změní systémový motiv.

Kliknutím na tlačítko v menu cyklíš mezi režimy (Light → Dark → System). Vybraná volba se uloží do localStorage pod klíčem doxa_theme a přetrvá mezi stránkami a obnovami. Pokud chceš volbu resetovat, otevři konzoli prohlížeče a spusť: localStorage.removeItem('doxa_theme') nebo vymaž storage v nástrojích pro vývojáře.

### Automatické ukládání

Aplikace nyní automaticky ukládá změny poznámek lokálně během psaní (autosave). V běžném prohlížeči se změny ukládají do localStorage (klíč doxa_notes_v1) bez nutnosti manuálního ukládání — data se uloží po krátké prodlevě. Pokud aplikaci spouštíš v Electron/Node režimu, změny se zapisují přímo do lokálního souboru.

**Průběžně si úkládej i JSON soubor manuálně!!**

### Manuální uložení

Vedle editoru najdeš tlačítko Uložit nyní. I když autosave ukládá průběžně, tlačítko je užitečné v těchto případech:

    Okamžité uložení — provede persist bez čekání na autosave (užitečné před zavřením aplikace nebo pokud chcete rychlou jistotu, že jsou změny zapsány).
    Vizuální potvrzení — po uložení se zobrazí stav „Uloženo“, což dává uživateli okamžitou zpětnou vazbu.
    Bez stažení — tlačítko Uložit poznámku neprovádí stažení souboru; pokud chcete stáhnout JSON, použijte tlačítko Exportovat JSON.

Pro přenos dat mezi zařízeními použijte tlačítko Exportovat JSON (stáhne soubor doxa.json), nebo z konzole spusťte saveNotesToFile(true).

### Import / Export

Pro import klikni Importovat JSON a vyber soubor. Podporované formáty:

    Objekt s polem notes: { "notes": [ ... ] }
    Přímo pole: [ { ... }, { ... } ]

Export je nyní dostupný přes tlačítko Exportovat JSON (vedle tlačítka Uložit). Aplikace zároveň provádí autosave lokálně — nic neztratíte, pokud zapomenete manuálně uložit. Chcete-li stáhnout JSON přes skript, můžete také spustit v konzoli saveNotesToFile(true).

### Bezpečnost a zálohy

Výchozí režim je local‑first: data zůstávají ve tvém prohlížeči (localStorage) nebo lokálním souboru, aplikace je sama neodesílá.