Doom Emacs — testovací průvodce novými featurami
Obsah
- 1. link-hint — rychlá navigace po odkazech
- 2. Avy keybindings — skoky na znaky a řádky
- 3. olivetti-mode — distraction-free psaní
- 4. org-modern — vizuální vylepšení org-mode
- 5. org-fragtog — automatický render LaTeX fragmentů
- 6. org-super-agenda — skupiny v agenda view
- 7. org-noter — PDF anotace
- 8. GPTel rewrite — vylepšení textu přes AI
- 9. git-link — kopírování URL na Gitea
- 10. Forge — Gitea integrace v Magitu
1. link-hint — rychlá navigace po odkazech
Umožňuje otevřít nebo zkopírovat jakýkoli odkaz v bufferu pomocí avy-style přeskakování.
1.1. Prerekvizity
doom syncproběhl úspěšně- Buffer obsahuje alespoň jeden odkaz (org link, URL, file path)
1.2. Jak otestovat
- Otevři libovolný org soubor s odkazy (např.
inbox.org) - Stiskni
SPC j k— měly by se objevit avy hinty na všech odkazech - Vyber hint → odkaz se otevře v prohlížeči/Emacsu
- Stiskni
SPC j K→ vyber odkaz → URL se zkopíruje do clipboard
1.3. Ověření
SPC j kzobrazí hinty a odkaz se otevřeSPC j Kzkopíruje URL (ověř přesC-y/ paste)
2. Avy keybindings — skoky na znaky a řádky
Rozšířené avy bindingy pod SPC j pro rychlou navigaci v bufferu.
2.1. Prerekvizity
doom syncproběhl úspěšně
2.2. Jak otestovat
- Otevři libovolný soubor s textem
SPC j j→ zadej 2 znaky → avy zobrazí hinty na výskytech- Vyber hint → kurzor skočí na pozici
SPC j l→ avy zobrazí hinty na řádcích → vyber řádek
2.3. Ověření
- Kurzor se přesune na vybranou pozici
3. olivetti-mode — distraction-free psaní
Centruje text na šířku 90 znaků pro pohodlné čtení a psaní.
3.1. Prerekvizity
doom syncproběhl úspěšně
3.2. Jak otestovat
- Otevři org soubor — olivetti se zapne automaticky (hook)
- Ověř, že text je vycentrovaný s okraji po stranách
- Otevři markdown soubor — stejné chování
- V jiném režimu (např. elisp):
SPC t opro manuální toggle
3.3. Ověření
- Org/markdown buffery mají centrovaný text na ~90 znaků
SPC t ozapíná/vypíná olivetti v libovolném bufferu
4. org-modern — vizuální vylepšení org-mode
Nahrazuje hvězdičky nadpisů symboly (◉○✸✿), vylepšuje tabulky a checkboxy.
4.1. Prerekvizity
doom syncproběhl úspěšně
4.2. Jak otestovat
- Otevři org soubor s nadpisy různých úrovní
- Zkontroluj, že
*jsou nahrazeny symboly ◉, ○, ✸, ✿ - Vytvoř tabulku — měla by mít vylepšený vizuální styl
- Vytvoř checkbox
[X]/[ ]— měl by být stylizovaný
4.3. Ověření
- Nadpisy používají Unicode symboly místo hvězdiček
- Tabulky a checkboxy vypadají vizuálně lépe
5. org-fragtog — automatický render LaTeX fragmentů
Při přesunutí kurzoru na/z LaTeX fragmentu se automaticky zobrazí/skryje náhled.
5.1. Prerekvizity
doom syncproběhl úspěšně- LaTeX nainstalovaný (
latexmkv PATH)
5.2. Jak otestovat
- Otevři org soubor a vlož LaTeX fragment:
$E = mc^2$ - Přesuň kurzor pryč z fragmentu → měl by se vyrenderovat jako obrázek
- Přesuň kurzor zpět na fragment → zobrazí se zdrojový kód
5.3. Ověření
- LaTeX fragmenty se automaticky renderují/skrývají při pohybu kurzoru
6. org-super-agenda — skupiny v agenda view
Rozděluje agenda view do pojmenovaných skupin: Dnes, Brzy, Čekám, Kyndryl, ZTJ, Ostatní.
6.1. Prerekvizity
doom syncproběhl úspěšně- Existují org soubory s TODO položkami (různé stavy, tagy, deadlines)
6.2. Jak otestovat
- Přidej několik TODO s různými vlastnostmi:
TODOs deadline dnesTODOs deadline za 2 dnyWAITpoložkaTODOs tagem:kyndryl:TODOs tagem:ztj:
- Otevři agenda:
SPC o A a(neboM-x org-agenda, volbaa) - Zkontroluj, že položky jsou rozděleny do skupin
6.3. Ověření
- Agenda zobrazuje sekce: Dnes, Brzy, Čekám, Projekt Kyndryl, ZTJ, Ostatní
7. org-noter — PDF anotace
Umožňuje vytvářet org poznámky synchronizované s pozicí v PDF dokumentu.
7.1. Prerekvizity
doom syncproběhl úspěšně- Existuje PDF soubor k anotování
7.2. Jak otestovat
- Otevři PDF soubor v Emacsu (
pdf-view-mode) SPC o n→ spustí org-noter session (vytvoří/otevře org soubor)- Naviguj na stránku v PDF
SPC o N→ vloží poznámku na aktuální pozici
7.3. Ověření
- Emacs se rozdělí horizontálně (PDF vlevo, org vpravo)
- Poznámky jsou provázané s pozicí v PDF
8. GPTel rewrite — vylepšení textu přes AI
Odešle vybraný region do GPTel s instrukcí "vylepši" a nahradí odpovědí.
8.1. Prerekvizity
doom syncproběhl úspěšně- Env proměnná
OPENWEBUI_API_KEYje nastavena - AI backend (ai.apps.sukany.cz) je dostupný
8.2. Jak otestovat
- Otevři soubor s textem
- Označ region (
v+ pohyb v evil normal mode) SPC o g r→ region se odešle do GPTel → odpověď nahradí region- V org souboru: umísti kurzor na heading,
SPC o g p→ heading + obsah se odešle jako kontext do GPTel chatu
8.3. Ověření
SPC o g rnahradí vybraný text vylepšenou verzíSPC o g potevře GPTel chat s obsahem heading jako kontextem
9. git-link — kopírování URL na Gitea
Generuje webový odkaz na aktuální soubor/řádek v Gitea repozitáři.
9.1. Prerekvizity
doom syncproběhl úspěšně- Soubor je v git repozitáři s remote na
git.apps.sukany.cz
9.2. Jak otestovat
- Otevři soubor v git repozitáři (např. v emacs-doom)
SPC g y→ zkopíruje URL na aktuální soubor/řádek do clipboardSPC g Y→ zkopíruje URL na aktuální commit
9.3. Ověření
- URL v clipboard ukazuje na
git.apps.sukany.cz/...a je funkční v prohlížeči
10. Forge — Gitea integrace v Magitu
Přidává podporu pro Gitea issues, PRs a notifikace přímo v Magit.
10.1. Prerekvizity
doom syncproběhl úspěšněGitea API token vytvořen a uložen v
~/.authinfo:machine git.apps.sukany.cz login daneel^forge password <TOKEN>
10.2. Jak otestovat
- Otevři Magit v repozitáři hostovaném na Gitea:
SPC g g - Stiskni
N(forge notifications) nebo'(forge dispatch) @ l l— list issues
10.3. Ověření
- Forge se připojí ke Gitea API a zobrazí issues/PRs
- Pokud token chybí, Forge zobrazí chybu s instrukcí