Kakoune-modal-editor-config/README.md

157 lines
6.7 KiB
Markdown
Raw Normal View History

2024-03-30 20:13:46 +00:00
## Úvod:
👉 Kakoune Front-End Power postavený na [LSP](https://github.com/kakoune-lsp/kakoune-lsp).
2024-03-31 18:41:23 +00:00
👉 [Kakoune](http://kakoune.org/) je modální editor pro [Linux](http://www.linux.cz/) a [macOS](https://cs.wikipedia.org/wiki/MacOS) jako je třeba [Vim](https://www.vim.org/) či [Neovim](https://neovim.io/). . Z Kakoune vychází také jeden velmi oblíbený modální editor [Helix-editor](https://helix-editor.com/). Jak Kakoune, tak Helix se od Vim a Neovim liší v ovládání, kde je opačná logika příkazu a je bližší lidské řeči. Nespornou výhodou Kakoune je oproti Helixu možnost rozšířit aplikaci o pluginy. Proto je Kakoune vhodný pro zkušenější uživatele. Náš web by Ti měl pomoct s prvotním nastavením. Pokud si i tak na tento editor netroufáš, Helix je skvělá náhrada.
2024-03-30 20:13:46 +00:00
2024-03-31 18:41:23 +00:00
👉 Tato distribuce nefunguje tak, že jen klikneš na tlačítko a nainstaluje se. Vede Tě k samostatné instalaci pomocí tohoto webu. Cílem je pochopit, jak Kakoune funguje, abyste si mohli sami vše modifikovat.
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 Toto nastavení je primárně pro vývoj webu, ale není problém si vše přizpůsobit. Inspiroval jsem se pluginy, které jsem využíval ve VSCode a Webstorm.
2024-03-30 20:13:46 +00:00
👉 Velký důraz je kladen na rychlost a lehkost.
👉 Tento blog je stále ve vývoji a postupně se na něm pracuje.
👉 Pro nejlepší zážitek s Kakoune doporučuji používat multiplexor [Zellij](https://git.archoslinux.cz/kankys/zellij-mySetup) , ale není to samozřejmě podmínkou.
## Přednosti:
2024-03-31 11:17:55 +00:00
👉 Hlavní předností tohoto nastavení jsou AutoSave, doplňování HTML, CSS, JS a zkratky k zakomentování a odkomentování kódu. Taky je zde několik pluginu pro příjemnější práci v Kakoune.
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 LSP se mi velmi osvědčilo v modálním editoru [Helix-editor](https://helix-editor.com/). Mou konfiguraci Helixu najdete [zde](https://git.archoslinux.cz/kankys/Helix-frontend-setup).
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 Ta nejlepší témata v Kakoune nemusíš hledat, najdeš je po instalaci. Defaultně je v naší konfiguraci nastaveno gruvbox-dark.
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 Témá v Kakoune si jednoduše změníš v command line příkazem `colorscheme` a tlačítkem Tab se budeš přepínat mezi jednotlivými tématy. Command mode, česky příkazový mód, vyvoláš zkratkou **Ctrl + :** .
2024-03-30 20:13:46 +00:00
2024-03-31 18:41:23 +00:00
![Homescreen](http://127.0.0.1:8080/img/home.png) ![Zellij](http://127.0.0.1:8080/img/config.png) ![Command](http://127.0.0.1:8080/img/command.png)
2024-03-30 20:13:46 +00:00
## Instalace a nastavení:
2024-03-31 18:41:23 +00:00
👉 Pokud ještě nemáš, nainstaluj si, [Kakoune](http://127.0.0.1:8080/?username=luk&password1=55&password2=55#contact).
2024-03-30 20:13:46 +00:00
👉 Nejprve si zálohuj své aktuální nastavení Kakoune!!!
👉 Linux & Mac:
~/.config/kak/kakrc
2024-03-31 11:17:55 +00:00
👉 Aby Kakoune dobře komunikoval s LSP, je potřeba mít nainstalovaný [Rust](https://www.rust-lang.org/).
2024-03-30 20:13:46 +00:00
## Node.js:
👉 Doporučuji mít nainstalovaný [Node.js](https://nodejs.org/en).
2024-03-31 11:17:55 +00:00
👉 Pro správnou funkčnost LSP si doinstaluj tyto balíčky:
2024-03-30 20:13:46 +00:00
[vscode-html-language-server](https://github.com/microsoft/vscode-html-languageservice)
[vscode-css-language-server](https://github.com/microsoft/vscode-css-languageservice)
[typescript-language-server](https://github.com/typescript-language-server/typescript-language-server)
[emmet-ls](https://github.com/aca/emmet-ls)
[tailwindcss-language-server](https://github.com/tailwindlabs/tailwindcss-intellisense/blob/master/packages/tailwindcss-language-server/README.md)
[marksman](https://github.com/artempyanykh/marksman)
[markdoc-ls](https://github.com/markdoc-extra/markdoc-ls)
2024-03-31 11:17:55 +00:00
👉 A také si doinstaluj tento server pro správnou funkčnost HTML v LSP příkazem: **npm install -g vscode-{html,css,json}-languageserver-bin** .
2024-03-30 20:13:46 +00:00
👉 Dále si v Node.js nainstaluj [Live-server](https://www.npmjs.com/package/live-server).
2024-03-31 11:17:55 +00:00
👉 Platí v případě, že chceš dělat front-end nebo programuješ v Javascriptu.
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 Ve svém projektu budeš moci pouštět index.html příkazem:
2024-03-30 20:13:46 +00:00
npx live-server
2024-03-31 11:17:55 +00:00
👉 Všechny servery, co si můžeš pomocí LSP nainstalovat, najdeš [zde](https://github.com/kakoune-lsp/kakoune-lsp/wiki/How-to-install-servers).
2024-03-30 20:13:46 +00:00
## Kakoune:
2024-03-31 11:17:55 +00:00
👉 Pro instalaci Kakoune Front-End Power Ti stačí stáhnout pouze soubor **kakrc** z tohoto [repozitáře](https://git.archoslinux.cz/kankys/Kakoune-modal-editor-config) .
2024-03-30 20:13:46 +00:00
👉 Ulož ho do kořenováho adresáře **~/.config/kak/**. **Nezapomeň na zálohu stávajících souborů, pokud máš i své configy.**
👉 Kakoune pustíš v terminálu příkazem **kak**.
2024-03-31 11:17:55 +00:00
👉 V Kakoune zadej do command line **plug-install**, tím nainstaluješ všechny pluginy. Restartuj Kakoune.
2024-03-30 20:13:46 +00:00
2024-03-31 18:41:23 +00:00
👉 Pokud Ti některý plugin chybí, můžeš ho lehce doinstalovat nebo naopak odinstalovat. Více informací najdeš v Kakoune [dokumentaci](https://github.com/mawww/kakoune#3-basic-interaction) nebo velmi Ti rád poradím viz. [Kontakty](http://127.0.0.1:8080/?username=luk&password1=55&password2=55#contact).
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 Pokud některý plugin nechceš používat, stačí ho v souboru **kakrc** zakomentovat pomocí hastagu **#**.
2024-03-30 20:13:46 +00:00
2024-03-31 18:41:23 +00:00
👉 Tuto konfiguraci používám na Linuxu i macOS.
2024-03-30 20:13:46 +00:00
## Plán Kakoune Front-End Power:
2024-03-31 11:17:55 +00:00
👉 Do budoucna můžeš očekávat tyto nové funkce a další novinky:
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 Web na vlastní doméně. Zatím Kakoune Front-End Power najdeš [zde](https://lukaskanka.cz/kakoune/index.html).
2024-03-30 20:13:46 +00:00
👉 Nové pluginy.
2024-03-31 11:17:55 +00:00
👉 Návody k pluginům, jak nastavit a jak s nimi pracovat.
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 Návody k práci s Kakoune.
2024-03-30 20:13:46 +00:00
## Výběr pluginu v Kakoune Front-End Power:
2024-03-31 11:17:55 +00:00
👉 **plug.kak** nejduležitější plugin, aby bylo možné instalovat další pluginy.
2024-03-30 20:13:46 +00:00
👉 **kakoune-lsp**
2024-03-31 11:17:55 +00:00
👉 **luar** rozšíří možnost instalovat pluginy napsané v jazyce Lua.
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 **byline.kak** vybere celý řádek pomocí klávesy **x** jako v Helix-editoru.
2024-03-30 20:13:46 +00:00
👉 **auto-pairs** automaticky doplní závorky.
2024-03-31 11:17:55 +00:00
👉 **fzf.kak** rychlé asynchronní vyhledávaní souborů.
2024-03-30 20:13:46 +00:00
## Otázky a odpovědi:
2024-03-31 11:17:55 +00:00
👉 Kolik Kakoune stojí? -> Nic, Kakoune je zdarma.
2024-03-30 20:13:46 +00:00
2024-03-31 18:41:23 +00:00
## Registrace
Jméno:
Heslo:
Potvrďte heslo:
2024-03-30 20:13:46 +00:00
## Kontakty:
2024-03-31 11:17:55 +00:00
👉 [Kakoune community Telegram skupina](https://t.me/+RlXM8oEZ8TJkMWVk)
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 [Osobní web autora](https://lukaskanka.cz/)
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 [Gitea profil](https://git.archoslinux.cz/kankys)
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 [GitHub](https://github.com/LukasKanka/)
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 [Nostr](https://nostr.band/npub12xzu8ejrl9cwpd034cqj5jtuztn4mxp3em2frckm9tk28kmy48vqr0u0yu)
2024-03-30 20:13:46 +00:00
2024-03-31 11:17:55 +00:00
👉 [Mastodon](https://mastodon.arch-linux.cz/@Kankys)
2024-03-30 20:13:46 +00:00
## Podpora:
2024-03-31 11:17:55 +00:00
👉 Pokud mě chceš podpořit nebo se podílet na obsahu tohoto webu, budu rád, když mi napíšeš.
2024-03-30 20:13:46 +00:00
👉 Taky můžeš tento projekt podpořit pár Satoshi:
![Satoshi](https://lukaskanka.cz/index/about/img/sat.jpeg)
## Další projekty a odkazy:
👉 [ArchLinux CZ](https://arch-linux.cz/)
👉 [Vyhledávač SearXNG CZ](https://searxng.cz/)
👉 [EndeavourOS Linux](https://endeavouros.com/)
2024-03-31 18:41:23 +00:00
👉 [i3 window manager](https://i3wm.org/)