2024-01-10 12:28:46 +00:00
## Introduction
2023-02-17 21:31:57 +00:00
2024-01-10 12:28:46 +00:00
This project is a fork of [kickstart.nvim ](https://github.com/nvim-lua/kickstart.nvim )
2023-07-01 15:21:10 +00:00
2022-06-24 03:35:53 +00:00
2024-01-10 12:28:46 +00:00
### Installation (Windows Only)
2022-06-24 03:35:53 +00:00
2024-01-10 12:28:46 +00:00
> **NOTE**
2023-09-05 12:12:56 +00:00
> [Backup](#FAQ) your previous configuration (if any exists)
2024-01-10 12:28:46 +00:00
Neovim's configurations are located under the following path:
2023-09-05 12:12:56 +00:00
2024-01-10 12:28:46 +00:00
| Shell | PATH |
2023-09-05 12:12:56 +00:00
| :- | :--- |
2024-01-10 12:28:46 +00:00
| cmd | `%userprofile%\AppData\Local\nvim\` |
| powershell | `$env:USERPROFILE\AppData\Local\nvim\` |
- Download and install:
2024-01-10 14:12:59 +00:00
- [ripgrep ](https://github.com/BurntSushi/ripgrep#installation )
2024-01-10 12:28:46 +00:00
- [MinGW ](https://www.mingw-w64.org/ )
> **NOTE**
> In this case, using [chocolatey](https://chocolatey.org/) is quick and easy
- [CMake ](https://cmake.org/ )
> **NOTE**
> Make sure to select 'add to PATH' during installation
- [MSBuild-Tools ](https://github.com/bycloudai/InstallVSBuildToolsWindows )
- Clone this repository:
- on Windows (cmd)
```
git clone https://github.com/Baipyrus/nvim-config.git %userprofile%\AppData\Local\nvim\
```
- on Windows (powershell)
```
git clone https://github.com/Baipyrus/nvim-config.git $env:USERPROFILE\AppData\Local\nvim\
```
2023-11-03 12:47:30 +00:00
2023-09-05 12:12:56 +00:00
### Post Installation
2023-10-25 19:46:24 +00:00
Start Neovim
```sh
nvim
```
2024-01-10 12:28:46 +00:00
The `Lazy` plugin manager will start automatically on the first run and install the configured plugins. After the installation is complete you can press `q` to close the `Lazy` UI and **you are ready to go** ! Next time you run nvim `Lazy` will no longer show up.
2023-10-25 19:46:24 +00:00
If you would prefer to hide this step and run the plugin sync from the command line, you can use:
2023-09-05 12:12:56 +00:00
```sh
nvim --headless "+Lazy! sync" +qa
```
2022-12-20 18:27:01 +00:00
### FAQ
2023-02-17 21:31:57 +00:00
* What should I do if I already have a pre-existing neovim configuration?
* You should back it up, then delete all files associated with it.
2024-01-10 12:28:46 +00:00
* This includes your existing init.lua and the neovim files in `%userprofile%\AppData\Local\nvim-data\` (CMD) or `$env:USERPROFILE\AppData\Local\nvim-data\` (Powershell) which should be deleted afterwards.
2023-02-17 21:31:57 +00:00
* You may also want to look at the [migration guide for lazy.nvim ](https://github.com/folke/lazy.nvim#-migration-guide )
* What if I want to "uninstall" this configuration:
* See [lazy.nvim uninstall ](https://github.com/folke/lazy.nvim#-uninstalling ) information
2023-11-03 18:04:25 +00:00
* Why is the kickstart `init.lua` a single file? Wouldn't it make sense to split it into multiple files?
* The main purpose of kickstart is to serve as a teaching tool and a reference
configuration that someone can easily `git clone` as a basis for their own.
As you progress in learning Neovim and Lua, you might consider splitting `init.lua`
into smaller parts. A fork of kickstart that does this while maintaining the exact
same functionality is available here:
* [kickstart-modular.nvim ](https://github.com/dam9000/kickstart-modular.nvim )
* Discussions on this topic can be found here:
* [Restructure the configuration ](https://github.com/nvim-lua/kickstart.nvim/issues/218 )
* [Reorganize init.lua into a multi-file setup ](https://github.com/nvim-lua/kickstart.nvim/pull/473 )
2023-02-17 21:31:57 +00:00