2023-02-17 21:31:57 +00:00
|
|
|
--[[
|
|
|
|
|
|
|
|
=====================================================================
|
|
|
|
==================== READ THIS BEFORE CONTINUING ====================
|
|
|
|
=====================================================================
|
2024-02-26 15:03:53 +00:00
|
|
|
======== .-----. ========
|
|
|
|
======== .----------------------. | === | ========
|
|
|
|
======== |.-""""""""""""""""""-.| |-----| ========
|
|
|
|
======== || || | === | ========
|
|
|
|
======== || KICKSTART.NVIM || |-----| ========
|
|
|
|
======== || || | === | ========
|
|
|
|
======== || || |-----| ========
|
|
|
|
======== ||:Tutor || |:::::| ========
|
|
|
|
======== |'-..................-'| |____o| ========
|
|
|
|
======== `"")----------------(""` ___________ ========
|
|
|
|
======== /::::::::::| |::::::::::\ \ no mouse \ ========
|
|
|
|
======== /:::========| |==hjkl==:::\ \ required \ ========
|
|
|
|
======== '""""""""""""' '""""""""""""' '""""""""""' ========
|
|
|
|
======== ========
|
|
|
|
=====================================================================
|
|
|
|
=====================================================================
|
2023-02-17 21:31:57 +00:00
|
|
|
|
2024-02-26 15:03:53 +00:00
|
|
|
What is Kickstart?
|
2023-02-17 21:31:57 +00:00
|
|
|
|
2024-02-26 15:03:53 +00:00
|
|
|
Kickstart.nvim is *not* a distribution.
|
2023-02-17 21:31:57 +00:00
|
|
|
|
2024-02-26 15:03:53 +00:00
|
|
|
Kickstart.nvim is a starting point for your own configuration.
|
|
|
|
The goal is that you can read every line of code, top-to-bottom, understand
|
|
|
|
what your configuration is doing, and modify it to suit your needs.
|
2023-02-17 21:31:57 +00:00
|
|
|
|
2024-02-26 15:03:53 +00:00
|
|
|
Once you've done that, you can start exploring, configuring and tinkering to
|
|
|
|
make Neovim your own! That might mean leaving kickstart just the way it is for a while
|
|
|
|
or immediately breaking it into modular pieces. It's up to you!
|
2023-08-10 19:00:15 +00:00
|
|
|
|
2024-02-26 15:03:53 +00:00
|
|
|
If you don't know anything about Lua, I recommend taking some time to read through
|
|
|
|
a guide. One possible example which will only take 10-15 minutes:
|
|
|
|
- https://learnxinyminutes.com/docs/lua/
|
2023-02-17 21:31:57 +00:00
|
|
|
|
2024-02-26 15:03:53 +00:00
|
|
|
After understanding a bit more about Lua, you can use `:help lua-guide` as a
|
|
|
|
reference for how Neovim integrates Lua.
|
|
|
|
- :help lua-guide
|
|
|
|
- (or HTML version): https://neovim.io/doc/user/lua-guide.html
|
2023-02-17 21:31:57 +00:00
|
|
|
|
|
|
|
Kickstart Guide:
|
|
|
|
|
2024-02-26 15:03:53 +00:00
|
|
|
TODO: The very first thing you should do is to run the command `:Tutor` in Neovim.
|
|
|
|
|
|
|
|
If you don't know what this means, type the following:
|
|
|
|
- <escape key>
|
|
|
|
- :
|
|
|
|
- Tutor
|
|
|
|
- <enter key>
|
|
|
|
|
|
|
|
(If you already know how the Neovim basics, you can skip this step)
|
|
|
|
|
|
|
|
Once you've completed that, you can continue working through **AND READING** the rest
|
|
|
|
of the kickstart init.lua
|
|
|
|
|
|
|
|
Next, run AND READ `:help`.
|
|
|
|
This will open up a help window with some basic information
|
|
|
|
about reading, navigating and searching the builtin help documentation.
|
|
|
|
|
|
|
|
This should be the first place you go to look when you're stuck or confused
|
|
|
|
with something. It's one of my favorite neovim features.
|
2023-02-17 21:31:57 +00:00
|
|
|
|
2024-02-26 15:03:53 +00:00
|
|
|
MOST IMPORTANTLY, we provide a keymap "<space>sh" to [s]earch the [h]elp documentation,
|
|
|
|
which is very useful when you're not sure exactly what you're looking for.
|
|
|
|
|
|
|
|
I have left several `:help X` comments throughout the init.lua
|
|
|
|
These are hints about where to find more information about the relevant settings,
|
|
|
|
plugins or neovim features used in kickstart.
|
|
|
|
|
|
|
|
NOTE: Look for lines like this
|
2023-02-17 21:31:57 +00:00
|
|
|
|
2024-02-26 15:03:53 +00:00
|
|
|
Throughout the file. These are for you, the reader, to help understand what is happening.
|
|
|
|
Feel free to delete them once you know what you're doing, but they should serve as a guide
|
|
|
|
for when you are first encountering a few different constructs in your nvim config.
|
|
|
|
|
|
|
|
If you experience any errors while trying to install kickstart, run `:checkhealth` for more info
|
2023-02-17 21:31:57 +00:00
|
|
|
|
|
|
|
I hope you enjoy your Neovim journey,
|
|
|
|
- TJ
|
|
|
|
|
2024-02-26 15:03:53 +00:00
|
|
|
P.S. You can delete this when you're done too. It's your config now! :)
|
2023-02-17 21:31:57 +00:00
|
|
|
--]]
|
2023-10-22 09:44:31 +00:00
|
|
|
|
2023-02-17 21:31:57 +00:00
|
|
|
-- Set <space> as the leader key
|
|
|
|
-- See `:help mapleader`
|
2024-02-26 15:03:53 +00:00
|
|
|
-- NOTE: Must happen before plugins are loaded (otherwise wrong leader will be used)
|
2023-02-17 21:31:57 +00:00
|
|
|
vim.g.mapleader = ' '
|
|
|
|
vim.g.maplocalleader = ' '
|
|
|
|
|
2024-03-06 16:49:44 +00:00
|
|
|
-- Set to true if you have a Nerd Font installed
|
|
|
|
vim.g.have_nerd_font = false
|
|
|
|
|
2023-11-07 16:26:53 +00:00
|
|
|
-- [[ Setting options ]]
|
2023-12-05 09:28:02 +00:00
|
|
|
require 'options'
|
2023-02-17 21:31:57 +00:00
|
|
|
|
2023-11-07 16:26:53 +00:00
|
|
|
-- [[ Basic Keymaps ]]
|
2023-12-05 09:28:02 +00:00
|
|
|
require 'keymaps'
|
2022-06-24 03:35:53 +00:00
|
|
|
|
2023-11-07 10:27:14 +00:00
|
|
|
-- [[ Install `lazy.nvim` plugin manager ]]
|
2024-02-26 19:46:46 +00:00
|
|
|
require 'lazy-bootstrap'
|
2022-06-24 03:35:53 +00:00
|
|
|
|
2024-02-26 15:03:53 +00:00
|
|
|
-- [[ Configure and install plugins ]]
|
2024-02-26 19:46:46 +00:00
|
|
|
require 'lazy-plugins'
|
2022-06-24 03:35:53 +00:00
|
|
|
|
|
|
|
-- The line beneath this is called `modeline`. See `:help modeline`
|
|
|
|
-- vim: ts=2 sts=2 sw=2 et
|