LazyVim.LazyVim/doc/LazyVim.txt

160 lines
5.8 KiB
Text
Raw Normal View History

2023-01-23 07:09:07 +00:00
*LazyVim.txt* For Neovim >= 0.8.0 Last change: 2023 January 23
2023-01-04 20:58:29 +00:00
==============================================================================
Table of Contents *LazyVim-table-of-contents*
2023-01-09 10:34:54 +00:00
- Features |LazyVim-features|
- Requirements |LazyVim-requirements|
2023-01-07 10:45:26 +00:00
- Getting Started |LazyVim-getting-started|
2023-01-09 09:53:51 +00:00
- File Structure |LazyVim-file-structure|
2023-01-10 10:15:28 +00:00
- Configuration |LazyVim-configuration|
2023-01-04 20:58:29 +00:00
2023-01-19 12:51:20 +00:00
<img
src="https://user-images.githubusercontent.com/292349/213446185-2db63fd5-8c84-459c-9f04-e286382d6e80.png">
<hr>
<h4 align="center">
<a href="https://lazyvim.github.io/installation">Install</a>
·
<a href="https://lazyvim.github.io/configuration">Configure</a>
·
<a href="https://lazyvim.github.io">Docs</a>
</h4>
<div align="center">
<a href="https://github.com/LazyVim/LazyVim/releases/latest">
2023-01-19 12:54:37 +00:00
<img alt="Latest release" src="https://img.shields.io/github/v/release/LazyVim/LazyVim?style=for-the-badge&logo=starship&color=C9CBFF&logoColor=D9E0EE&labelColor=302D41&include_prerelease&sort=semver" />
2023-01-19 12:51:20 +00:00
</a>
<a href="https://github.com/LazyVim/LazyVim/pulse">
<img alt="Last commit" src="https://img.shields.io/github/last-commit/LazyVim/LazyVim?style=for-the-badge&logo=starship&color=8bd5ca&logoColor=D9E0EE&labelColor=302D41"/>
</a>
<a href="https://github.com/LazyVim/LazyVim/blob/main/LICENSE">
<img alt="License" src="https://img.shields.io/github/license/LazyVim/LazyVim?style=for-the-badge&logo=starship&color=ee999f&logoColor=D9E0EE&labelColor=302D41" />
</a>
<a href="https://github.com/LazyVim/LazyVim/stargazers">
<img alt="Stars" src="https://img.shields.io/github/stars/LazyVim/LazyVim?style=for-the-badge&logo=starship&color=c69ff5&logoColor=D9E0EE&labelColor=302D41" />
</a>
<a href="https://github.com/LazyVim/LazyVim/issues">
<img alt="Issues" src="https://img.shields.io/github/issues/LazyVim/LazyVim?style=for-the-badge&logo=bilibili&color=F5E0DC&logoColor=D9E0EE&labelColor=302D41" />
</a>
<a href="https://github.com/LazyVim/LazyVim">
<img alt="Repo Size" src="https://img.shields.io/github/repo-size/LazyVim/LazyVim?color=%23DDB6F2&label=SIZE&logo=codesandbox&style=for-the-badge&logoColor=D9E0EE&labelColor=302D41" />
</a>
<a href="https://twitter.com/intent/follow?screen_name=folke">
<img alt="follow on Twitter" src="https://img.shields.io/twitter/follow/folke?style=for-the-badge&logo=twitter&color=8aadf3&logoColor=D9E0EE&labelColor=302D41" />
</a>
</div>
2023-01-04 20:58:29 +00:00
2023-01-09 10:38:22 +00:00
LazyVim is a Neovim setup powered by lazy.nvim
<https://github.com/folke/lazy.nvim> to make it easy to customize and extend
your config. Rather than having to choose between starting from scratch or
using a pre-made distro, LazyVim offers the best of both worlds - the
flexibility to tweak your config as needed, along with the convenience of a
pre-configured setup.
2023-01-07 10:54:19 +00:00
2023-01-19 12:51:20 +00:00
<div class="figure">
<img src="https://user-images.githubusercontent.com/292349/213447056-92290767-ea16-430c-8727-ce994c93e9cc.png" title="fig:"/>
<p class="caption">image</p>
</div>
2023-01-04 20:58:29 +00:00
<div class="figure">
2023-01-09 10:18:58 +00:00
<img src="https://user-images.githubusercontent.com/292349/211285846-0b7bb3bf-0462-4029-b64c-4ee1d037fc1c.png" title="fig:"/>
2023-01-04 20:58:29 +00:00
<p class="caption">image</p>
</div>
2023-01-09 10:34:54 +00:00
FEATURES *LazyVim-features*
- Transform your Neovim into a full-fledged IDE
- Easily customize and extend your config with lazy.nvim <https://github.com/folke/lazy.nvim>
2023-01-09 11:37:36 +00:00
- Blazingly fast
2023-01-09 10:34:54 +00:00
- Sane default settings for options, autocmds, and keymaps
- Comes with a wealth of plugins pre-configured and ready to use
REQUIREMENTS *LazyVim-requirements*
- Neovim >= **0.8.0** (needs to be built with **LuaJIT**)
- Git >= **2.19.0** (for partial clones support)
- a Nerd Font <https://www.nerdfonts.com/> **_(optional)_**
2023-01-07 10:45:26 +00:00
GETTING STARTED *LazyVim-getting-started*
You can find a starter template for **LazyVim** here
<https://github.com/LazyVim/starter>
2023-01-11 14:52:51 +00:00
Try it with Docker
>sh
docker run -w /root -it --rm alpine:edge sh -uelic '
apk add git lazygit neovim ripgrep alpine-sdk --update
git clone https://github.com/LazyVim/starter ~/.config/nvim
cd ~/.config/nvim
nvim
'
2023-01-07 11:00:06 +00:00
<
2023-01-11 14:52:51 +00:00
Install the <a href="https://github.com/LazyVim/starter">LazyVim Starter</a>
- Make a backup of your current Neovim files:
>sh
mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/share/nvim.bak
<
- Clone the starter
>sh
git clone https://github.com/LazyVim/starter ~/.config/nvim
<
2023-01-19 12:51:20 +00:00
- Remove the `.git` folder, so you can add it to your own repo later
>sh
rm -rf ~/.config/nvim/.git
<
2023-01-11 14:52:51 +00:00
- Start Neovim!
>sh
nvim
<
Refer to the comments in the files on how to customize **LazyVim**.
2023-01-09 09:53:51 +00:00
FILE STRUCTURE *LazyVim-file-structure*
2023-01-04 20:58:29 +00:00
2023-01-09 09:53:51 +00:00
The files under config will be automatically loaded at the appropriate time, so
2023-01-09 09:57:40 +00:00
you dont need to require those files manually. **LazyVim** comes with a set
of default config files that will be loaded **_before_** your own. See here
<https://github.com/LazyVim/LazyVim/tree/main/lua/lazyvim/config>
2023-01-04 20:58:29 +00:00
2023-01-09 09:53:51 +00:00
You can add your custom plugin specs under `lua/plugins/`. All files there will
be automatically loaded by lazy.nvim <https://github.com/folke/lazy.nvim>
<pre>
~/.config/nvim
lua
   config
      autocmds.lua
      keymaps.lua
      lazy.lua
      options.lua
   plugins
   spec1.lua
  
   spec2.lua
init.toml
</pre>
2023-01-10 10:15:28 +00:00
CONFIGURATION *LazyVim-configuration*
2023-01-19 12:51:20 +00:00
Refer to the docs <https://lazyvim.github.io>
2023-01-04 20:58:29 +00:00
Generated by panvimdoc <https://github.com/kdheepak/panvimdoc>
vim:tw=78:ts=8:noet:ft=help:norl: