LazyVim/README.md

<!-- markdownlint-disable line-length no-inline-html no-duplicate-heading -->

# 💤 LazyVim

A starter template for [LazyVim](https://github.com/LazyVim/LazyVim).
Refer to the [documentation](https://lazyvim.github.io/installation) to get started.

- check latest changes
  - <https://github.com/LazyVim/LazyVim/blob/main/NEWS.md>
  - <https://github.com/LazyVim/LazyVim/blob/main/CHANGELOG.md>

# 📦 Plugins

To see plugins added & removed in `lazy-lock.json` since last commit or 2 days ago:

```sh
diff -U30 \
  <(git show HEAD:lazy-lock.json | cut -d' ' -f-3) \
  <(cut -d' ' -f-3 lazy-lock.json)

diff -U30 \
  <(git show "@{2 days ago}:lazy-lock.json" | cut -d' ' -f-3) \
  <(cut -d' ' -f-3 lazy-lock.json)
```

To search for mentions of removed plugins:

```sh
for plugin in $(
  diff -U30 \
    <(git show "@{2 days ago}:lazy-lock.json" | cut -d' ' -f-3) \
    <(cut -d' ' -f-3 lazy-lock.json) |
  grep '^- ' |
  cut -d'"' -f2);
do echo "\n ❌ $plugin"; rg $plugin; done
```

## Noice

- `:Noice`
- `<leader>sn`
- <https://github.com/folke/noice.nvim>
- <https://www.lazyvim.org/keymaps#noicenvim>
- <https://github.com/folke/noice.nvim/wiki/A-Guide-to-Messages>

# 🛠️ Upgrade

## Node

After upgrading node.js with `asdf`,
you may need to execute the following commands:

```sh
npm install -g neovim
npm ls neovim
```

## Python

After upgrading python version with `asdf`,
you may need to execute the following commands:

```sh
 # Update symbolic links
python -m venv --upgrade "$VIRTUAL_ENV"

 # Install PyNvim
python -m pip install --upgrade pynvim
pip list --format=columns
```

# 🛠️ Installation

## TL;DR

```sh
git clone https://forge.chapril.org/michel_ouba/LazyVim.git ~/.config/nvim
cd ~/.config/nvim
direnv allow
```

Read also the _Upgrade_ section.
And in neovim, check the output of `:LazyHealth`.

## Make a backup of your current Neovim files

```sh
 # required
mv ~/.config/nvim{,.bak}

 # optional but recommended
mv ~/.local/share/nvim{,.bak}
mv ~/.local/state/nvim{,.bak}
mv ~/.cache/nvim{,.bak}
```