docs: testing guide for new Doom Emacs features (link-hint, olivetti, org-modern, etc.)

notes/emacs-new-features.org

@@ -0,0 +1,169 @@
+#+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í