Modular branch

This commit is contained in:
smashblu 2024-09-19 21:32:25 -07:00
parent b84883d772
commit bb14eda4d2
20 changed files with 970 additions and 86 deletions

View file

@ -1,11 +1,13 @@
# kickstart.nvim
# kickstart-modular.nvim
## Introduction
*This is a fork of [nvim-lua/kickstart.nvim](https://github.com/nvim-lua/kickstart.nvim) that moves from a single file to a multi file configuration.*
A starting point for Neovim that is:
* Small
* Single-file
* Modular
* Completely Documented
**NOT** a Neovim distribution, but instead a starting point for your configuration.
@ -28,8 +30,8 @@ External Requirements:
- A [Nerd Font](https://www.nerdfonts.com/): optional, provides various icons
- if you have it set `vim.g.have_nerd_font` in `init.lua` to true
- Language Setup:
- If want to write Typescript, you need `npm`
- If want to write Golang, you will need `go`
- If you want to write Typescript, you need `npm`
- If you want to write Golang, you will need `go`
- etc.
> **NOTE**
@ -46,8 +48,8 @@ Neovim's configurations are located under the following paths, depending on your
| OS | PATH |
| :- | :--- |
| Linux, MacOS | `$XDG_CONFIG_HOME/nvim`, `~/.config/nvim` |
| Windows (cmd)| `%userprofile%\AppData\Local\nvim\` |
| Windows (powershell)| `$env:USERPROFILE\AppData\Local\nvim\` |
| Windows (cmd)| `%localappdata%\nvim\` |
| Windows (powershell)| `$env:LOCALAPPDATA\nvim\` |
#### Recommended Step
@ -57,17 +59,25 @@ fork to your machine using one of the commands below, depending on your OS.
> **NOTE**
> Your fork's url will be something like this:
> `https://github.com/<your_github_username>/kickstart.nvim.git`
> `https://github.com/<your_github_username>/kickstart-modular.nvim.git`
You likely want to remove `lazy-lock.json` from your fork's `.gitignore` file
too - it's ignored in the kickstart repo to make maintenance easier, but it's
[recommmended to track it in version control](https://lazy.folke.io/usage/lockfile).
#### Clone kickstart.nvim
> **NOTE**
> If following the recommended step above (i.e., forking the repo), replace
> `nvim-lua` with `<your_github_username>` in the commands below
> `dam9000` with `<your_github_username>` in the commands below
<details><summary> Linux and Mac </summary>
```sh
<<<<<<< HEAD
git clone https://github.com/smashblu/kickstart.nvim.git "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim
=======
git clone https://github.com/dam9000/kickstart-modular.nvim.git "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim
>>>>>>> modular/master
```
</details>
@ -77,13 +87,21 @@ git clone https://github.com/smashblu/kickstart.nvim.git "${XDG_CONFIG_HOME:-$HO
If you're using `cmd.exe`:
```
<<<<<<< HEAD
git clone https://github.com/smashblu/kickstart.nvim.git %userprofile%\AppData\Local\nvim\
=======
git clone https://github.com/dam9000/kickstart.nvim.git "%localappdata%\nvim"
>>>>>>> modular/master
```
If you're using `powershell.exe`
```
<<<<<<< HEAD
git clone https://github.com/smashblu/kickstart.nvim.git $env:USERPROFILE\AppData\Local\nvim\
=======
git clone https://github.com/dam9000/kickstart.nvim.git "${env:LOCALAPPDATA}\nvim"
>>>>>>> modular/master
```
</details>
@ -134,6 +152,9 @@ examples of adding popularly requested plugins.
into smaller parts. A fork of kickstart that does this while maintaining the
same functionality is available here:
* [kickstart-modular.nvim](https://github.com/dam9000/kickstart-modular.nvim)
* *NOTE: This is the fork that splits the configuration into smaller parts.*
The original repo with the single `init.lua` file is available here:
* [kickstart.nvim](https://github.com/nvim-lua/kickstart.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)