/nvim

My personal Neovim profile

Primary LanguageLuaMIT LicenseMIT

Nvim

My personal Neovim configuration, which keeps the structure simple and straightforward by logically distributing the configuration into various directories. Aims to be highly customizable and have no hacks.

https://user-images.githubusercontent.com/61115159/179394575-3ac8fbb5-323b-45fb-9ed8-24f875788464.png

Table of Contents

Introduction

This configuration doesn’t break any of Neovim’s default keymaps, except for s, the source-level equivalent of cl, s is used as the easymotion-prefix(In fact the functionality of easymotion is provided by a plugin called hop.nvim).

Except for the entry file init.vim, all configuration is done by Lua. The reason to use init.vim instead of init.lua is to maintain support for classic Vim or Vim emulators such as IdeaVim, VSCodeVim, or FakeVim that partially support VimScript.

This configuration contains more than 100 plugins, but the configuration of each plugin is placed in a separate file, and these files are classified into different modules according to the function of the plugin and placed in different folders.

In addition, all configuration options and keymaps for each plugin are listed in their respective files, making it easy to adjust individual options without having to look up the manual.

The configuration structure is as shown in the figure below.

                  │                             ┌──────────────────┐
                      Lua Space                 │ Core Module      │
                  │                             │ ┌──────────────┐ │
                                                │ │lspconfig.lua │ │
                  │    ┌───────────┐            │ └──────────────┘ │
                       │keymaps.lua│     ┌─────►│                  │
                  │    └───────────┘     │      │ ┌──────────────┐ │
                      Keymap for lazy    │      │ │treesitter.lua│ │
                  │   loading plugins    │      │ └──────────────┘ │
                             ▲           │      │                  │
                  │          │           │      │  ...other files  │
                             │           │      └──────────────────┘
   ┌──────────┐   │    ┌─────┴────┐      │
   │ init.vim ├───────►│ init.lua │      │      ┌──────────────────┐
   └──────────┘   │    └──────────┘      │      │ Interface Module │
Entry, Vim common   All Neovim-specific  │      │ ┌──────────────┐ │
  configuration   │    configuration     │      │ │bufferline.lua│ │
                             │           │      │ └──────────────┘ │
                  │          │           │      │                  │
                             ▼           │      │ ┌──────────────┐ │
                  │    ┌───────────┐     │      │ │ lualine.lua  │ │
                       │plugins.lua├─────┼─────►│ └──────────────┘ │
                  │    └───────────┘     │      │                  │
                     Plugin management,  │      │  ...other files  │
                  │ calling each module  │      └──────────────────┘
                                         │
                  │                      │      ┌──────────────────┐
                                         └─────►│ ...other modules │
                  │                             └──────────────────┘

Directory Structure

├── lua
│   ├── core # Core plugins, often depended on by other plugins
│   │   ├── lspconfig.lua
│   │   ├── treesitter.lua
│   │   └── ...
│   ├── debug # Debug and run
│   │   ├── dap.lua
│   │   ├── dap-ui.lua
│   │   └── ...
│   ├── edit # Text edting
│   │   ├── cmp.lua
│   │   ├── copilot.lua
│   │   └── ...
│   ├── efficiency # Efficiency Improvement
│   │   ├── session-manager.lua
│   │   ├── telescope.lua
│   │   └── ...
│   ├── interface # Interface Extension
│   │   ├── bufferline.lua
│   │   ├── lualine.lua
│   │   └── ...
│   ├── language # Language Specific
│   │   ├── jdtls.lua
│   │   └── tex.lua
│   ├── tool # Tool Integration
│   │   ├── gitsigns.lua
│   │   ├── tree.lua
│   │   └── ...
│   ├── plugins.lua # Plugin management
│   ├── keymaps.lua # Keymap for lazy loading plugins
│   └── init.lua # All Neovim-specific configuration
├── .gitignore
├── stylua.toml
├── LICENSE
├── README.org
├── ginit.vim # Neovim-qt configuration
└── init.vim # Vim common configuration