docs: review opravy (Opus) — keybindings Evil/Doom, diakritika, faktická správnost

This commit is contained in:
2026-02-24 23:09:03 +01:00
parent 8bdd710e4c
commit b9b8fc3204
2 changed files with 125 additions and 125 deletions

View File

@@ -129,7 +129,7 @@ Viz =[[file:../examples/perl/example.pl][examples/perl/example.pl]]= — demonst
#+begin_src bash #+begin_src bash
brew install python ruff pyright brew install python ruff pyright
pip install pyvenv # volitelné, pro virtualenv management # Pro virtualenv: použij M-x poetry nebo conda (pyvenv je zastaralé)
#+end_src #+end_src
** Keybindings ** Keybindings
@@ -145,9 +145,9 @@ pip install pyvenv # volitelné, pro virtualenv management
** Příklad workflow ** Příklad workflow
1. Otevři projekt: =SPC p p= → vyber Python projekt 1. Otevři projekt: =SPC p p= → vyber Python projekt
2. Virtual env: =M-x pyvenv-activate= → vyber venv adresář 2. Virtual env: =M-x poetry= nebo =conda-env-activate= → aktivuj prostředí
3. Navigace: =SPC s i= pro přehled tříd a funkcí 3. Navigace: =SPC s i= pro přehled tříd a funkcí
4. LSP: =gd= (definice), =K= (docs), =gr= (references) 4. LSP: =gd= (definice), =K= (docs), =SPC c D= (references)
5. Format: =SPC m f= — ruff format na celý soubor 5. Format: =SPC m f= — ruff format na celý soubor
6. Run: =SPC m r= — spustí =python3 buffer.py= v compile bufferu 6. Run: =SPC m r= — spustí =python3 buffer.py= v compile bufferu
7. Debug: =M-x pdb= → zadej =python3 -m pdb soubor.py= 7. Debug: =M-x pdb= → zadej =python3 -m pdb soubor.py=

View File

