mirror of
https://github.com/LunarVim/LunarVim.git
synced 2024-09-21 11:05:08 +02:00
729 lines
30 KiB
Markdown
729 lines
30 KiB
Markdown
![LunarVim Demo](./utils/media/lunarvim_logo_dark.png)
|
||
|
||
<div align="center"><p>
|
||
<a href="https://github.com/ChristianChiarulli/LunarVim/releases/latest">
|
||
<img alt="Latest release" src="https://img.shields.io/github/v/release/ChristianChiarulli/LunarVim" />
|
||
</a>
|
||
<a href="https://github.com/ChristianChiarulli/sniprun/releases">
|
||
<img alt="Total downloads" src="https://img.shields.io/github/downloads/ChristianChiarulli/LunarVim/total" />
|
||
</a>
|
||
<a href="https://github.com/ChristianChiarulli/LunarVim/pulse">
|
||
<img alt="Last commit" src="https://img.shields.io/github/last-commit/ChristianChiarulli/LunarVim"/>
|
||
</a>
|
||
<a href="https://patreon.com/chrisatmachine" title="Donate to this project using Patreon">
|
||
<img src="https://img.shields.io/badge/patreon-donate-yellow.svg" alt="Patreon donate button" />
|
||
</a>
|
||
<a href="https://twitter.com/intent/follow?screen_name=chrisatmachine">
|
||
<img src="https://img.shields.io/twitter/follow/chrisatmachine?style=social&logo=twitter" alt="follow on Twitter">
|
||
</a>
|
||
</p>
|
||
</div>
|
||
|
||
![LunarVim Demo](./utils/media/demo.png)
|
||
|
||
# Table of contents
|
||
|
||
- [What’s included?](#whats-included)
|
||
* [Why do I want tree-sitter and LSP?](#why-do-i-want-tree-sitter-and-lsp)
|
||
- [Project Goals](#project-goals)
|
||
- [Install In One Command!](#install-in-one-command)
|
||
* [Get the latest version of Neovim](#get-the-latest-version-of-neovim)
|
||
* [Manual Install](#manual-install)
|
||
* [Troubleshooting installation
|
||
problems](#troubleshooting-installation-problems)
|
||
- [Getting started](#getting-started)
|
||
* [Home screen](#home-screen)
|
||
* [Leader and Whichkey](#leader-and-whichkey)
|
||
* [Important Configuration files](#important-configuration-files)
|
||
- [Install your own plugins](#install-your-own-plugins)
|
||
* [An example installation of the colorizer plugin](#an-example-installation-of-the-colorizer-plugin)
|
||
* [Finding plugins](#finding-plugins)
|
||
- [Using Packer](#using-packer)
|
||
* [Packer commands](#packer-commands)
|
||
* [Packer reports missing plugins](#packer-reports-missing-plugins)
|
||
- [Clipboard Support](#clipboard-support)
|
||
- [LSP](#lsp)
|
||
* [Lsp errors](#lsp-errors)
|
||
+ [Understanding LspInfo](#understanding-lspinfo)
|
||
+ [Example configurations](#example-configurations)
|
||
* [Last resort](#last-resort)
|
||
- [Useful Programs](#useful-programs)
|
||
- [EFM server](#efm-server)
|
||
- [Formatters and Linters](#formatters-and-linters)
|
||
- [De-bugging](#de-bugging)
|
||
- [VSCodium](#vscodium)
|
||
- [Color Schemes](#color-schemes)
|
||
* [Available colorschemes](#available-colorschemes)
|
||
* [Switching colors](#switching-colors)
|
||
- [Useful commands for
|
||
troubleshooting](#useful-commands-for-troubleshooting)
|
||
- [Uninstalling](#uninstalling)
|
||
- [Community links](#community-links)
|
||
- [TODO](#todo)
|
||
|
||
# What’s included?
|
||
|
||
LunarVim provides neovim configuration files that take advantage of
|
||
tree-sitter and language server protocol. The configuration is written
|
||
in lua.
|
||
|
||
## Why do I want tree-sitter and LSP?
|
||
|
||
- Normally, an editor uses regular expression parsing for things like
|
||
highlighting and checking the syntax of your file. Each time you make
|
||
a change, the editor must re-parse the entire file. Tree-sitter, on
|
||
the other hand, transforms text into a syntax tree. Each time you make
|
||
a change, only the parts of the code that change need to be parsed.
|
||
This greatly improves the speed of parsing. This can make a huge
|
||
difference when editing large files.
|
||
|
||
- Neovim 0.5 including language server protocol means your editor can
|
||
provide: code actions, completions, formatting, navigating to
|
||
definitions, renaming, etc. The language server only has to be written
|
||
once and will work on any editor that supports LSP. Any improvements
|
||
made to the language server will immediately be used by all editors
|
||
that support LSP.
|
||
|
||
# Project Goals
|
||
|
||
- This project aims to help one transition away from VSCode, and into a
|
||
superior text editing experience. (Just making this clear)
|
||
|
||
- This is also a community project, if you would like to see support for
|
||
a feature or
|
||
[language](https://github.com/neovim/nvim-lspconfig/blob/master/CONFIG.md)
|
||
consider making a PR.
|
||
|
||
- This project will do it’s best to include core features you would
|
||
expect from a modern IDE, while making it easy to add or remove what
|
||
the user wants.
|
||
|
||
# Install In One Command!
|
||
|
||
Make sure you have the newest version of Neovim (0.5).
|
||
|
||
``` bash
|
||
bash <(curl -s https://raw.githubusercontent.com/ChristianChiarulli/lunarvim/master/utils/installer/install.sh)
|
||
```
|
||
|
||
After installation run `nvim` and then `:PackerInstall`
|
||
|
||
## Get the latest version of Neovim
|
||
|
||
Some operating systems package versions of Neovim 0.5. You can install
|
||
those or you can follow the steps below to compile from source.
|
||
Compiling from source is the recommended method.
|
||
|
||
First, get the dependencies. For distributions other than Ubuntu or Arch
|
||
go
|
||
[here](https://github.com/neovim/neovim/wiki/Building-Neovim#build-prerequisites)
|
||
|
||
``` bash
|
||
#Ubuntu
|
||
sudo apt-get install gettext libtool libtool-bin autoconf automake cmake g++ pkg-config unzip build-essential
|
||
#Arch
|
||
sudo pacman -S base-devel cmake unzip ninja tree-sitter
|
||
```
|
||
|
||
Download and compile Neovim
|
||
|
||
``` bash
|
||
cd $(mktemp -d)
|
||
git clone https://github.com/neovim/neovim --depth 1
|
||
cd neovim
|
||
sudo make CMAKE_BUILD_TYPE=Release install
|
||
cd ..
|
||
sudo rm -r neovim
|
||
```
|
||
|
||
or if you are on Arch you can get it from the AUR
|
||
|
||
``` bash
|
||
yay -S neovim-git
|
||
```
|
||
|
||
|
||
If you are on Gentoo you have to emerge the 9999 neovim version with luajit as the lua single target
|
||
|
||
## Manual install
|
||
|
||
First make sure you have version [0.5 of
|
||
neovim](#get-the-latest-version-of-neovim).
|
||
|
||
Back up your current configuration files
|
||
|
||
```bash
|
||
mv ~/.config/nvim ~/.config/nvim.bak
|
||
```
|
||
|
||
Install xclip, python3, ripgrep, fzf, npm, nodejs, pip, and ranger with the package manager for your distribution.
|
||
|
||
```bash
|
||
# Ubuntu
|
||
sudo apt install xclip python3-pip nodejs npm ripgrep fzf ranger libjpeg8-dev zlib1g-dev python-dev python3-dev libxtst-dev python3-pip
|
||
|
||
# Arch
|
||
sudo pacman -S xclip python python-pip nodejs npm ripgrep fzf ranger
|
||
|
||
# Fedora
|
||
sudo dnf groupinstall "X Software Development"
|
||
sudo dnf install -y xclip python3-devel pip nodejs npm ripgrep fzf ranger
|
||
pip3 install wheel ueberzug
|
||
|
||
# Gentoo
|
||
sudo emerge -avn sys-apps/ripgrep app-shells/fzf app-misc/ranger dev-python/neovim-remote virtual/jpeg sys-libs/zlib
|
||
sudo emerge -avn dev-python/pip
|
||
# Optional. Enable npm USE flag with flaggie
|
||
sudo flaggie net-libs/nodejs +npm
|
||
sudo emerge -avnN net-libs/nodejs
|
||
|
||
# Mac
|
||
brew install lua node yarn ripgrep fzf ranger
|
||
sudo curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py
|
||
python3 get-pip.py
|
||
rm get-pip.py
|
||
```
|
||
|
||
Install tree-sitter. To globally install packages without the need for sudo
|
||
follow [this guide](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally)
|
||
|
||
```bash
|
||
npm install -g tree-sitter-cli
|
||
```
|
||
|
||
Install ueberzug, neovim-remote, and pynvim with pip3
|
||
|
||
```bash
|
||
pip3 install ueberzug neovim neovim-remote pynvim --user
|
||
```
|
||
|
||
Clone LunarVim and Packer
|
||
|
||
```bash
|
||
git clone https://github.com/wbthomason/packer.nvim ~/.local/share/nvim/site/pack/packer/start/packer.nvim
|
||
git clone https://github.com/ChristianChiarulli/lunarvim.git ~/.config/nvim
|
||
```
|
||
|
||
Install plugins
|
||
```
|
||
nvim -u $HOME/.config/nvim/init.lua +PackerInstall
|
||
```
|
||
|
||
## Troubleshooting installation problems
|
||
If you encounter problems with the installation check the following:
|
||
1. Make sure you have at least version 0.5 of neovim.
|
||
2. Make sure neovim was compiled with luajit.
|
||
```bash
|
||
# The output of version information should include a line for: LuaJIT
|
||
nvim -v
|
||
```
|
||
3. If you ran the [quick-install script](#install-in-one-command) using sudo, follow the steps to [uninstall](#uninstalling) and try again without sudo.
|
||
4. Make sure the [dependencies](#useful-programs) were installed.
|
||
5. Make sure your plugins are installed and updated. Run :PackerSync
|
||
|
||
# Getting started
|
||
|
||
## Home screen
|
||
|
||
The home screen is a plugin called
|
||
[Dashboard](https://github.com/glepnir/dashboard-nvim). It uses the
|
||
[Telescope](https://github.com/nvim-telescope/telescope.nvim) plugin to
|
||
find files or find words within files. The home screen provides a link
|
||
to load saved Sessions. The home screen links to the settings file
|
||
located at this path: \~/.config/nvim/lv-settings.lua
|
||
|
||
## Leader and Whichkey
|
||
|
||
The default leader key is set to <Space>. Pressing it will also
|
||
open up [Whichkey](https://github.com/folke/which-key.nvim). Whichkey
|
||
will help you easily access many of the default keybindings. Whichkey
|
||
defines keymappings in this file:
|
||
\~/.config/nvim/lua/lv-which-key/init.lua
|
||
|
||
## Other key bindings
|
||
|
||
Other key bindings can be found in \~/.config/nvim/lua/keymappings.lua
|
||
|
||
If you already have a set of keybindings in vimscript that you prefer,
|
||
source your vimscript file from \~/.config/nvim/init.lua
|
||
|
||
Example:
|
||
|
||
``` lua
|
||
vim.cmd('source ~/.config/nvim/vimscript/keymappings.vim')
|
||
```
|
||
|
||
Or you can translate your old bindings to lua and keep them in the
|
||
provided keymappings file. Follow the lua guide available
|
||
[here](https://github.com/nanotee/nvim-lua-guide)
|
||
|
||
## Important Configuration files
|
||
|
||
| Path | Description |
|
||
|-------------------------------------|----------------------------|
|
||
| \~/.config/nvim/lv-settings.lua | The main settings file |
|
||
| \~/.config/nvim/lua/keymappings.lua | Key bindings |
|
||
| \~/.config/nvim/lua/plugins.lua | Add or remove plugins here |
|
||
|
||
# Install your own plugins
|
||
|
||
The steps for configuring your own plugin are:
|
||
1. Add the plugin to `plugins.lua`
|
||
2. If the plugin requires configuration, create a configuration file for it
|
||
3. If you created a configuration, require the file in `init.lua`
|
||
4. Use Packer to download and install the plugin
|
||
|
||
Please note that every plugin will require different configuration steps.
|
||
Follow the instructions provided by the README of plugin you're interested in. If
|
||
those instructions are written in lua, copy and paste the code they provide.
|
||
If the instructions are written in vimscript, either translate the code to
|
||
lua or wrap the vimscript in this lua function:
|
||
|
||
```lua
|
||
vim.cmd([[
|
||
YOUR_VIMSCRIPT_GOES_HERE
|
||
]])
|
||
```
|
||
|
||
## An example installation of the colorizer plugin
|
||
|
||
'use' is a function provided by the Packer plugin. In the example below,
|
||
we tell Packer to optionally load the plugin. This means the plugin will not
|
||
start unless some other function manually loads it.
|
||
|
||
The 'require_plugin' function is part of LunarVim. It loads the plugin.
|
||
|
||
``` lua
|
||
# ~/.config/nvim/lua/plugins.lua
|
||
use {"norcalli/nvim-colorizer.lua", opt = true}
|
||
require_plugin("nvim-colorizer.lua")
|
||
```
|
||
|
||
From the [ README ](https://github.com/norcalli/nvim-colorizer.lua) we find out [ Colorizer ](https://github.com/norcalli/nvim-colorizer.lua) is written and configured in lua.
|
||
Colorizer provides a setup function which must be called for the plugin to work correctly. So we create a folder 'lv-colorizer' and
|
||
a file 'init.lua'. And populate the file with the configuration mentioned in the
|
||
[ README ](https://github.com/norcalli/nvim-colorizer.lua)
|
||
|
||
|
||
``` lua
|
||
# ~/.config/nvim/lua/lv-colorizer/init.lua
|
||
require'colorizer'.setup()
|
||
```
|
||
|
||
We created the lua/lv-colorizer/init.lua file. Creating this file means that we've created a module. Now we need to make sure this module
|
||
gets loaded when we start neovim. 'require' is a lua function that loads
|
||
a module.
|
||
|
||
``` lua
|
||
# ~/.config/nvim/init.lua
|
||
require('lv-colorizer')
|
||
```
|
||
|
||
``` lua
|
||
:PackerCompile
|
||
:PackerInstall
|
||
```
|
||
|
||
The example above loads the plugin when neovim starts. If you want to take advantage of Packer's built-in lazy loading, do not use the 'require_plugin' function. Instead, define the loading strategy in Packer's 'use' method. For a more in-depth explantion, read the [Packer docs](https://github.com/wbthomason/packer.nvim)
|
||
|
||
## Finding plugins
|
||
|
||
If you want to find other plugins that take advantage of neovim’s latest
|
||
features go [here](https://github.com/rockerBOO/awesome-neovim)
|
||
|
||
# Using Packer
|
||
|
||
[Packer](https://github.com/wbthomason/packer.nvim) manages your
|
||
installed plugins. Any time you make changes to your list of plugins in
|
||
\~/.config/nvim/lua/plugins.lua you must first run the command
|
||
:PackerCompile then :PackerInstall. \#\# Packer commands
|
||
|
||
``` bash
|
||
-- You must run this or `PackerSync` whenever you make changes to your plugin configuration
|
||
:PackerCompile
|
||
|
||
-- Only install missing plugins
|
||
:PackerInstall
|
||
|
||
-- Update and install plugins
|
||
:PackerUpdate
|
||
|
||
-- Remove any disabled or unused plugins
|
||
:PackerClean
|
||
|
||
-- Performs `PackerClean` and then `PackerUpdate`
|
||
:PackerSync
|
||
|
||
-- View the status of your plugins
|
||
:PackerStatus
|
||
```
|
||
|
||
## Packer reports missing plugins
|
||
|
||
If you get an error message about missing plugins and the above commands
|
||
do not work, remove the plugin directory and reinstall from scratch.
|
||
|
||
``` bash
|
||
rm -rf ~/.local/share/nvim/site
|
||
:PackerCompile
|
||
:PackerInstall
|
||
```
|
||
|
||
# Clipboard Support
|
||
|
||
- On Mac `pbcopy` should be built-in
|
||
|
||
- Ubuntu
|
||
|
||
```bash
|
||
sudo apt install xclip
|
||
```
|
||
|
||
- Arch
|
||
|
||
```bash
|
||
sudo pacman -S xclip
|
||
```
|
||
|
||
- WSL2
|
||
|
||
Make sure ~/bin is in your path in this case.
|
||
|
||
```bash
|
||
curl -sLo/tmp/win32yank.zip https://github.com/equalsraf/win32yank/releases/download/v0.0.4/win32yank-x64.zip
|
||
unzip -p /tmp/win32yank.zip win32yank.exe > /tmp/win32yank.exe
|
||
chmod +x /tmp/win32yank.exe
|
||
mv /tmp/win32yank.exe ~/bin
|
||
```
|
||
|
||
# LSP
|
||
|
||
Neovim comes bundled with a language client but not a language server.
|
||
To install a supported language server:
|
||
|
||
``` md
|
||
:LspInstall <your_language_server>
|
||
```
|
||
|
||
See [LspInstall](https://github.com/kabouzeid/nvim-lspinstall) for more
|
||
info.
|
||
|
||
In order for Java LSP to work, edit `~/.local/share/nvim/lspinstall/java/jdtls.sh` and replace `WORKSPACE="$1"` with `WORKSPACE="$HOME/workspace"`
|
||
|
||
Most common languages should be supported out of the box, if yours is
|
||
not I would welcome a PR
|
||
|
||
## Lsp errors
|
||
|
||
LunarVim lists the attached lsp server in the bottom status bar. If it
|
||
says ‘No client connected’ use :LspInfo to troubleshoot.
|
||
|
||
### Understanding LspInfo
|
||
|
||
1. Make sure there is a client attached to the buffer. 0 attached
|
||
clients means lsp is not running
|
||
2. Active clients are clients in other files you have open
|
||
3. Clients that match the filetype will be listed. If installed with
|
||
:LspInstall <servername> the language servers will be installed.
|
||
4. ‘cmd’ must be populated. This is the language server executable. If
|
||
the ‘cmd’ isn’t set or if it’s not executable you won’t be able to
|
||
run the language server.
|
||
* In the example below ‘efm-langserver’ is the name of the binary
|
||
that acts as the langserver. If we run ‘which efm-langserver’ and we
|
||
get a location to the executable, it means the langauge server is
|
||
installed and available globally.
|
||
* If you know the command is installed AND you don’t want to install
|
||
it globally you’ll need to manually set 'cmd' in the language server
|
||
settings.
|
||
* Configurations are stored in ~/.config/nvim/lua/lsp/
|
||
The settings will be stored in a file that matches the name of the language.
|
||
e.g. python-ls.lua
|
||
* ‘identified root’ must also be populated. Most
|
||
language servers require you be inside a git repository for the root
|
||
to be detected. If you don’t want to initialize the directory as a
|
||
git repository, an empty .git/ folder will also work.
|
||
5. Some language servers get set up on a per project basis so you may
|
||
have to reinstall the language server when you move to a different
|
||
project.
|
||
|
||
### Example configurations
|
||
|
||
[ ======== LSP NOT running ======== ]
|
||
|
||
``` md
|
||
0 client(s) attached to this buffer:
|
||
|
||
0 active client(s):
|
||
|
||
Clients that match the filetype python:
|
||
|
||
Config: efm
|
||
cmd: /Users/my-user/.local/share/nvim/lspinstall/efm/efm-langserver
|
||
cmd is executable: True
|
||
identified root: None
|
||
custom handlers:
|
||
|
||
Config: pyright
|
||
cmd: /Users/my-user/.local/share/nvim/lspinstall/python/node_modules/.bin/pyright-langserver --stdio
|
||
cmd is executable: True
|
||
identified root: None
|
||
custom handlers: textDocument/publishDiagnostics
|
||
```
|
||
|
||
---
|
||
|
||
[ ======== LSP IS running ======== ]
|
||
|
||
``` md
|
||
2 client(s) attached to this buffer: pyright, efm
|
||
|
||
Client: pyright (id 1)
|
||
root: /home/my-user/workspace/canary
|
||
filetypes: python
|
||
cmd: /home/my-user/.local/share/nvim/lspinstall/python/node_modules/.bin/pyright-langserver --stdio
|
||
|
||
|
||
Client: efm (id 2)
|
||
root: /home/my-user/workspace/canary
|
||
filetypes: lua, python, javascriptreact, javascript, typescript, typescriptreact, sh, html, css, json, yaml, markdown, vue
|
||
cmd: /home/my-user/.local/share/nvim/lspinstall/efm/efm-langserver
|
||
```
|
||
|
||
### Last resort
|
||
|
||
If you still have problems after implementing the above measures, rule
|
||
out plugin problems with the following. This reinstalls your plugins and
|
||
language servers.
|
||
|
||
``` md
|
||
rm -rf ~/.local/share/nvim/site
|
||
:PackerCompile
|
||
:PackerInstall
|
||
:LspInstall python <-- REPLACE WITH YOUR OWN LANGUAGE
|
||
:LspInstall efm <-- REPLACE WITH YOUR OWN LANGUAGE
|
||
```
|
||
|
||
For a more in depth LSP support:
|
||
[link](https://github.com/neovim/nvim-lspconfig/blob/master/CONFIG.md)
|
||
|
||
# Useful Programs
|
||
|
||
LunarVim depends on the following:
|
||
|
||
``` bash
|
||
ranger
|
||
ueberzug
|
||
ripgrep
|
||
pynvim
|
||
neovim-remote
|
||
```
|
||
|
||
# EFM server
|
||
|
||
In order for linters and formatters to work you will need to install
|
||
`efm-langserver`
|
||
|
||
``` vim
|
||
:LspInstall efm
|
||
```
|
||
|
||
# Formatters and Linters
|
||
|
||
**Python**
|
||
|
||
``` bash
|
||
pip3 install --user flake8
|
||
pip3 install --user yapf
|
||
```
|
||
|
||
**Lua**
|
||
|
||
``` bash
|
||
luarocks install --server=https://luarocks.org/dev luaformatter
|
||
```
|
||
|
||
**Yaml, Json, Javascript, HTML, CSS**
|
||
|
||
``` bash
|
||
npm install -g prettier
|
||
```
|
||
|
||
**Markdown**
|
||
|
||
``` bash
|
||
pandoc
|
||
```
|
||
|
||
# De-bugging
|
||
|
||
To set up your particular debugger, look here:
|
||
[link](https://github.com/mfussenegger/nvim-dap/wiki/Debug-Adapter-installation)
|
||
|
||
# VSCodium
|
||
|
||
I recommend you support Free/Libre versions if you plan to use VSCode:
|
||
|
||
- [VSCodium](https://vscodium.com/)
|
||
|
||
- Article to get you set up with VSCodium:
|
||
[link](https://www.chrisatmachine.com/Neovim/22-vscodium-neovim/)
|
||
|
||
After installing the [Neovim
|
||
extension](https://github.com/asvetliakov/vscode-neovim) in VSCode
|
||
|
||
I recommend using this alongside the VSCode
|
||
[which-key](https://github.com/VSpaceCode/vscode-which-key) extension
|
||
|
||
You will also need `settings.json` and `keybindings.json` which can be
|
||
found in utils/vscode\_config
|
||
|
||
Point the nvim path to your `nvim` binary
|
||
|
||
Point your `init.vim` path to:
|
||
|
||
``` vim
|
||
$HOME/.config/nvim/vimscript/lv-vscode/init.vim
|
||
```
|
||
|
||
# Color schemes
|
||
|
||
Color schemes are provided by [this
|
||
repository](https://github.com/ChristianChiarulli/nvcode-color-schemes.vim).
|
||
Follow that link for information about editing specific colors for a
|
||
color scheme. The provided color schemes are compatible with tree-sitter
|
||
highlight groups. Color schemes are installed to
|
||
\~/.local/share/nvim/site/pack/packer/opt/nvcode-color-schemes.vim. If
|
||
you edit files in that directory, they will be overwritten the next time
|
||
Packer compiles your plugins.
|
||
|
||
## Available colorschemes:
|
||
|
||
``` bash
|
||
nvcode (basically just dark+)
|
||
onedark
|
||
nord
|
||
aurora (more colorful nord)
|
||
gruvbox
|
||
palenight
|
||
snazzy (Based on hyper-snazzy by Sindre Sorhus)
|
||
```
|
||
|
||
## Switching colors
|
||
|
||
To switch color schemes on the fly, type the following command:
|
||
|
||
``` vim
|
||
:Telescope colorscheme
|
||
```
|
||
|
||
To change the color scheme permanently, modify
|
||
\~/.config/nvim/lv-settings.lua
|
||
|
||
``` lua
|
||
O.colorscheme = 'lunar'
|
||
```
|
||
|
||
# Useful commands for troubleshooting
|
||
|
||
Whether you plan on using LunarVim as is or as a base to configure your
|
||
own neovim, the following commands may be useful. Any command that
|
||
includes the symbol ‘:’ is meant to be typed as a command in neovim.
|
||
Make sure you’re in normal mode not insert mode.
|
||
|
||
| Command | Description |
|
||
|----------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
|
||
| :checkhealth | Check the health of your neovim install |
|
||
| :checkhealth <pluginname> | Check the health of a plugin |
|
||
| nvim -v | checks your neovim version |
|
||
| nvim -V | vebose output when running neovim. Prints out every event |
|
||
| :PackerCompile | Must be run when you make plugin changes. (or, alternately run :PackerSync) |
|
||
| :PackerInstall | Only install missing plugins |
|
||
| :PackerUpdate | Update and install plugins |
|
||
| :PackerClean | Remove any disabled or unused plugins |
|
||
| :PackerSync | Performs ‘PackerClean’ then ‘PackerUpdate’ |
|
||
| :PackerStatus | List the status of your plugins |
|
||
| :LspInstall <language> | Install a language server for a specific programming language |
|
||
| :LspInfo | List the status of active and configured language servers |
|
||
| :LspStart <language> | Start the requested server name. Will only succesfully start if the command detects a root directory matching the current config. Pass autostart = false to your .setup{} call for a language server if you would like to launch clients solely with this command. Defaults to all servers matching current buffer filetype. |
|
||
| :LspStop | Stops all buffer clients |
|
||
| :LspRestart | Restarts all buffer clients |
|
||
| :map | List keybindings |
|
||
| :nmap | List normal mode keybindings |
|
||
| :vmap | List visual mode keybindings |
|
||
| :imap | List insert mode keybindings |
|
||
| :verbose imap <keybinding> | Print out what a particular keybinding is mapped to |
|
||
| :messages | Print error messages. Useful when messages get cut off |
|
||
| :scriptnames | List all sourced files |
|
||
|
||
# Uninstalling
|
||
|
||
Changed your mind about LunarVim? To remove it entirely:
|
||
|
||
``` lua
|
||
# Delete the configuration files
|
||
rm -R ~/.config/nvim
|
||
|
||
# Delete the plugins
|
||
rm -Rf ~/.local/share/nvim
|
||
|
||
# Delete the logs
|
||
rm -R ~/.cache/nvim
|
||
```
|
||
|
||
# Community links
|
||
|
||
🕸️ Website: https://www.chrisatmachine.com
|
||
|
||
🐦 Twitter: https://twitter.com/chrisatmachine
|
||
|
||
💻 Github: https://github.com/ChristianChiarulli
|
||
|
||
📺 YouTube: https://www.youtube.com/channel/UCS97tchJDq17Qms3cux8wcA
|
||
|
||
📺 Odysee: https://odysee.com/@chrisatmachine:f
|
||
|
||
📺 Twitch: https://www.twitch.tv/chrisatmachine
|
||
|
||
🗨️ Matrix: https://matrix.to/#/+atmachine:matrix
|
||
|
||
🗨️ Discord: https://discord.gg/Xb9B4Ny
|
||
|
||
# TODO
|
||
|
||
**HIGH PRIORITY**
|
||
|
||
- Move user config into `config.lua` ts-comment string for react
|
||
- From here I will update for bug fixes and implement low priority
|
||
features when I have time
|
||
- different key to advance through snippets
|
||
|
||
**LOW PRIORITY**
|
||
|
||
- vim vsnips dir should be co-located with config
|
||
- list all binaries needed for formatters and linters (one day add in
|
||
wiki)
|
||
- Implement what I can from this java config:
|
||
[link](https://github.com/mfussenegger/nvim-jdtls/wiki/Sample-Configurations)
|
||
- better ui for code actions - formatting
|
||
- setup junit tests for java
|
||
- look into emmet-ls
|
||
- vim ult test
|
||
- which-key all in lua
|
||
- what is `fzy`
|
||
- https://github.com/pwntester/octo.nvim
|
||
- configure surround
|
||
- Implement this for typescript
|
||
https://github.com/jose-elias-alvarez/nvim-lsp-ts-utils
|
||
- look into tabnine
|
||
|
||
**PLUGIN BUGS**
|
||
|
||
REACT COMMENTING IS A NIGHTMARE (the filetype is just not recognized idk
|
||
why)
|
||
|
||
[![GitHub
|
||
license](https://img.shields.io/github/license/ChristianChiarulli/LunarVim)](https://github.com/ChristianChiarulli/LunarVim/blob/master/LICENSE)
|
||
[![Open Source?
|
||
Yes!](https://badgen.net/badge/Open%20Source%20%3F/Yes%21/blue?icon=github)](https://github.com/ChristianChiarulli/lunarvim)
|
||
[![PRs
|
||
Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
|