#+TITLE: Doom Emacs — testovací průvodce novými featurami
#+DATE: 2026-02-23
#+STARTUP: showall

* link-hint — rychlá navigace po odkazech
Umožňuje otevřít nebo zkopírovat jakýkoli odkaz v bufferu pomocí avy-style přeskakování.

** Prerekvizity
- =doom sync= proběhl úspěšně
- Buffer obsahuje alespoň jeden odkaz (org link, URL, file path)

** Jak otestovat
1. Otevři libovolný org soubor s odkazy (např. =inbox.org=)
2. Stiskni =SPC j k= — měly by se objevit avy hinty na všech odkazech
3. Vyber hint → odkaz se otevře v prohlížeči/Emacsu
4. Stiskni =SPC j K= → vyber odkaz → URL se zkopíruje do clipboard

** Ověření
- =SPC j k= zobrazí hinty a odkaz se otevře
- =SPC j K= zkopíruje URL (ověř přes =C-y= / paste)

* Avy keybindings — skoky na znaky a řádky
Rozšířené avy bindingy pod =SPC j= pro rychlou navigaci v bufferu.

** Prerekvizity
- =doom sync= proběhl úspěšně

** Jak otestovat
1. Otevři libovolný soubor s textem
2. =SPC j j= → zadej 2 znaky → avy zobrazí hinty na výskytech
3. Vyber hint → kurzor skočí na pozici
4. =SPC j l= → avy zobrazí hinty na řádcích → vyber řádek

** Ověření
- Kurzor se přesune na vybranou pozici

* olivetti-mode — distraction-free psaní
Centruje text na šířku 90 znaků pro pohodlné čtení a psaní.

** Prerekvizity
- =doom sync= proběhl úspěšně

** Jak otestovat
1. Otevři org soubor — olivetti se zapne automaticky (hook)
2. Ověř, že text je vycentrovaný s okraji po stranách
3. Otevři markdown soubor — stejné chování
4. V jiném režimu (např. elisp): =SPC t o= pro manuální toggle

** Ověření
- Org/markdown buffery mají centrovaný text na ~90 znaků
- =SPC t o= zapíná/vypíná olivetti v libovolném bufferu

* org-modern — vizuální vylepšení org-mode
Nahrazuje hvězdičky nadpisů symboly (◉○✸✿), vylepšuje tabulky a checkboxy.

** Prerekvizity
- =doom sync= proběhl úspěšně

** Jak otestovat
1. Otevři org soubor s nadpisy různých úrovní
2. Zkontroluj, že =*= jsou nahrazeny symboly ◉, ○, ✸, ✿
3. Vytvoř tabulku — měla by mít vylepšený vizuální styl
4. Vytvoř checkbox =[X]= / =[ ]= — měl by být stylizovaný

** Ověření
- Nadpisy používají Unicode symboly místo hvězdiček
- Tabulky a checkboxy vypadají vizuálně lépe

* org-fragtog — automatický render LaTeX fragmentů
Při přesunutí kurzoru na/z LaTeX fragmentu se automaticky zobrazí/skryje náhled.

** Prerekvizity
- =doom sync= proběhl úspěšně
- LaTeX nainstalovaný (=latexmk= v PATH)

** Jak otestovat
1. Otevři org soubor a vlož LaTeX fragment: =$E = mc^2$=
2. Přesuň kurzor pryč z fragmentu → měl by se vyrenderovat jako obrázek
3. Přesuň kurzor zpět na fragment → zobrazí se zdrojový kód

** Ověření
- LaTeX fragmenty se automaticky renderují/skrývají při pohybu kurzoru

* org-super-agenda — skupiny v agenda view
Rozděluje agenda view do pojmenovaných skupin: Dnes, Brzy, Čekám, Kyndryl, ZTJ, Ostatní.

** Prerekvizity
- =doom sync= proběhl úspěšně
- Existují org soubory s TODO položkami (různé stavy, tagy, deadlines)

** Jak otestovat
1. Přidej několik TODO s různými vlastnostmi:
   - =TODO= s deadline dnes
   - =TODO= s deadline za 2 dny
   - =WAIT= položka
   - =TODO= s tagem =:kyndryl:=
   - =TODO= s tagem =:ztj:=
2. Otevři agenda: =SPC o A a= (nebo =M-x org-agenda=, volba =a=)
3. Zkontroluj, že položky jsou rozděleny do skupin

** Ověření
- Agenda zobrazuje sekce: Dnes, Brzy, Čekám, Projekt Kyndryl, ZTJ, Ostatní

* org-noter — PDF anotace
Umožňuje vytvářet org poznámky synchronizované s pozicí v PDF dokumentu.

** Prerekvizity
- =doom sync= proběhl úspěšně
- Existuje PDF soubor k anotování

** Jak otestovat
1. Otevři PDF soubor v Emacsu (=pdf-view-mode=)
2. =SPC o n= → spustí org-noter session (vytvoří/otevře org soubor)
3. Naviguj na stránku v PDF
4. =SPC o N= → vloží poznámku na aktuální pozici

** Ověření
- Emacs se rozdělí horizontálně (PDF vlevo, org vpravo)
- Poznámky jsou provázané s pozicí v PDF

* GPTel rewrite — vylepšení textu přes AI
Odešle vybraný region do GPTel s instrukcí "vylepši" a nahradí odpovědí.

** Prerekvizity
- =doom sync= proběhl úspěšně
- Env proměnná =OPENWEBUI_API_KEY= je nastavena
- AI backend (ai.apps.sukany.cz) je dostupný

** Jak otestovat
1. Otevři soubor s textem
2. Označ region (=v= + pohyb v evil normal mode)
3. =SPC o g r= → region se odešle do GPTel → odpověď nahradí region
4. V org souboru: umísti kurzor na heading, =SPC o g p= → heading + obsah se odešle jako kontext do GPTel chatu

** Ověření
- =SPC o g r= nahradí vybraný text vylepšenou verzí
- =SPC o g p= otevře GPTel chat s obsahem heading jako kontextem

* git-link — kopírování URL na Gitea
Generuje webový odkaz na aktuální soubor/řádek v Gitea repozitáři.

** Prerekvizity
- =doom sync= proběhl úspěšně
- Soubor je v git repozitáři s remote na =git.apps.sukany.cz=

** Jak otestovat
1. Otevři soubor v git repozitáři (např. v emacs-doom)
2. =SPC g y= → zkopíruje URL na aktuální soubor/řádek do clipboard
3. =SPC g Y= → zkopíruje URL na aktuální commit

** Ověření
- URL v clipboard ukazuje na =git.apps.sukany.cz/...= a je funkční v prohlížeči

* Forge — Gitea integrace v Magitu
Přidává podporu pro Gitea issues, PRs a notifikace přímo v Magit.

** Prerekvizity
- =doom sync= proběhl úspěšně
- Gitea API token vytvořen a uložen v =~/.authinfo=:
  : machine git.apps.sukany.cz login daneel^forge password <TOKEN>

** Jak otestovat
1. Otevři Magit v repozitáři hostovaném na Gitea: =SPC g g=
2. Stiskni =N= (forge notifications) nebo ='= (forge dispatch)
3. =@ l l= — list issues

** Ověření
- Forge se připojí ke Gitea API a zobrazí issues/PRs
- Pokud token chybí, Forge zobrazí chybu s instrukcí