neovim/README.md

---
title: My neovim setup
date: 2024-05-16T12:16:06+0200
id: 20240516121606
tags: [neovim, editor, configuration, README]
---

# [Neovim setup][1]

This new configuration is written with the help of:

- [`kickstart.nvim`][4].
- *[Tutoriel : configurer Neovim comme IDE/éditeur de code à partir de
  zéro][5]*.

## Requirements

- Neovim > 0.10.
- [Ripgrep][2].
- A [nerd font][3].

## Structure

- `init.lua` is the configuration file, with the required includes.
- `lua/` is the folder where specific configuration and plugins are.
- `lua/core` contains the basic configuration:
  - `options.lua` with the global neovim options.
  - `keymaps.lua` with the global neovim key mappings.
- `lua/config` contains the Lazy plugin manager installation and configuration.
- `lua/plugins` of course contains all other plugins installation and
  configuration.

## Plugins

- `lazy.nvim` as plugins manager.
- `plenary` to get lua functions used by many plugins.
- Adwaita for the colorscheme.
- `which-key.nvim` to find out shortkeys.
- `nvim-tree` as file explorer.
- `telescope.nvim` for the fuzzy finder interface. It has some specific
  dependencies:
  - `telescope-fzf-native.nvim` to get a C implementation of fzf, with improved
    performances.
  - `telescope-luasnip.nvim` to search for snippets. LuaSnip is a dependency
    for `nvim-cmp` which provides completion.
  - `telescope-ag` to use Ag or Ripgrep to filter results.
- `nvim-web-devicons` as a dependency to add icons to the interface, when it is
  used (file explorer, fuzzy finder).
- `treesitter` for language grammar support (with `treesitter-textobjects` as
  dependency, to improve bloc selection and navigation. It is deactivated for
  markdown.
- Markdown:
  - `vim-pandoc` and `vim-pandoc-syntax` to support the pandoc markdown, nice
    concealing, easy folding and hard wrap automatic formatting.
  - `mkdnflow.nvim` to improve links navigation, table formatting, file
    creation, and so on. It improves also the link concealing.
  - `markdown-preview.nvim` to provide a live HTML preview.
- Completion with `nvim-cmp` with the following dependencies:
  - `cmp-buffer` to get text completion from the current buffer text.
  - `cmp-path` to get path completion.
  - `cmp-cmdline` to get vim cmdline completion.
  - `LuaSnip` to get snippet expansion, with the nvim-cmp source for it:
    `cmp_luasnip`.
  - `friendly-snippets` which adds some user-friendly snippets.
  - `cmp-emoji` for emoji completion after ':'.
  - `lspkind.nvim` to add text symbols to spot the type of source completion.
- Language servers:
  - `lsp-zero.nvim` to ease LSP configuration.
  - `nvim-lspconfig` to configure LSP support and completion, with
    dependencies:
    - `cmp-nvim-lsp` to get LSP results in completion.
    - `nvim-lsp-file-operations` to add some code actions.
  - `mason.nvim` with `mason-lspconfig.nvim` to install automatically the
    needed LSP.
- `lazdev.nvim` to improve lua_ls configuration.
- `vim-fugitive`.
- `vim-speeddating` to increment dates, times, etc.
- `vim-sleuth` to detect tabstop and shiftwidth automatically.
- `vim-surround` to improve surroundings management.
- `autopairs.nvim`.
- `Comment.nvim` to comment lines and blocs.
- `ident-blankline.nvim` to improve readability of indentation.

<!-- references -->

[1]: ./README.md
[2]: https://github.com/BurntSushi/ripgrep/
[3]: https://github.com/ryanoasis/nerd-fonts/
[4]: https://github.com/nvim-lua/kickstart.nvim
[5]: https://vincent.jousse.org/blog/fr/tech/configurer-neovim-comme-ide-a-partir-de-zero-tutoriel-guide