Skip to content

Commit 28af9f8

Browse files
Changing the README.md as dotstyle suggested
1 parent 35aeb42 commit 28af9f8

File tree

1 file changed

+69
-191
lines changed

1 file changed

+69
-191
lines changed

README.md

Lines changed: 69 additions & 191 deletions
Original file line numberDiff line numberDiff line change
@@ -1,228 +1,106 @@
1-
# kickstart.nvim
1+
# kickstart.nvim/
22

3-
## Introduction
3+
<a href="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim"><img src="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim/badges/plugins?style=flat" /></a>
4+
<a href="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim"><img src="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim/badges/leaderkey?style=flat" /></a>
5+
<a href="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim"><img src="https://dotfyle.com/juanmiguelRuaDev/kickstartnvim/badges/plugin-manager?style=flat" /></a>
46

5-
A starting point for Neovim that is:
67

7-
* Small
8-
* Single-file
9-
* Completely Documented
8+
## Install Instructions
109

11-
**NOT** a Neovim distribution, but instead a starting point for your configuration.
10+
> Install requires Neovim 0.9+. Always review the code before installing a configuration.
1211
13-
## Installation
14-
15-
### Install Neovim
16-
17-
Kickstart.nvim targets *only* the latest
18-
['stable'](https://github.com/neovim/neovim/releases/tag/stable) and latest
19-
['nightly'](https://github.com/neovim/neovim/releases/tag/nightly) of Neovim.
20-
If you are experiencing issues, please make sure you have the latest versions.
21-
22-
### Install External Dependencies
23-
24-
External Requirements:
25-
- Basic utils: `git`, `make`, `unzip`, C Compiler (`gcc`)
26-
- [ripgrep](https://github.com/BurntSushi/ripgrep#installation)
27-
- A [Nerd Font](https://www.nerdfonts.com/): optional, provides various icons
28-
- if you have it set `vim.g.have_nerd_font` in `init.lua` to true
29-
- Language Setup:
30-
- If want to write Typescript, you need `npm`
31-
- If want to write Golang, you will need `go`
32-
- etc.
33-
34-
> **NOTE**
35-
> See [Install Recipes](#Install-Recipes) for additional Windows and Linux specific notes
36-
> and quick install snippets
37-
38-
### Install Kickstart
39-
40-
> **NOTE**
41-
> [Backup](#FAQ) your previous configuration (if any exists)
42-
43-
Neovim's configurations are located under the following paths, depending on your OS:
44-
45-
| OS | PATH |
46-
| :- | :--- |
47-
| Linux, MacOS | `$XDG_CONFIG_HOME/nvim`, `~/.config/nvim` |
48-
| Windows (cmd)| `%userprofile%\AppData\Local\nvim\` |
49-
| Windows (powershell)| `$env:USERPROFILE\AppData\Local\nvim\` |
50-
51-
#### Recommended Step
52-
53-
[Fork](https://docs.github.com/en/get-started/quickstart/fork-a-repo) this repo
54-
so that you have your own copy that you can modify, then install by cloning the
55-
fork to your machine using one of the commands below, depending on your OS.
56-
57-
> **NOTE**
58-
> Your fork's url will be something like this:
59-
> `https://github.com/<your_github_username>/kickstart.nvim.git`
60-
61-
#### Clone kickstart.nvim
62-
> **NOTE**
63-
> If following the recommended step above (i.e., forking the repo), replace
64-
> `nvim-lua` with `<your_github_username>` in the commands below
65-
66-
<details><summary> Linux and Mac </summary>
12+
Clone the repository and install the plugins:
6713

6814
```sh
69-
git clone https://github.com/nvim-lua/kickstart.nvim.git "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim
70-
```
71-
72-
</details>
73-
74-
<details><summary> Windows </summary>
75-
76-
If you're using `cmd.exe`:
77-
78-
```
79-
git clone https://github.com/nvim-lua/kickstart.nvim.git %userprofile%\AppData\Local\nvim\
15+
git clone [email protected]:juanmiguelRuaDev/kickstart.nvim ~/.config/juanmiguelRuaDev/kickstart.nvim
8016
```
8117

82-
If you're using `powershell.exe`
83-
84-
```
85-
git clone https://github.com/nvim-lua/kickstart.nvim.git $env:USERPROFILE\AppData\Local\nvim\
86-
```
87-
88-
</details>
89-
90-
### Post Installation
91-
92-
Start Neovim
18+
Open Neovim with this config:
9319

9420
```sh
95-
nvim
21+
NVIM_APPNAME=juanmiguelRuaDev/kickstart.nvim/ nvim
9622
```
9723

98-
That's it! Lazy will install all the plugins you have. Use `:Lazy` to view
99-
current plugin status. Hit `q` to close the window.
24+
## Plugins
10025

101-
Read through the `init.lua` file in your configuration folder for more
102-
information about extending and exploring Neovim. That also includes
103-
examples of adding popularly requested plugins.
26+
### colorscheme
10427

28+
+ [catppuccin/nvim](https://dotfyle.com/plugins/catppuccin/nvim)
29+
+ [folke/tokyonight.nvim](https://dotfyle.com/plugins/folke/tokyonight.nvim)
30+
### comment
10531

106-
### Getting Started
32+
+ [numToStr/Comment.nvim](https://dotfyle.com/plugins/numToStr/Comment.nvim)
33+
+ [folke/todo-comments.nvim](https://dotfyle.com/plugins/folke/todo-comments.nvim)
34+
### completion
10735

108-
[The Only Video You Need to Get Started with Neovim](https://youtu.be/m8C0Cq9Uv9o)
36+
+ [hrsh7th/nvim-cmp](https://dotfyle.com/plugins/hrsh7th/nvim-cmp)
37+
### debugging
10938

110-
### FAQ
39+
+ [rcarriga/nvim-dap-ui](https://dotfyle.com/plugins/rcarriga/nvim-dap-ui)
40+
+ [mfussenegger/nvim-dap](https://dotfyle.com/plugins/mfussenegger/nvim-dap)
41+
### editing-support
11142

112-
* What should I do if I already have a pre-existing neovim configuration?
113-
* You should back it up and then delete all associated files.
114-
* This includes your existing init.lua and the neovim files in `~/.local`
115-
which can be deleted with `rm -rf ~/.local/share/nvim/`
116-
* Can I keep my existing configuration in parallel to kickstart?
117-
* Yes! You can use [NVIM_APPNAME](https://neovim.io/doc/user/starting.html#%24NVIM_APPNAME)`=nvim-NAME`
118-
to maintain multiple configurations. For example, you can install the kickstart
119-
configuration in `~/.config/nvim-kickstart` and create an alias:
120-
```
121-
alias nvim-kickstart='NVIM_APPNAME="nvim-kickstart" nvim'
122-
```
123-
When you run Neovim using `nvim-kickstart` alias it will use the alternative
124-
config directory and the matching local directory
125-
`~/.local/share/nvim-kickstart`. You can apply this approach to any Neovim
126-
distribution that you would like to try out.
127-
* What if I want to "uninstall" this configuration:
128-
* See [lazy.nvim uninstall](https://github.com/folke/lazy.nvim#-uninstalling) information
129-
* Why is the kickstart `init.lua` a single file? Wouldn't it make sense to split it into multiple files?
130-
* The main purpose of kickstart is to serve as a teaching tool and a reference
131-
configuration that someone can easily use to `git clone` as a basis for their own.
132-
As you progress in learning Neovim and Lua, you might consider splitting `init.lua`
133-
into smaller parts. A fork of kickstart that does this while maintaining the
134-
same functionality is available here:
135-
* [kickstart-modular.nvim](https://github.com/dam9000/kickstart-modular.nvim)
136-
* Discussions on this topic can be found here:
137-
* [Restructure the configuration](https://github.com/nvim-lua/kickstart.nvim/issues/218)
138-
* [Reorganize init.lua into a multi-file setup](https://github.com/nvim-lua/kickstart.nvim/pull/473)
43+
+ [windwp/nvim-autopairs](https://dotfyle.com/plugins/windwp/nvim-autopairs)
44+
+ [nvim-treesitter/nvim-treesitter-context](https://dotfyle.com/plugins/nvim-treesitter/nvim-treesitter-context)
45+
### file-explorer
13946

140-
### Install Recipes
47+
+ [stevearc/oil.nvim](https://dotfyle.com/plugins/stevearc/oil.nvim)
48+
+ [nvim-neo-tree/neo-tree.nvim](https://dotfyle.com/plugins/nvim-neo-tree/neo-tree.nvim)
49+
### formatting
14150

142-
Below you can find OS specific install instructions for Neovim and dependencies.
51+
+ [stevearc/conform.nvim](https://dotfyle.com/plugins/stevearc/conform.nvim)
52+
### fuzzy-finder
14353

144-
After installing all the dependencies continue with the [Install Kickstart](#Install-Kickstart) step.
54+
+ [nvim-telescope/telescope.nvim](https://dotfyle.com/plugins/nvim-telescope/telescope.nvim)
55+
### git
14556

146-
#### Windows Installation
57+
+ [lewis6991/gitsigns.nvim](https://dotfyle.com/plugins/lewis6991/gitsigns.nvim)
58+
+ [kdheepak/lazygit.nvim](https://dotfyle.com/plugins/kdheepak/lazygit.nvim)
59+
### icon
14760

148-
<details><summary>Windows with Microsoft C++ Build Tools and CMake</summary>
149-
Installation may require installing build tools and updating the run command for `telescope-fzf-native`
61+
+ [nvim-tree/nvim-web-devicons](https://dotfyle.com/plugins/nvim-tree/nvim-web-devicons)
62+
### indent
15063

151-
See `telescope-fzf-native` documentation for [more details](https://github.com/nvim-telescope/telescope-fzf-native.nvim#installation)
64+
+ [lukas-reineke/indent-blankline.nvim](https://dotfyle.com/plugins/lukas-reineke/indent-blankline.nvim)
65+
### keybinding
15266

153-
This requires:
67+
+ [folke/which-key.nvim](https://dotfyle.com/plugins/folke/which-key.nvim)
68+
### lsp
15469

155-
- Install CMake and the Microsoft C++ Build Tools on Windows
70+
+ [neovim/nvim-lspconfig](https://dotfyle.com/plugins/neovim/nvim-lspconfig)
71+
+ [j-hui/fidget.nvim](https://dotfyle.com/plugins/j-hui/fidget.nvim)
72+
+ [mfussenegger/nvim-lint](https://dotfyle.com/plugins/mfussenegger/nvim-lint)
73+
+ [nvimtools/none-ls.nvim](https://dotfyle.com/plugins/nvimtools/none-ls.nvim)
74+
### lsp-installer
15675

157-
```lua
158-
{'nvim-telescope/telescope-fzf-native.nvim', build = 'cmake -S. -Bbuild -DCMAKE_BUILD_TYPE=Release && cmake --build build --config Release && cmake --install build --prefix build' }
159-
```
160-
</details>
161-
<details><summary>Windows with gcc/make using chocolatey</summary>
162-
Alternatively, one can install gcc and make which don't require changing the config,
163-
the easiest way is to use choco:
164-
165-
1. install [chocolatey](https://chocolatey.org/install)
166-
either follow the instructions on the page or use winget,
167-
run in cmd as **admin**:
168-
```
169-
winget install --accept-source-agreements chocolatey.chocolatey
170-
```
76+
+ [williamboman/mason.nvim](https://dotfyle.com/plugins/williamboman/mason.nvim)
77+
### nvim-dev
17178

172-
2. install all requirements using choco, exit previous cmd and
173-
open a new one so that choco path is set, and run in cmd as **admin**:
174-
```
175-
choco install -y neovim git ripgrep wget fd unzip gzip mingw make
176-
```
177-
</details>
178-
<details><summary>WSL (Windows Subsystem for Linux)</summary>
79+
+ [MunifTanjim/nui.nvim](https://dotfyle.com/plugins/MunifTanjim/nui.nvim)
80+
+ [nvim-lua/plenary.nvim](https://dotfyle.com/plugins/nvim-lua/plenary.nvim)
81+
+ [folke/neodev.nvim](https://dotfyle.com/plugins/folke/neodev.nvim)
82+
### plugin-manager
17983

180-
```
181-
wsl --install
182-
wsl
183-
sudo add-apt-repository ppa:neovim-ppa/unstable -y
184-
sudo apt update
185-
sudo apt install make gcc ripgrep unzip neovim
186-
```
187-
</details>
84+
+ [folke/lazy.nvim](https://dotfyle.com/plugins/folke/lazy.nvim)
85+
### snippet
18886

189-
#### Linux Install
190-
<details><summary>Ubuntu Install Steps</summary>
87+
+ [rafamadriz/friendly-snippets](https://dotfyle.com/plugins/rafamadriz/friendly-snippets)
88+
+ [L3MON4D3/LuaSnip](https://dotfyle.com/plugins/L3MON4D3/LuaSnip)
89+
### syntax
19190

192-
```
193-
sudo add-apt-repository ppa:neovim-ppa/unstable -y
194-
sudo apt update
195-
sudo apt install make gcc ripgrep unzip git neovim
196-
```
197-
</details>
198-
<details><summary>Debian Install Steps</summary>
91+
+ [echasnovski/mini.surround](https://dotfyle.com/plugins/echasnovski/mini.surround)
92+
+ [nvim-treesitter/nvim-treesitter-textobjects](https://dotfyle.com/plugins/nvim-treesitter/nvim-treesitter-textobjects)
93+
+ [nvim-treesitter/nvim-treesitter](https://dotfyle.com/plugins/nvim-treesitter/nvim-treesitter)
94+
### tabline
19995

200-
```
201-
sudo apt update
202-
sudo apt install make gcc ripgrep unzip git curl
203-
204-
# Now we install nvim
205-
curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim-linux64.tar.gz
206-
sudo rm -rf /opt/nvim-linux64
207-
sudo mkdir -p /opt/nvim-linux64
208-
sudo chmod a+rX /opt/nvim-linux64
209-
sudo tar -C /opt -xzf nvim-linux64.tar.gz
210-
211-
# make it available in /usr/local/bin, distro installs to /usr/bin
212-
sudo ln -sf /opt/nvim-linux64/bin/nvim /usr/local/bin/
213-
```
214-
</details>
215-
<details><summary>Fedora Install Steps</summary>
96+
+ [akinsho/bufferline.nvim](https://dotfyle.com/plugins/akinsho/bufferline.nvim)
97+
### utility
21698

217-
```
218-
sudo dnf install -y gcc make git ripgrep fd-find unzip neovim
219-
```
220-
</details>
99+
+ [echasnovski/mini.nvim](https://dotfyle.com/plugins/echasnovski/mini.nvim)
100+
## Language Servers
221101

222-
<details><summary>Arch Install Steps</summary>
102+
+ html
103+
+ tflint
223104

224-
```
225-
sudo pacman -S --noconfirm --needed gcc make git ripgrep fd unzip neovim
226-
```
227-
</details>
228105

106+
This readme was generated by [Dotfyle](https://dotfyle.com)

0 commit comments

Comments
 (0)