Tukaj se nahaja celotna konfiguracija za emacs urejevalnik, ki jo uporabljam, v ORG obliki. Na ta - "literate programming" oz. pismeni način - podana konfiguracija daje v ospredje opis posameznih sekcij in s tem poveča preglednost, olajša pa tudi navigacijo po konfiguraciji.
Razdeljena je na poglavja ohlapno glede na vlogo oz področje. Področja so nekoliko raznosvrstna (evil način - tipkovnične bližnjice v slogu VIM so ena sekcija, programiranje druga...), bi pa moralo biti iz naslovov precej jasno, za kaj gre.
S paketom ~general~ je definiranih več kategorij tipkovničnih bližnjic, ki so združene po svoji funkciji, podobno kot poglavja tega dokumenta. Če v ukaznem načinu kliknemo ~SPC~ (ali pa v tekstovnem načinu ~C-SPC~), se nam prikažejo tipke kategorij, po kliku na posamezno pa ukazi, ki jih sprožimo (ali pa podkategorije).
V sledečim podpoglavjih so navedene kategorije posameznih bližnjic. Imajo dokaj samoopisna imena. Paket ~which key~ sproti izpisuje, kaj kateri gumb počne oz. kam nas pelje dalje.
Navigacijo med okni izvajamo s klasičnimi HJKL UNIX smernimi tipkami, recimo okno pod trenutnim izberemo s ~SPC w j~. Posamezno okno pa lahko razdvojimo vertikalno ali horizontalno s ~SPC w v~ oz. ~SPC w s~. ~SPC w d~ "ubije" trenutni buffer in okno.
Emacs nudi kup uporabnih funkcij, ki so nepogrešljive na poti učenja o funkcionalnosti. Zaenkrat sem definiral bližnjice do štirih od njih; opis funkcije, tipke, simbola (to so recimo rezervirana imena spremenljivk), načina (~mode~).
~swiper~ je ivy-jev iskalnik po bufferjih, ki nudi lep vmesnik s predogledom rezultatov, nastavimo ga na ~C-S~.
#+begin_src emacs-lisp
(use-package swiper
:defer t
:config
(global-set-key "\C-s" 'swiper))
#+end_src
~counsel~ pa nudi kup zamenjav privzetih emacs ukazov/operacij za prijetnejša opravila. Nastavimo nekaj bližnjic za njih. Recimo ~M-x~ menjava ki kaže predoglede v minibuferju, ~SPC RET~ za shranjevanje in menjavo med zaznamki, ~SPC /~ za ripgrep rekurzivno iskanje po vsebini datotek (potrebuje nameščen ~ripgrep~!).
Dodamo tudi bližnjice za ~org-capture~ ter ~org-agenda~.
TODO dodaj več!
#+begin_src emacs-lisp
:general
(start/leader-keys
"o" '(:ignore t :wk "orgmode")
"o c" 'org-capture
"o a" 'org-agenda
"o w" 'writeroom-mode
"o t" 'org-time-stamp)
#+end_src
V org dokumente lahko vnašamo bloke vsebin, kot so programska koda, citati in podobno. Privzeto to dosežemo s ~C-c C-,~ in izbiro vrste željenega bloka, s sledečo konfiguracijo pa vklopimo bližnjico; na prazni vrstici samo "<s" ~TAB~ vstavi blok izvorne kode.
#+begin_src emacs-lisp
:config
(require 'org-tempo)
(setq org-src-tab-acts-natively nil)
#+end_src
Za lepšo preglednost skrijemo znake za krepitev črk, podčrtovanje in podobno.
#+begin_src emacs-lisp
(setq org-hide-emphasis-markers t)
#+end_src
Nastavimo lokacije ~org-agenda~ dokumentov in pa privzeto datoteko za zapiske
#+begin_src emacs-lisp
(setq org-agenda-files (list "~/rs/org" "~/org"))
(setq org-default-notes-file "~/org/zapiski.org")
#+end_src
Koledarski teden naj se začne s ponedeljkom, kot je pri nas konvencija.
#+begin_src emacs-lisp
(setq calendar-week-start-day 1)
#+end_src
*** Diagrami
Razširitev orgmode z diagramiranje preko [[https://graphviz.org/docs/layouts/dot/][DOT]] ter [[https://ditaa.sourceforge.net/#usage][ditaa]].
#+begin_src emacs-lisp
(org-babel-do-load-languages
'org-babel-load-languages
'((dot . t)
(ditaa . t)))
#+end_src
Z ~ob-mermaid~ paketom pa dodamo še podporo za prikazovanje [[https://mermaid.js.org/intro/][mermaid diagramov]]!
Delovanje tega paketa je odvisno od globalne namestitve javascript paketa z npm: ~sudo npm i -g @mermaid-js/mermaid-cli~.
#+begin_src emacs-lisp
(use-package ob-mermaid
:defer t
:config
;; sudo npm install -g @mermaid-js/mermaid-cli
(setq ob-mermaid-cli-path "/usr/local/bin/mmdc")
(org-babel-do-load-languages
'org-babel-load-languages
'((mermaid . t)
(scheme . t))))
#+end_src
*** Stanja opravil
Stanja opravil. Stanja (v naslovih) menjamo s ~S-<levo>~ in ~S-<desno>~.
Način ~writeroom-mode~ omogoča nemoteno pisanje; trenutni buffer raztegne čez cel zaslon in v sredino centrira širinsko-omejen tekst. Tako buffer izgleda bolj kot popisan list papirja.
Barvna tema je [[https://github.com/greduan/emacs-theme-gruvbox][gruvbox]], v varjanti ~gruvbox-dark-soft~.
#+begin_src emacs-lisp
(use-package gruvbox-theme
:config
(load-theme 'gruvbox-dark-soft t))
#+end_src
Modeline vrstica (v bufferjih spodaj) je iz doom emacsa.
#+begin_src emacs-lisp
(use-package doom-modeline
:defer t
:init (doom-modeline-mode 1))
#+end_src
Uporabimo nerd ikone. ~POZOR~ pisavo naložimo z ukazom ~M-x nerd-icons-install-fonts~.
#+begin_src emacs-lisp
(use-package nerd-icons)
; Rabimo tudi all the icons?
;(use-package all-the-icons)
#+end_src
*** Drsenje (skrolanje)
Omogočimo gladko piksel skrolanje, v emacsu od verzije 29 dalje in nastavimo dve opciji, ki sta skopirani od drugje in za njih nevem kaj počneta. Mislim da vpivata na to, kako je, ko pridrsaš do dna okna.
#+begin_src emacs-lisp
(pixel-scroll-precision-mode)
;; Nevem kaj to dela
(setq scroll-conservatively 10)
(setq scroll-margin 8)
#+end_src
*** Prihranimo prostor
Nekaj prostora prihranimo z umikom menija in orodne vrstice, iz katere tudi umaknemo ikone.
#+begin_src emacs-lisp
(menu-bar-mode -1)
(tool-bar-mode -1)
(setq ns-use-proxy-icon nil)
#+end_src
Onemogočimo grafične dialoge. Namesto tega tekstovno odgovorimo y/n (skrajšana oblika).
#+begin_src emacs-lisp
(setq use-dialog-box nil)
(fset 'yes-or-no-p 'y-or-n-p)
#+end_src
Umaknemo tudi naslove okvirjev.
#+begin_src emacs-lisp
(setq frame-title-format nil)
#+end_src
Ob strani piksle pridobimo s skrivanjem drsnega traka.
#+begin_src emacs-lisp
(scroll-bar-mode -1)
#+end_src
Zmanjšamo razmike med okni.
#+begin_src emacs-lisp
(setq window-divider-default-bottom-width 3)
(window-divider-mode t)
#+end_src
** Tekst
V široko paleto funkcionalnosti emacsa spada tudi urejanje navadnega teksta.
Za začetek nastavimo uporabo dveh navadnih presledkov za tab zamik.
#+begin_src emacs-lisp
(setq-default tab-width 2)
(setq-default indent-tabs-mode nil)
#+end_src
Vklopimo avtomatsko zapiranje oklepajev ter emacsovo avtomatsko zamikanje.
#+begin_src emacs-lisp
(electric-indent-mode 1)
(electric-pair-mode 1)
#+end_src
Tekst naj se prelamlja ob robu okna! Skrolanje na stran je naporno...
#+begin_src emacs-lisp
(global-visual-line-mode)
#+end_src
Ponavadi nas tudi zanimajo številke vrstic. Predvsem zaradi urejanje kode, morda bi to bolj pasalo v odsek programiranja TODO.
#+begin_src emacs-lisp
(global-display-line-numbers-mode)
#+end_src
Namesto navadnega undo/redo lahko uporabimo drevesne razveljavitve. Teh dreves nisem zares nikoli neposredno uporabljal, je pa praktično shranjevanje zgodovine undoja v emacsov nastavitveni direktorij.
Zaradi težav pri uporabi =projectile= preko SSH povezav spremenimo način indeksiranja datotečnega drevesa. Dodajanje večjega projekta zato traja nekoliko dlje
[[https://editorconfig.org/][Editorconfig]] omogoča nastavljanje oblikovanje tekstovnih fajlov na ravni posameznega projekta.
#+begin_src emacs-lisp
(use-package editorconfig
:config
(editorconfig-mode 1))
#+end_src
*** Datotečno drevo
~treemacs~ nudi vizualni drevesni pregled nad datotekami in direktoriji za posamezni projekt.
Vklop je nastavljen na ~SPC t~. Številke vrstic nas v drevesnem bufferju ne zanima. Pridodamo še paket za ~projectile~ podporo.
#+begin_src emacs-lisp
(use-package treemacs
:defer t
:general
(start/leader-keys
"t" 'treemacs)
:hook ((treemacs-mode . (lambda () ;; Brez stevilk vrstic v file drevesu!
(display-line-numbers-mode -1)))))
(use-package treemacs-projectile :after treemacs)
#+end_src
** Programiranje
*** Splošno
Samodejno zapiranje oklepajev.
#+begin_src emacs-lisp
(use-package smartparens-mode
:ensure smartparens
:hook (prog-mode text-mode markdown-mode)
:config
(require 'smartparens-config))
#+end_src
Avtomatsko dopolnjevanje izrazov.
#+begin_src emacs-lisp
(use-package company
:config
(setq lsp-completion-provider :capf)
:init (global-company-mode))
#+end_src
~flycheck~ sproti preverja sintakso kode in opozarja na morebitne nečednosti.
#+begin_src emacs-lisp
(use-package flycheck
:defer t
:init (global-flycheck-mode))
#+end_src
Avtomatsko oblikovanje kode za razne programske jezike. Kličemo ga ročno. TODO dodamo kakšno bližnjico?
#+begin_src emacs-lisp
(use-package format-all :defer t)
#+end_src
*** GIT
~magit~ paket je super za delo z git sistemom za deljeno verzioniranje kode ali drugih podatkov.
#+begin_src emacs-lisp
(use-package magit
:defer t
:general
(start/leader-keys
"g" '(:ignore t :wk "magit")
"g s" 'magit-status))
#+end_src
Z ~magit-todos~ si malo olajšamo spremlajnje TODO-jev v drevesu kode.
#+begin_src emacs-lisp
(use-package magit-todos
:after magit
:config (magit-todos-mode 1))
#+end_src
*** Tree-sitter
Tree-sitter je knjižnica za inkrementalno razčlenjevanje (parsing) programske kode. Na podlagi definicij slovnic za različne programske jezike (namestimo jih z ~M-x treesit-install-language-grammar~) omogoča obarvanja kode, priporočila in podobno. To počne nekoliko hitreje kot klasični načini. Tukaj so definicije nadomestnih treesit načinov za določene programske jezike.
S ~treesit-auto~ paketom se avtomatsko naredijo asociacije za treesit načine, vedno ko odpremo fajl s podporo ze treesitter pa nas obvesti o tem, da ga lahko namestimo. Tako ni treba ročno nastavljat za vsak programski jezik posebej.
#+begin_src emacs-lisp
(use-package treesit-auto
:defer t
:custom
(treesit-auto-install 'prompt)
:config
(treesit-auto-add-to-auto-mode-alist 'all)
(global-treesit-auto-mode))
#+end_src
Spodaj pa je primer nastavitev ročnih asociacij s fajli, za menjavo z klasičnimi major načini.
#+begin_src emacs-lisp
; (dolist
; (item (list '("\\.css\\'" . css-ts-mode)
; '("\\.json\\'" . json-ts-mode)
; '("\\.php\\'" . php-ts-mode)
; '("\\.py\\'" . python-ts-mode)
; '("\\.js\\'" . js-ts-mode)))
; (add-to-list 'auto-mode-alist item))
#+end_src
*** LISP
To poglavje zajema nastavitve raznih LISP dialektov.
Vsi LISPi, tudi vgrajeni emacs-lisp, so bolj berljivi z mavričnim obarvanjem oklepajev.
#+begin_src emacs-lisp
(use-package rainbow-delimiters
:hook ((prog-mode . rainbow-delimiters-mode)))
#+end_src
~Geiser~ lajša delo s scheme jeziki, nastavljeno za [[https://www.gnu.org/software/guile/][GNU Guile]]. Omogoča recimo povezovanje v REPL (read-eval-print-loope).
#+begin_src emacs-lisp
(use-package geiser-guile
:mode "\\.scm\\'"
:general
(start/leader-keys
:infix "s"
"" '(:ignore t :wk "geiser")
"b" 'geiser-eval-buffer
"e" 'geiser-eval-expression
"s" (defun geiser-start-and-eval-buffer ()
(interactive)
(geiser-guile)
(previous-buffer)
(geiser-eval-buffer))
"s" 'geiser-start-and-eval-buffer
"g" 'geiser
"c" 'geiser-connect
"k" 'geiser-exit-repl
"r" (defun geiser-restart ()
;(interactive)
(geiser-exit-repl)
(geiser-start-and-eval-buffer)))
:init (setq scheme-program-name "guile"))
#+end_src
Kdaj delam tudi z [[https://racket-lang.org/][racket]].
#+begin_src emacs-lisp
(use-package racket-mode :mode "\\.rkt\\'")
#+end_src
*** Spletno
Način za obarvanje html, twig in podobne kode (jinja?) se imenuje ~web-mode~.
Dodamo še pripadajoč paket za olepševanje kode (avtomatsko prilagoditev zamikov kode).
#+begin_src emacs-lisp
(use-package web-mode :mode "\\.(html|twig)\\'")
(use-package web-beautify :after web-mode)
#+end_src
Ozadja pri ~vue-mode~ se z gruvbox temo rada grdo pomešajo, kar lahko rešimo s sledečim hookom:
CSS zamike nastavimo na 2 presledka, kot je drugje.
#+begin_src emacs-lisp
(setq css-indent-level 2)
(setq css-indent-offset 2)
#+end_src
Pri spletnem programiranju zelo prav pride tudi [[https://github.com/pashky/restclient.el][restclient]] odjemalec za pošiljanje HTTP poizvedb in pregled odzivov.
#+begin_src emacs-lisp
(use-package restclient :defer t)
#+end_src
**** PHP
Podpora za programiranje s PHP domačo spletno stranjo oz. hipertekstualnim predprocesorjem.
#+begin_src emacs-lisp
(use-package php-mode
:mode "\\.(php|module)\\'"
#+end_src
Bližnjica za cache rebuild na drupalu (dela tudi preko SSH!).
#+begin_src emacs-lisp
:general
(start/leader-keys
"d d" (defun drupal-cache-rebuild ()
(interactive)
(shell-command "drush cr"))))
#+end_src
Sicer obstaja tudi način ki lajša delanje z drupalom.
#+begin_src emacs-lisp
(use-package drupal-mode :after php-mode)
#+end_src
**** Javascript
Najprej nastavimo zamike.
#+begin_src emacs-lisp
(setq js2-strict-missing-semi-warning nil
js2-missing-semi-one-line-override nil
js2-basic-offset 2
js-indent-level 2
indent-tabs-mode nil
tab-width 2)
#+end_src
~js2~ je en fajn način za javascriptanje.
#+begin_src emacs-lisp
(use-package js2-mode
:mode "\\.js\\'")
#+end_src
Vue način lajša razvoj z [[https://vuejs.org/][vue javascript ogrodjem]]. Integriran je z LSP, moramo pa za integracijo globalno namestiti npm paket: ~sudo npm i -g vue-language-server~
#+begin_src emacs-lisp
(use-package vue-mode
:mode "\\.vue\\'"
:config (add-hook 'vue-mode-hook #'lsp))
#+end_src
~rjsx~ pride prav pri recimo ogrodju [[https://react.dev/][react]].
#+begin_src emacs-lisp
(use-package rjsx-mode :after js2-mode)
#+end_src
*** Python
Zamik na 2 presledka.
#+begin_src emacs-lisp
(setq python-indent-offset 2)
#+end_src
Podpora za delo z [[https://docs.python.org/3/library/venv.html][venv]] okolji.
[[https://supercollider.github.io/][supercollider]] je platforma za zvočno sintezo in algoritmično kompozicijo. Uporabna tudi za živo kodiranje. Vključuje svoje integrirano razvijalsko okolje, integrira se pa tudi z emacsom.
Najprej moramo vključit direktorij, v katerem se nahajajo emacs paketi zanj (pridejo z namestitvijo supercolliderja), pot pa je odvisna od linux distribucije ali nastavitev pri prevajanju iz izvorne kode:
[[http://www.pawfal.org/Software/fluxus_/][fluxus]] je programsko okolje za hitro prototipiranje ter igranje z oz. učenje 3d grafike. Pisam je v schemu.
#+begin_src emacs-lisp
(use-package fluxus-mode :defer t)
#+end_src
[[https://extemporelang.github.io/][Extempore]] je programski jezik za kiberfizično programiranje.
#+begin_src emacs-lisp
(use-package extempore-mode :mode "\\.xtm\\'")
#+end_src
[[http://tidalcycles.org/][Tidal cycles]] omogoča kodiranje glasbe z algoritmičnimi vzorci. Pred uporabo moramo namestiti še supercollider.
#+begin_src emacs-lisp
(use-package tidal
:defer t
#+end_src
Nastaviti mu moramo lokacijo ~BootTidal.hs~ datoteke, ki jo lahko namestimo s [[https://www.haskell.org/cabal/][cabal]]-om ali kako drugače.
[[https://sardine.raphaelforment.fr/presentation/what_is_sardine.html][sardine]] je glasbeni inštrument v pythonu. Gre za pythonovski vmesnik v supercollider, namenjen živemu kodiranju. Supercollider in sardine najprej namestimo, pri uporabi pa nam pomagajo sledeče emacs funkcije.
YAML in TOML sta dva primera konfiguracijskih jezikov, s katerima kdaj delam.
#+begin_src emacs-lisp
(use-package yaml-mode :mode "\\.yaml\\'")
(use-package toml-mode :mode "\\.toml\\'")
#+end_src
*** Arduino
#+begin_src emacs-lisp
(use-package arduino-mode :mode "\\.ino\\'")
#+end_src
*** Jezikovni strežnik
Podpora za protokol jezikovnega strežnika (LSP - Language Server Protocol) precej izboljša izkušnjo programiranja s priporočevanjem in dopolnjevanjem. Emacs spremeni v IDE (integrirano razvojno okolje).
#+begin_src emacs-lisp
(use-package lsp-mode
:defer t
#+end_src
S sledečimi nastavitvami pospešimo delovanje.
#+begin_src emacs-lisp
:config
;; Make gc pauses faster by decreasing the threshold.
(setq gc-cons-threshold (* 100 1000 1000))
;; Increase the amount of data which Emacs reads from the process
Emacs že vključuje ~mu4e~ ([[https://www.djcbsoftware.nl/code/mu/][mu]] za emacs), modul ki omogoča brskanje po prejeti e-pošti.
Pred uporabo je treba konfigurirati nekaj več stvari, potrebujemo recimo ~isync~ za pridobivanje pošte (tudi starejši ~mbsync~ je vredu), program ~mu~ za indeksiranje prejetih mejlov, oba pa tudi primerno nastavljena.
*** isync
TODO
*** mu
TODO
*** mu4e
Vključimo paket in nastavimo ukaz za pridobivanje mejlov, ki ga sproži ~mu4e~.
#+begin_src emacs-lisp
(use-package mu4e
:ensure f
:defer t
:config
(setq mu4e-get-mail-command "mbsync -a"))
#+end_src
Preglednost lahko izboljšamo s paketom za ikone.
#+begin_src emacs-lisp
(use-package mu4e-marker-icons
:after mu4e
:config
(mu4e-marker-icons-mode 1))
#+end_src
~mu4e-dashboard~ omogoča pripravo "nadzorne plošče", torej domačega zaslona pregleda mejlov, ki je pravzaprav ORG dokument z ~mu4e~ poizvedbami. Recimo, da prikaže koliko imamo skupno neprebranih sporočil in pa da skočimo na skupek vseh z zastavico označenih sporočil.
#+begin_src emacs-lisp
(use-package mu4e-dashboard
:after mu4e
:vc "https://github.com/rougier/mu4e-dashboard")
#+end_src
TODO spisat dodatne konfiguracije, tega še ne uporabljam res.