minimal-vim-config – The Efficient Minimal Vim/Neovim Configuration

The minimal-vim-config project is a Vim configuration that is intended to serve as a solid foundation for a Vim configuration.

The author began developing this configuration upon first adopting Vim and has continuously refined it over 25 years of research and testing to identify the most effective parameters and optimizations for a Vim configuration file.

This Vim configuration does not install any plugins. It lets you choose exactly which plugins to use, giving you the freedom to build a setup suited to your specific needs without unnecessary dependencies or bloat.

Installation

Clone the repository into ~/.minimal-vim-config:

git clone https://github.com/jamescherti/minimal-vim-config ~/.minimal-vim-configCode language: plaintext (plaintext)

Create symbolic links for Vim:

ln -sf ~/.minimal-vim-config/minimal-vim-config.vim ~/.vimrcCode language: plaintext (plaintext)

Create symbolic links for Neovim:

mkdir -p ~/.config/nvim
ln -sf ~/.minimal-vim-config/minimal-vim-config.vim ~/.config/nvim/init.vimCode language: plaintext (plaintext)

Update

To update minimal-vim-config with the latest changes from the repository, execute the following command:

git -C ~/.minimal-vim-config pullCode language: plaintext (plaintext)

Features

This vimrc enhances defaults that improve the editing experience with Vim, based on extensive research and testing.

Miscellaneous enhancements:

  • Automatically remove unnecessary whitespace before saving files.
  • Disables compatibility with Vi and uses Vim-specific settings.
  • Prevents loading the configuration multiple times.

Encoding and File Handling:

  • Sets global encoding, file encodings, and script encoding to UTF-8.
  • Allows loading an optional pre-configuration script (~/.vim/before.vim).
  • Allows loading an optional post-configuration script (~/.vim/after.vim).

Font Settings:

  • Configures default font and size (DejaVu Sans Mono at size 14).
  • Offers a method to scale the GUI font size within a defined range (6-30).

Session Management:

  • Defines options for Vim sessions and view settings (e.g., folds, current directory, cursor position).
  • Restore the cursor position when editing a file, except for Git commit files such as COMMIT_EDITMSG.

GUI and Console Configuration:

  • Customizes GUI-specific settings, including window size, font rendering, cursor behavior, and disabling unnecessary UI elements.
  • Improves color handling and terminal display with 256-color support and true color.

Syntax, Indentation, and Formatting:

  • Enables syntax highlighting and filetype-based indentation plugins.
  • Configures indentation style (spaces instead of tabs, 4 spaces per indentation level).
  • Automatically wraps comments and disables smart indenting features for better manual control.

Status Line:

  • Customizes the status line to show relevant information such as paste mode, wrap status, filename, line/column number, and current Git branch.

Window and Layout Settings:

  • Sets split window behavior (e.g., splits right and below).
  • Configures window size and scrolling behavior.

Backup and Undo Settings:

  • Disables backup files and sets undo options (e.g., persistent undo with undo files).

Key Mappings and Shortcuts:

  • Assigns useful key mappings (e.g., tabs, grep, for writing files, changing directories, adjusting font size).
  • Custom leader key (,), allowing for personalized shortcuts.

Search Settings:

  • Configures incremental search, case-sensitive search (smartcase), and disables search wrapping.

Language and Spell Check:

  • Configures spell checking and defines custom dictionary and thesaurus files.

Clipboard Integration:

  • Supports clipboard integration (copy/paste between Vim and external applications) when available.

File Type Specific Settings:

  • Defines custom settings for specific file types (e.g., Dockerfile, YAML, Python, Shell, Vim).

Autocommands:

  • Uses autocommands to automate behaviors like adjusting settings when a file type is detected or resizing windows on Vim resize events.

Mouse Configuration:

  • Configures mouse support in various modes, including the ability to drag and select text within Vim without switching to visual mode.

Optimization Settings:

  • Includes optimizations for smooth scrolling and fast terminal connections, including reducing screen redraw times.

Smart Write Function:

  • Defines a function (smart_write) to save files intelligently, ensuring proper handling of modified and non-modified files.

Better tabline:

  • Enhance the visual clarity of the tabline by displaying solely the filename and removing unnecessary information.

Useful functions:

  • Select pasted text
  • Search the current selection using //, *, or #.

Links

Related posts:

  1. easysession.el – Easily persist and restore your Emacs editing sessions
  2. Master the HJKL navigation with the Vim plugin Hjklmode, which can help breaking the habit of moving the right hand away from the home row
  3. Vim: Edit all the files in the current directory of a Git repository in new tabs (git ls-files)
  4. Vim: Enhance Vim tabs (file name only, file status, and the ability to rename tabs)
  5. Vim script: Replace the home directory with a tilde ~
  6. A Vim plugin for persisting and restoring Vim editing sessions easily and effortlessly
  7. Vim theme: tomorrow-night-deepblue, a refreshing color scheme with a deep blue background
  8. Efficient Emacs startup and configuration with minimal-emacs.d
  9. A Vim function that returns all monospaced fonts (UNIX / Linux only)
  10. Vim: Tango color scheme for Vim’s built-in Terminal
  11. Vim: Open documentation in a new tab for the word under the cursor (Vim help, Python, man pages, Markdown, Ansible…)
  12. How to make Vim edit/diff files from outside of Vim? (e.g. from a shell like Bash, Zsh, Fish..)
  13. Vim: Quickly replace the word that is under the cursor
  14. Set up Vim to use Fasd for quickly jumping to directories
  15. bash-stdops – A collection of useful Bash Shell Scripts
  16. Emacs: Toggling symbol highlighting with unique colors for each symbol using built-in functions
  17. Gentoo Linux: Printer driver for the Brother QL-1110NWB
  18. Running Large Language Models locally with Ollama (compatible with Linux, macOS, and Windows)
  19. Python: Tab completion against a list of strings (readline)
  20. Vim to Emacs: Converting code snippets from Ultisnips to YASnippet format

Leave a Reply

Your email address will not be published. Required fields are marked *