ApolloNvim - Modální editor wiki


1. Jak nainstalovat vim.plug do Neovim

Nejprve si však zálohujte své aktuální nastavení Neovim!!!

Linux & Mac

			
			~/.config/nvim/init.vim
					  

Windows:

			
			~\AppData\Local\nvim\init.vim
					  

Běžte na tuto stránku pod Installation si najděte svůj operační systém a zkopírujte odkaz pod ním do svého terminálu a pomocí Enter nainstalujete vim.plug.

Na Linuxu a macOS to bude tento příkaz:

 sh -c 'curl -fLo "${XDG_DATA_HOME:-$HOME/.local/share}"/nvim/site/autoload/plug.vim --create-dirs \
https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim'

Na Windows to bude tento příkaz:

iwr -useb https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim |`
ni "$(@($env:XDG_DATA_HOME, $env:LOCALAPPDATA)[$null -eq $env:XDG_DATA_HOME])/nvim-data/site/autoload/plug.vim" -Force

Dále si otevřeme soubor init.vim a pokud ho nemáme tak si ho vytvoříme zde:

			
			~/.config/nvim/init.vim
					  

Windows:

			
			~\AppData\Local\nvim\init.vim
					  

A do něj vložíme a následně uložíme tento kód:

call plug#begin(has('nvim') ? stdpath('data') . '/plugged' : '~/.vim/plugged')
# Jsem budeš v budoucnu vkládat pluginy. Začínající PLug a adresa ke stažení
call plug#end()

A příkazem Nvim v terminálu spustíme Neovim. Pokud vám vyskočí chybové hlášení jen ho odklikněte.

Pomocí Ctrl + : se dostanete do příkazového řádku a tam napíšete PlugInstall

A restartujeme Neovim. Příkazem Ctrl + : do příkazového řádku napíšete q a restartujeme Neovim.

Takto pokaždé když si přidáte do init.vim pluginy, příkazem PlugInstall je nainstalujete a restartujeme Neovim.


2. Klávesové zkratky

Default klávesové zkratky

Základní pohyb:

  • h - Pohyb vlevo
  • j - Pohyb dolů
  • k - Pohyb nahoru
  • l - Pohyb vpravo
  • w - Přesun na začátek dalšího slova
  • b - Přesun na začátek předchozího slova
  • gg - Přesun na začátek dokumentu
  • G - Přesun na konec dokumentu

Visuální mód:

Do něj se přepnu v Normal módu pomocí v pohybem kde byl kurzor mohu označovat text.

Normální mód - NORMAL:

Do normál módu se z jiných přesunu pomocí ESC

  • i - Přepnutí do režimu vkládání před kurzor
  • I - Přepnutí do režimu vkládání na začátek řádku
  • a - Přepnutí do režimu vkládání za kurzor
  • A - Přepnutí do režimu vkládání na konec řádku
  • o - Vložení nového řádku pod aktuálním řádkem
  • O - Vložení nového řádku nad aktuálním řádkem
  • dd - Smazání řádku
  • dw - Smazání slova
  • yy - Kopírování řádku
  • p - Vložení obsahu schránky pod kurzor
  • P - Vložení obsahu schránky před kurzor
  • u - Vrácení poslední provedené akce
  • Ctrl + r - Krok do předu opak u
  • q - Zavře okno
  • . - Poslední příkaz
  • Ctrl + w - Přepínání oken

Command mód:

Command mód vyvoláme pomocí SHIFT + :

  • :e + jméno souboru - Vytvoří nový soubor - :e index.html
  • :w - Uložení změn
  • :q - Opuštění editoru
  • :wq - Uložení změn a opuštění
  • :q! - Opuštění editoru bez ukládání změn
  • :vs - Vertikální rozložení oken
  • :sp - Horizontální rozložení oken
  • :colorscheme - Změní theme
  • :term - Otevře terminál

Vyhledávání a nahrazování:

  • /hledany_text - Vyhledání textu
  • n - Přeskočení na další výskyt hledaného textu
  • N - Přeskočení na předchozí výskyt hledaného textu
  • :s/hledany_text/nahrazeny_text/g - Nahrazení hledaného textu za zadaný text v celém dokumentu

Různé:

  • Ctrl + r - Opětovné provedení zrušené akce
  • :help - Zobrazení nápovědy

3. Jak nainstalovat Codeium do Neovim

Neovim je moderní verze Vim, textového editoru používaného v unixových systémech. Zde jsou některé klávesové zkratky pro práci s Neovim:

Codium je alternativou k GitHub Copilot s tím, že pro jednotlivce je zdarma. Codeium hodnotím velmi pozitivně a Copilotu se vyrovná.

Instalace pomocí plug.vim je jednoduchá, stačí pouze upravit svůj init.vim. Vložíme do něj:

" Free AI codium
Plug 'Exafunction/codeium.vim', { 'branch': 'main' }
					  

Výsledný init.vim bude vypadat takto:

call plug#begin(has('nvim') ? stdpath('data') . '/plugged' : '~/.vim/plugged')
" Free AI codium
Plug 'Exafunction/codeium.vim', { 'branch': 'main' }
call plug#end()

A restartujeme Neovim. Příkazem Ctrl + : do príkazového řádku napíšete q a restartujeme Neovim.

Po restartu provedeme PlugInstall a ještě jednou restartujeme Neovim.

Poslední krok bude konfigurace Codeium, příkazem CodeiumEnable do command line.

Codium vás vyzve k propojení API se serverem Codium.

A vše by Vám mělo fungovat.


4. Telescope - Dalekohled

Telescope je, vytvořený jedním z hlavních členů týmu Neovim - TJ Devries .

Vedlejší poznámka, TJ zveřejňuje spoustu obsahu souvisejícího s Neovim na svém kanálu YouTube a na svých streamech Twitch . Zejména jeho kanál YouTube byl skvělým zdrojem. Podívejte se na něj!

Teleskop je podle mého názoru nezbytný plugin. Je to fuzzy vyhledávač vestavěný v Lua, který lze konfigurovat všemi způsoby. Přidává spoustu funkcí do vašeho nastavení Neovim. Zatím jsem si neuvědomil jeho skutečný potenciál, ale na hledání souborů a hledání textu je úžasný.

Tento postup mám odzkoušený na Linuxu tak macOS, ale měl by fungovat i ve Windows

Pojďme ho nainstalovat (všchny příkazy budeme vkládat do vašeho terminálu):

call plug#begin(has('nvim') ? stdpath('data') . '/plugged' : '~/.vim/plugged')
" Telescope install Neovim
" Planery"
Plug 'nvim-lua/plenary.nvim'
" Telescope plugin
Plug 'nvim-telescope/telescope.nvim'
" Fuzzy Telescope fzf
Plug 'nvim-telescope/telescope-fzf-native.nvim', {'do': 'make' }
call plug#end()

Upozorňuji, že zde instalujeme více než jeden plugin. Telescope vyžaduje další plugin s názvem Planery. A další plugin je Telescope Sorter, který podporuje syntaxi fzf a Telescope.

Pro dokončení instalace nezapomeňte provést tyto tři kroky:

Uložit init.vim :w

Restarovat zdroj (source) init.vims :so % nebo restartovat Neovim.

Nainstaluj plugin pomocí :PlugInstall.

Dále musíme nakonfigurovat Telescope. Toto je běžná praxe mezi pluginy Vim. Telescope je plugin založený na Lua.

Nejprve musíme vytvořit novou složku lua v adresáři: nvim ~/.config/nvim/lua

cd ~/.config/nvim 
mkdir lua

Uvnitř lua adresáře vytvoříme podadresář pro jmenný prostor našich konfigurací pluginů. Abychom pochopili, proč je to nutné, je třeba vysvětlit, jak Vim zpracovává vyhledávání souborů. Stručně řečeno, vytvoření podadresáře jmenného prostoru uvnitř lua adresáře zabraňuje nechtěným kolizím souborů .

Rozhodl jsem se použít svůj GitHub nick jako název svého podadresáře:
cd ~/.config/nvim/lua 
mkdir kankys

Je jedno jak adresář pojmenujete. Jakmile jej vytvoříte, budete chtít se do něj přesunout pomocí cd:

cd ~/.config/nvim/lua/tvůj-název-adresáře

Poznámka: tvůj-název-adresáře se používá jako zástupný symbol. Nahraďte jej názvem svého adresáře jaký chcete.

V adresáři jmenného prostoru vytvoř plugin-název.lua soubor pro každý plugin, který chcete/potřebujete nakonfigurovat. Telescope vytvoříš takto (jsme stálé v cd ~/.config/nvim/lua/tvůj-název-adresáře ):

nvim telescope.lua

Užitečný tip Vim je, že můžete otevřít soubory dříve, než existují. Pokud soubor zavřete bez uložení, nebude vytvořen! Ve výše uvedeném příkladu otevíráme telescope.luav Neovimu. Pokud soubor uložíme, bude vytvořen.

Naše konfigurace pro Telescope bude:

local telescope = require('telescope')
telescope.setup {}
telescope.load_extension('fzf')					  

Tento kód vložíš do telescope.lua a uložíš. V souboru telescope.lua je všechno, co potřebujeme.

Výše uvedený příklad nám dává první ochutnávku Lua. Zjistil jsem, že hodně pluginů potřebuje minimálně toto nastavení v lua:

require('PLUGIN_NAZEV').setup {}
				  

V tomto příspěvku se nebudu potápět hluboko do konfigurace Telescope. Pokud chcete vidět některé dostupné možnosti nastavení a další přizpůsobení, podívejte se do dokumentace.

Nezapomeňte uložit telescope.lua a ukončete Neovim pomocí :wq

Dále musíme říci našemu init.vim že existuje někde soubor lua:

V mém případě bych uvedl:

lua require('kankys') vložením do ~/.config/nvim/init.vim

Pár poznámek:

Vložte tento příkaz pod vim-plug funkci ( `` call plug#end() )!

Co to dělá? Zpočátku to vypadá trochu magicky a porozumění vyžaduje znalost vyhledávání Vim, ale v podstatě tento příkaz bude hledat lua soubor ve vašem běhovém prostředí Vim.

V našem případě je to: ~/.config/nvim/lua/tvůj-název-adresáře/telescope.lua

Namísto vyžadování každého konfiguračního souboru v našem init.vim, můžeme jen vyžadovat adresář jmenného prostoru. Aby to fungovalo, budeme muset přidat nový soubor do našeho adresáře jmenného prostoru s názvem init.lua:

cd ~/.config/nvim/lua/tvůj-název-adresáře
touch init.lua
				  

init.lua soubor lze považovat za indexový soubor. Uvnitř init.lua můžeme načíst všechny naše konfigurační soubory.

Do init-lua vložme tento kód:

require('tvůj-adresář-název/telescope')
				  

Vše co jsem uvedl výšše pochopíš lehce když se podíváš zde na Gitu do konfiguračních souborů nvim.

Od tohoto okamžiku budou všechny nové konfigurační soubory lua v lua/tvůj-název-adresáře.

Telescope

Telescope má řadu příkazů, které lze použít, :Telescope v NORMAL režimu v Neovim. Rychlý způsob, jak zobrazit všechny dostupné příkazy, je zadat :Telescope následuje mezera a poté klikněte na . Tlačítko karty otevře seznam automatického doplňování, dostupných příkazů v Telescope. V seznamu se můžete pohybovat pomocí a ``` opačným směrem.

Níže je uveden příkaz Telescope, pro ukázku: :Telescope find_files

Dokumentaci k Telescope v Neovimu můžete zobrazit pomocí: :h telescope


Barevné schéma

Většinu barevných schémat v Neovimu lze nainstalovat jako plugin. Barevných schémat existuje spousta, opravdu dobrých. Zde je seznam některých znich na GitHubu.

Mezi mé oblíbené patří: Gruvbox Dracula Tokionight

Schémata se instalují uvnitř plug#begin() a plug#end(), pojďme deklarovat naše barevné schéma. Pro ilustraci použiji Gruvbox:

Lukáš Kaňka © 2024. Všechna práva vyhrazena.