Pål's Neovim config

Table of contents

• Requirements
• Installation
• Usage & utilities
  • Git
    • Source control
      • Fugitive
      • Lazygit.nvim
  • Terminal
    • Exit terminal
    • Temprorarily jump out of Neovim
  • Other tools
    • Multiple cursors (Vim visual multi)
    • Surround (Nvim surround)
    • Command preview (live command)
  • Neovim

Requirements

WSL

I'm using Ubuntu through WSL on Windows 10 & 11

Yanking to OS clipboard registry is currently customized for WSL specifically (let g:clipboard = { from lazy.lua). Aside: :h clipboard-wsl

---

A note on Windows 11 & its Terminal app:

• [ctrl] [tab] is automatically set up to "move to next tab"
• I have also defined a [ctrl] [tab] keybinding in the autohotkey file, to "move to previous open tab" (just like hitting [ctrl] 6 in vim)

If you want to use the latter, you'll have to delete the former. You can open up Terminal settings and delete the "move to next tab".

---

Neovim version 0.9.0

My Neovim info

NVIM v0.9.0
Build type: Release
LuaJIT 2.1.0-beta3

How to install Neovim 0.9 in Ubuntu in WSL

---

Git

How to update git on Ubuntu

Check git --version

Update if necessary

sudo add-apt-repository ppa:git-core/ppa -y
sudo apt-get update
sudo apt-get install git -y
git --version

---

Semi-requirements / nice to have

Autohotkey (Windows app, for extra keymaps)

I have made some additional keymaps using Authotkey.

(Some keymaps are too hard / impossible to define in plain Neovim)

Install AutoHotkey:

https://www.autohotkey.com/

Download v2.0, launch AutoHotkey_2.x.x_setup, accept the default suggestions

Start script

Run ahk file

:lua Ahk() (might need to source :so autohotkey/init.lua first)

or

click 'run script' from the right-click menu on the ahk-file

Stop script

Alt+Esc

---

LazyGit (UI for version control)

Install as explained in https://github.com/jesseduffield/lazygit#ubuntu,

run

LAZYGIT_VERSION=$(curl -s "https://api.github.com/repos/jesseduffield/lazygit/releases/latest" | grep -Po '"tag_name": "v\K[^"]*')
curl -Lo lazygit.tar.gz "https://github.com/jesseduffield/lazygit/releases/latest/download/lazygit_${LAZYGIT_VERSION}_Linux_x86_64.tar.gz"
tar xf lazygit.tar.gz lazygit
sudo install lazygit /usr/local/bin

Verify installation

lazygit --version

---

Git delta (Better git diff)

visit: https://dandavison.github.io/delta/installation.html

Download the deb for Debian / Ubuntu

Debian / Ubuntu	sudo dpkg -i git-delta-musl_x.xx.x_amd64.deb

Usage

git diff | delta

see more

https://www.youtube.com/watch?v=91p1Fp7Db5c

---

Tmux (for terminal window management)

1. Install it
2. Then use the config in this repo as your tmux config

cp ~/.config/nvim/.tmux.conf ~/.tmux.conf

Install plugin manager

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

Install plugins

Open tmux, and run:

[ctrl] x, I

---

(N)vim as commit message tool

Use (n)vim as commit message tool

git config --global core.editor "nvim"

git config --global core.editor "vim"

---

Installation

Clone config

Warning

If you already have a .config/nvim-directory with important files, make sure to create a backup of them first!

git clone git@github.com:paalss/nvim.git ~/.config/nvim

To start Neovim, navigate to where you want to open Neovim, and run nvim

Usage & utilities

• View welcome screen and important keybindings: Run nvim

Git

Source control

Fugitive

Maps:
:h fugitive-maps

Commit maps:
:h fugitive_c

Lazygit.nvim

Commit using git's default configured editor -> (n)vim

C (uppercase)

Edit file in new modal:

e

Open file in default code editor:

o

Terminal

The 'terminal' here is just a tmux pane -- Neovim terminal plugins such as Toggleterm and FTerm crashed a lot and were a pain to use

Start Neovim inside of tmux

eg.

tmux
nvim .

Exit terminal

Close with exit (better yet create an alias for "exit" in your .bashrc file. I'm using alias q="exit")

Temprorarily jump out of Neovim

Suspend Neovim: [ctrl] z

Bring back Neovim: fg

Other tools

Multiple cursors (Vim visual multi)

1. Visual mode v
2. Enter visual multi mode [ctrl] n

---

Surround (Nvim surround)

The primary way of adding a new pair to the buffer is via the normal-mode ys operator, which stands for "you surround". It can be used via ys{motion}{char}, which surrounds a given {motion} with a delimiter pair associated with {char}. For example, ysa") means "you surround around quotes with parentheses".

Surround visual selection

S (uppercase)

• ys (you surround/add)
• cs (change surrounding)
• ds (delete surrounding)

W/o visual selection

Old text                    Command         New text

---

surr*ound_words             ysiw)           (surround_words)
*make strings               ys$"            "make strings"
[delete ar*ound me!]        ds]             delete around me!
remove <b>HTML t*ags</b>    dst             remove HTML tags
'change quot*es'            cs'"            "change quotes"
<b>or tag* types</b>        csth1<CR>       <h1>or tag types</h1>
delete(functi*on calls)     dsf             function calls

Detailed information on how to use this plugin can be found in :h nvim-surround.usage.

Command preview (live command)

https://github.com/smjonas/live-command.nvim

Preview norm and macros

• :Norm to preview :norm
• :At a to preview :norm @a

Neovim

Return to last opened window (buffer)

[ctrl] 6

Paste from OS clipboard

1. insert mode
2. disable helper features like auto-newline-comments: :set paste
3. paste: [shift]+[right mouse click]
4. re-enable helper features: :set nopaste

Indent line

INSERT MODE

[ctrl] t / [ctrl] d

VISUAL MODE

< or >

Open help pages in new tab

eg. help with lualine:

:tab h lualine