@@ -1,207 +1,207 @@
#+TITLE: Nove featury Doom Emacs -- testovaci pruvodce #+TITLE: Nové featury Doom Emacs -- testovací průvodce
#+include: ~/org/templates/document_personal.org #+include: ~/org/templates/document_personal.org
Tento dokument popisuje vsechny nove featury pridane do konfigurace. Tento dokument popisuje všechny nové featury přidané do konfigurace.
Po kazde zmene je nutny =doom sync= + restart Emacsu. Po každé změně je nutný =doom sync= + restart Emacsu.
* Prerekvizity * Prerekvizity
Nez testuje cokoli: Než testuješ cokoli:
#+begin_src sh #+begin_src sh
cd ~/.doom.d cd ~/.doom.d
doom sync doom sync
#+end_src #+end_src
Pak restartuj Emacs. Bez toho nove balicky nejsou dostupne. Pak restartuj Emacs. Bez toho nové balíčky nejsou dostupné.
* 1. link-hint -- otevirani odkazu bez mysi * 1. link-hint -- otevírání odkazů bez myši
Co dela: zvyrazni vsechny viditelne org-format odkazy v bufferu a prirad jim Co dělá: zvýrazní všechny viditelné org-format odkazy v bufferu a přiřadí jim
jednopismenne zkratky. Stisknutim pismene odkaz otevres nebo zkopirujes URL. jednopísmenné zkratky. Stisknutím písmene odkaz otevřeš nebo zkopíruješ URL.
Prerekvizita: =doom sync= dokoncen, soubor musi obsahovat =[[...]]= odkazy. Prerekvizita: =doom sync= dokončen, soubor musí obsahovat =[[...]]= odkazy.
Jak testovat: Jak testovat:
1. Otevri org soubor ktery ma =[[https://example.com]]= nebo =[[file:inbox.org]]= odkazy 1. Otevři org soubor který má =[[https://example.com]]= nebo =[[file:inbox.org]]= odkazy
2. Stiskni =SPC j k= -- link-hint zvyrazni viditelne odkazy 2. Stiskni =SPC j k= -- link-hint zvýrazní viditelné odkazy
3. Stiskni pismeno vedle odkazu -- odkaz se otevri 3. Stiskni písmeno vedle odkazu -- odkaz se otevře
4. Pro kopiovani URL: =SPC j K= 4. Pro kopírování URL: =SPC j K=
*Dulezite:* 'No links' je spravna hlaska kdyz buffer nema zadny =[[...]]= odkaz *Důležité:* 'No links' je správná hláška když buffer nemá žádný =[[...]]= odkaz
viditelny na obrazovce. Index.org bez explicitu odkazu = zadne linky. Funguje viditelný na obrazovce. Index.org bez explicitních odkazů = žádné linky. Funguje
spravne -- neni to chyba. správně -- není to chyba.
Priklady odkazu ktere link-hint najde: Příklady odkazů které link-hint najde:
- =[[https://example.com][Odkaz]]= -- HTTP odkaz - =[[https://example.com][Odkaz]]= -- HTTP odkaz
- =[[file:inbox.org]]= -- soubor - =[[file:inbox.org]]= -- soubor
- =[[*Nadpis]]= -- interni odkaz v dokumentu - =[[*Nadpis]]= -- interní odkaz v dokumentu
* 2. Avy -- skok na libovolne misto v bufferu * 2. Avy -- skok na libovolné místo v bufferu
Co dela: zvyrazni kazdy vyskyt dvou zadanych znaku a skoci na vybrane Co dělá: zvýrazní každý výskyt dvou zadaných znaků a skočí na vybrané
misto bez pohybu mysi. místo bez pohybu myši.
Prerekvizita: Doom ma avy automaticky -- dostupny bez doom sync. Prerekvizita: Doom má avy automaticky -- dostupný bez doom sync.
Jak testovat: Jak testovat:
1. Otevri soubor s textem 1. Otevři soubor s textem
2. Stiskni =SPC j j= -- zadej dva znaky (napr. =th=) -- Avy zvyrazni shody 2. Stiskni =SPC j j= -- zadej dva znaky (např. =th=) -- Avy zvýrazní shody
3. Stiskni pismeno u ciloveho vyskytu -- kurzor skoci tam 3. Stiskni písmeno u cílového výskytu -- kurzor skočí tam
4. Pro skok na radek: =SPC j l= -- zadej pismeno u radku 4. Pro skok na řádek: =SPC j l= -- zadej písmeno u řádku
Overeni: kurzor preskoci na vybranou pozici bez scrollovani. Ověření: kurzor přeskočí na vybranou pozici bez scrollování.
* 3. olivetti-mode -- klidny distraction-free mod * 3. olivetti-mode -- klidný distraction-free mód
Co dela: horizontalne centruje text na sirku 90 znaku. Zapina se *rucne* -- Co dělá: horizontálně centruje text na šířku 90 znaků. Zapíná se *ručně* --
automaticke zapinani by rozbilo corfu completion popup. automatické zapínání by rozbilo corfu completion popup.
Prerekvizita: =doom sync=, balik =olivetti= nainstalovan. Prerekvizita: =doom sync=, balík =olivetti= nainstalován.
Jak testovat: Jak testovat:
1. Otevri org nebo Markdown soubor 1. Otevři org nebo Markdown soubor
2. Stiskni =SPC t o= -- text se vycentruje na stred okna 2. Stiskni =SPC t o= -- text se vycentruje na střed okna
3. Stiskni =SPC t o= znovu -- vrati se do normalniho layoutu 3. Stiskni =SPC t o= znovu -- vrátí se do normálního layoutu
*Upozorneni:* Pokud zapnes olivetti a corfu popup zmizi nebo se zobrazi *Upozornění:* Pokud zapneš olivetti a corfu popup zmizí nebo se zobrazí
mimo obrazovku, vypni olivetti. Olivetti meni vizualni marginy a corfu mimo obrazovku, vypni olivetti. Olivetti mění vizuální marginy a corfu
pak pocita spatne souradnice popupu. pak počítá špatné souřadnice popupu.
* 4. org-modern -- vylepseny vizual org-mode * 4. org-modern -- vylepšený vizuál org-mode
Co dela: nahradi hvezdicky u nadpisu Unicode symboly (okrouhlymi tvary), Co dělá: nahradí hvězdičky u nadpisů Unicode symboly (okrouhlými tvary),
zvyrazni checkboxy. Aktivuje se automaticky po loadu org-modern balicku. zvýrazní checkboxy. Aktivuje se automaticky po loadu org-modern balíčku.
Prerekvizita: =doom sync=, balik =org-modern= nainstalovan. Prerekvizita: =doom sync=, balík =org-modern= nainstalován.
Jak testovat: Jak testovat:
1. Otevri libovolny =.org= soubor (napr. inbox.org) 1. Otevři libovolný =.org= soubor (např. inbox.org)
2. Nadpisy by mely mit jinak vyzerajici hvezdicky 2. Nadpisy by měly mít jinak vypadající hvězdičky
3. Checkboxy =[ ]= a =[X]= vypadaji jinak 3. Checkboxy =[ ]= a =[X]= vypadají jinak
Pokud org-modern nefunguje na uz otevreny soubor: spust =M-x org-modern-mode= Pokud org-modern nefunguje na už otevřený soubor: spusť =M-x org-modern-mode=
rucne nebo zavre a znovu otevri soubor. Konfigu zajistuje aktivaci i pro uz ručně nebo zavři a znovu otevři soubor. Konfigurace zajišťuje aktivaci i pro už
otevrene buffery pri loadu balicku. otevřené buffery při loadu balíčku.
Overeni org exportu (klicove): Ověření org exportu (klíčové):
1. Otevri org soubor s tabulkou a nadpisy 1. Otevři org soubor s tabulkou a nadpisy
2. =SPC m e l o= nebo =C-c C-e l o= -- PDF export 2. =SPC m e l o= nebo =C-c C-e l o= -- PDF export
3. Export musi probehnou bez chyby 3. Export musí proběhnout bez chyby
4. =org-modern-table= je vypnuto -- tabulkove overlaye by mohly interferovat 4. =org-modern-table= je vypnuto -- tabulkové overlaye by mohly interferovat
* 5. org-fragtog -- automaticky nahled LaTeX fragmentu * 5. org-fragtog -- automatický náhled LaTeX fragmentů
Co dela: kdyz kurzor vstoupi do LaTeX fragmentu (=$E=mc^2$=), zobrazi Co dělá: když kurzor vstoupí do LaTeX fragmentu (=$E=mc^2$=), zobrazí
ho jako obrazek; kdyz kurzor odejde, fragment zustane jako obrazek. ho jako obrázek; když kurzor odejde, fragment zůstane jako obrázek.
Prerekvizita: =doom sync=, =org-fragtog= nainstalovan, funkci =dvipng= Prerekvizita: =doom sync=, =org-fragtog= nainstalován, funkční =dvipng=
nebo =imagemagick=: =brew install imagemagick=. nebo =imagemagick=: =brew install imagemagick=.
Jak testovat: Jak testovat:
1. Otevri org soubor 1. Otevři org soubor
2. Napis =$E = mc^2$= 2. Napiš =$E = mc^2$=
3. Pohni kurzorem ven z fragmentu -- mel by se zobrazit jako obrazek 3. Pohni kurzorem ven z fragmentu -- měl by se zobrazit jako obrázek
4. Pohni kurzorem dovnitr -- obrazek zmizi, zobrazi se zdrojovy kod 4. Pohni kurzorem dovnitř -- obrázek zmizí, zobrazí se zdrojový kód
Pokud dvipng neni dostupny, org-fragtog selze tise. Zkontroluj: Pokud dvipng není dostupný, org-fragtog selže tiše. Zkontroluj:
=M-x org-toggle-latex-fragment= =M-x org-toggle-latex-fragment=
* 6. org-super-agenda -- skupiny v agenda view * 6. org-super-agenda -- skupiny v agenda view
Co dela: rozdeli org agenda view do skupin: Dnes, Cekam, Kyndryl, ZTJ, Ostatni. Co dělá: rozdělí org agenda view do skupin: Dnes, Čekám, Kyndryl, ZTJ, Ostatní.
Prerekvizita: =doom sync=, =org-super-agenda= nainstalovan. Prerekvizita: =doom sync=, =org-super-agenda= nainstalován.
Skupiny: Skupiny:
- *Dnes*: polozky se SCHEDULED nebo DEADLINE dnes - *Dnes*: položky se SCHEDULED nebo DEADLINE dnes
- *Cekam*: polozky s TODO stavem WAIT - *Čekám*: položky s TODO stavem WAIT
- *Kyndryl*: tag =:kyndryl:= nebo =:work:= - *Kyndryl*: tag =:kyndryl:= nebo =:work:=
- *ZTJ*: tag =:ztj:= - *ZTJ*: tag =:ztj:=
- *Ostatni*: vsechno co nezapadne do predchozich skupin - *Ostatní*: všechno co nezapadne do předchozích skupin
Jak testovat: Jak testovat:
1. Otevri org agenda: =SPC o A= nebo =C-c a a= 1. Otevři org agendu: =SPC o A= nebo =C-c a a=
2. Agenda by mela zobrazovat skupiny s nazvy 2. Agenda by měla zobrazovat skupiny s názvy
3. Polozky s TODO =WAIT= ve skupine "Cekam" 3. Položky s TODO =WAIT= ve skupině "Čekám"
*Pokud agenda zobrazuje prazdnou stranku:* Spust =M-x org-super-agenda-mode= *Pokud agenda zobrazuje prázdnou stránku:* Spusť =M-x org-super-agenda-mode=
pro aktivaci, nebo zkontroluj ze =doom sync= byl dokoncen. pro aktivaci, nebo zkontroluj že =doom sync= byl dokončen.
* 7. org-noter -- anotace PDF v org-mode * 7. org-noter -- anotace PDF v org-mode
Co dela: propojuje PDF soubor s org souborem poznamek. Strankovani je synchronizovano. Co dělá: propojuje PDF soubor s org souborem poznámek. Stránkování je synchronizováno.
Prerekvizita: =doom sync=, =org-noter= nainstalovan, PDF otvira se v pdf-view. Prerekvizita: =doom sync=, =org-noter= nainstalován, PDF otevírá se v pdf-view.
Jak testovat: Jak testovat:
1. Otevri PDF soubor -- mel by se otevrit v pdf-view, ne v Preview 1. Otevři PDF soubor -- měl by se otevřít v pdf-view, ne v Preview
2. Stiskni =SPC o n= -- spusti org-noter session 2. Stiskni =SPC o n= -- spustí org-noter session
3. Posouvej PDF -- org soubor se synchronizuje s aktualni strankou 3. Posouvej PDF -- org soubor se synchronizuje s aktuální stránkou
4. Pridej poznamku: =SPC o N= -- vlozi org heading s pozici v PDF 4. Přidej poznámku: =SPC o N= -- vloží org heading s pozicí v PDF
Overeni: org heading obsahuje =:NOTER_PAGE:= property. Ověření: org heading obsahuje =:NOTER_PAGE:= property.
* 8. GPTel -- rewrite regionu a org heading * 8. GPTel -- rewrite regionu a org heading
Co dela: Co dělá:
- =SPC o g r= -- posle oznaceny region do GPTel s instrukci "vyleps text" - =SPC o g r= -- pošle označený region do GPTel s instrukcí "vylepši text"
a nahradi ho odpovedi a nahradí ho odpovědí
- =SPC o g p= -- posle obsah aktualu org headingu jako kontext do GPTel chatu - =SPC o g p= -- pošle obsah aktuálního org headingu jako kontext do GPTel chatu
Prerekvizita: gptel funkci (=SPC o g g= otevira chat). Prerekvizita: gptel funguje (=SPC o g g= otevírá chat).
Jak testovat (rewrite): Jak testovat (rewrite):
1. Otevri soubor s textem 1. Otevři soubor s textem
2. Oznac region (visual mode: =v=) 2. Označ region (visual mode: =v=)
3. =SPC o g r= -- pockat -- region se nahradi vylepsenim 3. =SPC o g r= -- počkat -- region se nahradí vylepšením
4. Zprava: =GPTel: text vylepsen= v minibufferu 4. Zpráva: =GPTel: text vylepšen= v minibufferu
Jak testovat (org heading): Jak testovat (org heading):
1. Otevri org soubor 1. Otevři org soubor
2. Postav kurzor do headingu 2. Postav kurzor do headingu
3. =SPC o g p= -- obsah headingu odeslan do GPTel chatu 3. =SPC o g p= -- obsah headingu odeslán do GPTel chatu
* 9. git-link -- kopiovani URL na Gitea * 9. git-link -- kopírování URL na Gitea
Co dela: zkopiruje URL aktualniho souboru/radku na Gitea do clipboardu. Co dělá: zkopíruje URL aktuálního souboru/řádku na Gitea do clipboardu.
Prerekvizita: =doom sync=, soubor musi byt v git repo s remote na Gitea. Prerekvizita: =doom sync=, soubor musí být v git repo s remote na Gitea.
Jak testovat: Jak testovat:
1. Otevri soubor v emacs-doom nebo jinem Gitea repo 1. Otevři soubor v emacs-doom nebo jiném Gitea repo
2. Postav kurzor na konkretni radek 2. Postav kurzor na konkrétní řádek
3. =SPC g y= -- URL zkopirovna do clipboardu 3. =SPC g y= -- URL zkopírována do clipboardu
4. Zkontroluj: =pbpaste= v terminalu 4. Zkontroluj: =pbpaste= v terminálu
Overeni: URL odpovida aktualnimu souboru a radku na git.apps.sukany.cz. Ověření: URL odpovídá aktuálnímu souboru a řádku na git.apps.sukany.cz.
* 10. Forge -- Gitea integrace v Magit * 10. Forge -- Gitea integrace v Magit
Co dela: pridava pull request a issue management do Magit. Co dělá: přidává pull request a issue management do Magit.
Prerekvizita: =doom sync=, API token v =~/.authinfo=. Prerekvizita: =doom sync=, API token v =~/.authinfo=.
Nastaveni tokenu: Nastavení tokenu:
1. Prihlasit se na =https://git.apps.sukany.cz= 1. Přihlásit se na =https://git.apps.sukany.cz=
2. Settings -> Applications -> Generate new token (scope: =repo=) 2. Settings -> Applications -> Generate new token (scope: =repo=)
3. Pridat do =~/.authinfo=: 3. Přidat do =~/.authinfo=:
: machine git.apps.sukany.cz login daneel^forge password <TOKEN> : machine git.apps.sukany.cz login daneel^forge password <TOKEN>
4. =chmod 600 ~/.authinfo= 4. =chmod 600 ~/.authinfo=
Jak testovat: Jak testovat:
1. Otevri Magit: =SPC g g= 1. Otevři Magit: =SPC g g=
2. Stiskni =@= -- Forge menu 2. Stiskni =@= -- Forge menu
3. =@ f= -- fetch forge data (PRy, issues) 3. =@ f= -- fetch forge data (PRy, issues)
*Poznamka:* Bez tokenu Forge selze s chybou autentizace (ocekavane chovani). *Poznámka:* Bez tokenu Forge selže s chybou autentizace (očekávané chování).
* Prehled klaves * Přehled kláves
| Klavesa | Funkce | | Klávesa | Funkce |
|-----------+-------------------------------| |-----------+-------------------------------|
| SPC j k | link-hint -- otevri odkaz | | SPC j k | link-hint -- otevři odkaz |
| SPC j K | link-hint -- kopiruj URL | | SPC j K | link-hint -- kopíruj URL |
| SPC j j | avy-goto-char-2 | | SPC j j | avy-goto-char-2 |
| SPC j l | avy-goto-line | | SPC j l | avy-goto-line |
| SPC t o | olivetti-mode toggle | | SPC t o | olivetti-mode toggle |
@@ -209,25 +209,25 @@ Jak testovat:
| SPC o N | org-noter-insert-note | | SPC o N | org-noter-insert-note |
| SPC o g r | GPTel rewrite region | | SPC o g r | GPTel rewrite region |
| SPC o g p | GPTel org heading -> kontext | | SPC o g p | GPTel org heading -> kontext |
| SPC g y | git-link (kopiruj URL) | | SPC g y | git-link (kopíruj URL) |
| SPC g Y | git-link-commit | | SPC g Y | git-link-commit |
* Reseni problemu * Řešení problémů
** link-hint rika 'No links' ** link-hint říká 'No links'
Normalni chovani kdyz buffer nema zadny =[[...]]= odkaz viditelny na obrazovce. Normální chování když buffer nemá žádný =[[...]]= odkaz viditelný na obrazovce.
Testuj na org souboru ktery obsahuje =[[https://...]]= nebo =[[file:...]]= linky. Testuj na org souboru který obsahuje =[[https://...]]= nebo =[[file:...]]= linky.
** corfu nefunguje po olivetti ** corfu nefunguje po olivetti
Vypni olivetti (=SPC t o=). Olivetti meni vizualni marginy, corfu popup pak Vypni olivetti (=SPC t o=). Olivetti mění vizuální marginy, corfu popup pak
ma spatne souradnice. má špatné souřadnice.
** org-modern nefunguje ** org-modern nefunguje
Spust =doom sync= + restartuj Emacs. Pokud stale ne: =M-x org-modern-mode= Spusť =doom sync= + restartuj Emacs. Pokud stále ne: =M-x org-modern-mode=
nebo zavre a otevri soubor znovu. nebo zavři a otevři soubor znovu.
** org export selze s Unicode varovanim ** org export selže s Unicode varováním
Zkontroluj svuj .org soubor na Unicode znaky mimo Latin-1: Zkontroluj svůj .org soubor na Unicode znaky mimo Latin-1:
#+begin_src sh #+begin_src sh
python3 -c " python3 -c "
with open('tvuj-soubor.org') as f: with open('tvuj-soubor.org') as f:
@@ -238,14 +238,14 @@ with open('tvuj-soubor.org') as f:
break break
" "
#+end_src #+end_src
Smazani nebo nahrazeni techto znaku vyresi problem. Smazání nebo nahrazení těchto znaků vyřeší problém.
** org-super-agenda zobrazuje prazdnou agendu ** org-super-agenda zobrazuje prázdnou agendu
Spust =M-x org-super-agenda-mode= pro rucni aktivaci. Spusť =M-x org-super-agenda-mode= pro ruční aktivaci.
Zkontroluj ze org soubory maji polozky se SCHEDULED nebo DEADLINE. Zkontroluj že org soubory mají položky se SCHEDULED nebo DEADLINE.
** Forge: 'Invalid token' ** Forge: 'Invalid token'
Zkontroluj format =~/.authinfo= -- zadne uvozovky, zadne mezery navic: Zkontroluj formát =~/.authinfo= -- žádné uvozovky, žádné mezery navíc:
: machine git.apps.sukany.cz login daneel^forge password TOKEN : machine git.apps.sukany.cz login daneel^forge password TOKEN
* emacs-new-features * emacs-new-features
:PROPERTIES: :PROPERTIES: