From dff7c5e7fbf24f6610328dc9f41e413b7ad11911 Mon Sep 17 00:00:00 2001 From: Kankys Date: Sat, 30 Mar 2024 20:13:46 +0000 Subject: [PATCH] =?UTF-8?q?P=C5=99idat=20README.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 151 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 151 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..ee597bb --- /dev/null +++ b/README.md @@ -0,0 +1,151 @@ +## Úvod: + +👉 Kakoune Front-End Power postavený na [LSP](https://github.com/kakoune-lsp/kakoune-lsp). + +👉 [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 liší od Vim a Neovim 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 pluginy. Proto je vhodný Kakoune vhodný pro zkušenější uživatele. A náš web by ti měl pomoc s prvotním nastavením, pokud i tak si na tento edidor netroufáš Helix je skvělá náhrada. + +👉 Tato distribuce nefunguje jen že kliknete na tlačítko a nainstaluje se. Vede Vás k samostatné instalaci pomocí tohoto webu. Cílem je pochopit jak Kakoune funguje aby jste si mohli samy vše modifikovat. + +👉 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 v VSCode a Webstorm. + +👉 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: + +👉 Hlavní přednosti tohoto nastavení jsou podpora: AutoSave, doplňování HTML, CSS, JS a zkratky k zakomentování a odk omentování kódu. Taky je zde několik pluginu pro příjemnější práci v Neovim. + +👉 LSP se mi velmi osvědčilo v modálním editoru [Helix-editor](https://helix-editor.com/) má konfigurace [Helixu](https://git.archoslinux.cz/kankys/Helix-frontend-setup) a zde také i když vše nefunguje zcela stejně ve všech editorech. + +👉 Ty nejlepší témata v Kakoune najdeš po instalaci ať je nemusíš hledat, defaultně je v naší konfiguraci nastaveno gruvbox-dark. + +👉 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 + :**. + +![Homescreen](https://lukaskanka.cz/index/kakoune/img/home.png) ![Zellij](https://lukaskanka.cz/index/kakoune/img/config.png) ![Command](https://lukaskanka.cz/index/kakoune/img/command.png) + +## Instalace a nastavení: + +👉 Pokud ještě nemáš nainstaluj si [Kakoune](https://lukaskanka.cz/index/kakoune/index.html). + +👉 Nejprve si zálohuj své aktuální nastavení Kakoune!!! + +👉 Linux & Mac: + +~/.config/kak/kakrc + +👉 Aby Kakoune dobře komunikoval s LSP je potřeba mít nainstalovaný [Rust](https://www.rust-lang.org/). + +## Node.js: + +👉 Doporučuji mít nainstalovaný [Node.js](https://nodejs.org/en). + +👉 Pro správnou funkčnost mého setupu si doinstaluj, a pro podporu jazyků díky LSP tyto balíčky: + +[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) + +👉 A také tento server pro správnou funkčnost HTML v LSP příkazem: **npm install -g vscode-{html,css,json}-languageserver-bin**. + +👉 Dále si v Node.js nainstaluj [Live-server](https://www.npmjs.com/package/live-server). + +👉 Platí v případě že chceš dělat front-end nebo programuješ v Javascriptu. + +👉 Ve svém projektu budeš moc pouštět svůj index.html příkazem: + +npx live-server + +👉 Všechny severy co si můžeš pomocí LSP nainstalovat najdeš [zde](https://github.com/kakoune-lsp/kakoune-lsp/wiki/How-to-install-servers). + +## Kakoune: + +👉 Pro instalaci Kakoune Front-End Power ti stačí stáhnout pouze soubor **kakrc** s tohoto [repozitáře](https://git.archoslinux.cz/kankys/Kakoune-modal-editor-config) . + +👉 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**. + +👉 V Kakoune zadej do command line **plug-install** , tím nainstaluješ všechny pluginy. Restartuj Kakoune. + +👉 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 rád poradím viz. o nás. + +👉 Pokud některý plugin nechcete používat stačí v souboru **kakrc** ho zakomentovat pomocí hastagu **#**. + +👉 Tuto konfiguraci používám na Linuxu i MacOS. + +## Plán Kakoune Front-End Power: + +👉 Do budoucna můžete očekávat tyto nové funkce a další novinky: + +👉 Web na vlastní doméně zatím Kakoune Front-End Power najdeš [zde](https://lukaskanka.cz/kakoune/index.html). -> Vysoká priorita + +👉 Nové pluginy. + +👉 Návody k pluginům, jak nastavit a jak s nimi pracovat. -> Vysoká priorita + +👉 Návody k práci s Kakoune -> Vysoká priorita + +## Výběr pluginu v Kakoune Front-End Power: + +👉 **plug.kak** nejduležitější plugin aby bylo možné instalovat další pluginy. + +👉 **kakoune-lsp** + +👉 **luar** rozšíří možnost instalovat pluginy napsané v jazyce Lua + +👉 **byline.kak** vybere celí řádek pomocí klávesy **x** jako v Helix-editoru + +👉 **auto-pairs** automaticky doplní závorky. + +👉 **fzf.kak** rychlé asynchroní vyhledávaní souborů + +## Otázky a odpovědi: + +👉 Kolik stojí Kakoune? -> Nic Kakoune je zdarma. + +## Kontakty: + +[👉 Kakoune community Telegram skupina](https://t.me/+RlXM8oEZ8TJkMWVk) + +[👉 Osobní web autora](https://lukaskanka.cz/) + +[👉 Gitea profil](https://git.archoslinux.cz/kankys) + +[👉 GitHub](https://github.com/LukasKanka/) + +[👉 Nostr](https://nostr.band/npub12xzu8ejrl9cwpd034cqj5jtuztn4mxp3em2frckm9tk28kmy48vqr0u0yu) + +[👉 Mastodon](https://mastodon.arch-linux.cz/@Kankys) + +## Podpora: + +👉 Pokud jakkoliv chceš podpořit nebo se podílet na obsahu a funkčnosti 🚀 ApolloNvim, prosím budu rád když mi zde napíšeš. + +👉 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/) + +👉 [i3 window manager](https://i3wm.org/) + +Copyright © [Lukáš Kaňka](https://git.archoslinux.cz/kankys) 2024 \ No newline at end of file