mirror of https://github.com/folke/lazy.nvim.git
chore(build): auto-generate docs
This commit is contained in:
github-actions[bot]
parent
f6a98dbd81
commit
c7a0df45d5
103
README.md
103
README.md
|
|
@ -655,40 +655,40 @@ with a lazy extension in `lazy`.
|
|||
|
||||
# 🌈 Highlight Groups
|
||||
|
||||
| Highlight Group | Default Group | Description |
|
||||
| --------------------- | -------------------------- | --------------------------------------------------- |
|
||||
| **LazyButton** | **_CursorLine_** | |
|
||||
| **LazyButtonActive** | **_Visual_** | |
|
||||
| **LazyComment** | **_Comment_** | |
|
||||
| **LazyCommit** | **_@variable.builtin_** | commit ref |
|
||||
| **LazyCommitIssue** | **_Number_** | |
|
||||
| **LazyCommitScope** | **_Italic_** | conventional commit scope |
|
||||
| **LazyCommitType** | **_Title_** | conventional commit type |
|
||||
| **LazyDimmed** | **_Conceal_** | property |
|
||||
| **LazyDir** | **_@markup.link_** | directory |
|
||||
| **LazyH1** | **_IncSearch_** | home button |
|
||||
| **LazyH2** | **_Bold_** | titles |
|
||||
| **LazyLocal** | **_Constant_** | |
|
||||
| **LazyNoCond** | **_DiagnosticWarn_** | unloaded icon for a plugin where `cond()` was false |
|
||||
| **LazyNormal** | **_NormalFloat_** | |
|
||||
| **LazyProgressDone** | **_Constant_** | progress bar done |
|
||||
| **LazyProgressTodo** | **_LineNr_** | progress bar todo |
|
||||
| **LazyProp** | **_Conceal_** | property |
|
||||
| **LazyReasonCmd** | **_Operator_** | |
|
||||
| **LazyReasonEvent** | **_Constant_** | |
|
||||
| **LazyReasonFt** | **_Character_** | |
|
||||
| **LazyReasonImport** | **_Identifier_** | |
|
||||
| **LazyReasonKeys** | **_Statement_** | |
|
||||
| **LazyReasonPlugin** | **_Special_** | |
|
||||
| **LazyReasonRequire** | **_@variable.parameter_** | |
|
||||
| **LazyReasonRuntime** | **_@macro_** | |
|
||||
| **LazyReasonSource** | **_Character_** | |
|
||||
| **LazyReasonStart** | **_@variable.member_** | |
|
||||
| **LazySpecial** | **_@punctuation.special_** | |
|
||||
| **LazyTaskError** | **_ErrorMsg_** | task errors |
|
||||
| **LazyTaskOutput** | **_MsgArea_** | task output |
|
||||
| **LazyUrl** | **_@markup.link_** | url |
|
||||
| **LazyValue** | **_@string_** | value of a property |
|
||||
| Highlight Group | Default Group | Description |
|
||||
| --- | --- | --- |
|
||||
| **LazyButton** | ***CursorLine*** | |
|
||||
| **LazyButtonActive** | ***Visual*** | |
|
||||
| **LazyComment** | ***Comment*** | |
|
||||
| **LazyCommit** | ***@variable.builtin*** | commit ref |
|
||||
| **LazyCommitIssue** | ***Number*** | |
|
||||
| **LazyCommitScope** | ***Italic*** | conventional commit scope |
|
||||
| **LazyCommitType** | ***Title*** | conventional commit type |
|
||||
| **LazyDimmed** | ***Conceal*** | property |
|
||||
| **LazyDir** | ***@markup.link*** | directory |
|
||||
| **LazyH1** | ***IncSearch*** | home button |
|
||||
| **LazyH2** | ***Bold*** | titles |
|
||||
| **LazyLocal** | ***Constant*** | |
|
||||
| **LazyNoCond** | ***DiagnosticWarn*** | unloaded icon for a plugin where `cond()` was false |
|
||||
| **LazyNormal** | ***NormalFloat*** | |
|
||||
| **LazyProgressDone** | ***Constant*** | progress bar done |
|
||||
| **LazyProgressTodo** | ***LineNr*** | progress bar todo |
|
||||
| **LazyProp** | ***Conceal*** | property |
|
||||
| **LazyReasonCmd** | ***Operator*** | |
|
||||
| **LazyReasonEvent** | ***Constant*** | |
|
||||
| **LazyReasonFt** | ***Character*** | |
|
||||
| **LazyReasonImport** | ***Identifier*** | |
|
||||
| **LazyReasonKeys** | ***Statement*** | |
|
||||
| **LazyReasonPlugin** | ***Special*** | |
|
||||
| **LazyReasonRequire** | ***@variable.parameter*** | |
|
||||
| **LazyReasonRuntime** | ***@macro*** | |
|
||||
| **LazyReasonSource** | ***Character*** | |
|
||||
| **LazyReasonStart** | ***@variable.member*** | |
|
||||
| **LazySpecial** | ***@punctuation.special*** | |
|
||||
| **LazyTaskError** | ***ErrorMsg*** | task errors |
|
||||
| **LazyTaskOutput** | ***MsgArea*** | task output |
|
||||
| **LazyUrl** | ***@markup.link*** | url |
|
||||
| **LazyValue** | ***@string*** | value of a property |
|
||||
|
||||
# 🚀 Usage
|
||||
|
||||
|
|
@ -721,24 +721,24 @@ can be enabled with `config.checker.enabled = true`.
|
|||
|
||||
Any operation can be started from the UI, with a sub command or an API function:
|
||||
|
||||
| Command | Lua | Description |
|
||||
| ------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `:Lazy build {plugins}` | `require("lazy").build(opts)` | Rebuild a plugin |
|
||||
| `:Lazy check [plugins]` | `require("lazy").check(opts?)` | Check for updates and show the log (git fetch) |
|
||||
| `:Lazy clean [plugins]` | `require("lazy").clean(opts?)` | Clean plugins that are no longer needed |
|
||||
| `:Lazy clear` | `require("lazy").clear()` | Clear finished tasks |
|
||||
| `:Lazy debug` | `require("lazy").debug()` | Show debug information |
|
||||
| `:Lazy health` | `require("lazy").health()` | Run `:checkhealth lazy` |
|
||||
| `:Lazy help` | `require("lazy").help()` | Toggle this help page |
|
||||
| `:Lazy home` | `require("lazy").home()` | Go back to plugin list |
|
||||
| `:Lazy install [plugins]` | `require("lazy").install(opts?)` | Install missing plugins |
|
||||
| `:Lazy load {plugins}` | `require("lazy").load(opts)` | Load a plugin that has not been loaded yet. Similar to `:packadd`. Like `:Lazy load foo.nvim`. Use `:Lazy! load` to skip `cond` checks. |
|
||||
| `:Lazy log [plugins]` | `require("lazy").log(opts?)` | Show recent updates |
|
||||
| `:Lazy profile` | `require("lazy").profile()` | Show detailed profiling |
|
||||
| `:Lazy reload {plugins}` | `require("lazy").reload(opts)` | Reload a plugin (experimental!!) |
|
||||
| Command | Lua | Description |
|
||||
| --- | --- | --- |
|
||||
| `:Lazy build {plugins}` | `require("lazy").build(opts)` | Rebuild a plugin |
|
||||
| `:Lazy check [plugins]` | `require("lazy").check(opts?)` | Check for updates and show the log (git fetch) |
|
||||
| `:Lazy clean [plugins]` | `require("lazy").clean(opts?)` | Clean plugins that are no longer needed |
|
||||
| `:Lazy clear` | `require("lazy").clear()` | Clear finished tasks |
|
||||
| `:Lazy debug` | `require("lazy").debug()` | Show debug information |
|
||||
| `:Lazy health` | `require("lazy").health()` | Run `:checkhealth lazy` |
|
||||
| `:Lazy help` | `require("lazy").help()` | Toggle this help page |
|
||||
| `:Lazy home` | `require("lazy").home()` | Go back to plugin list |
|
||||
| `:Lazy install [plugins]` | `require("lazy").install(opts?)` | Install missing plugins |
|
||||
| `:Lazy load {plugins}` | `require("lazy").load(opts)` | Load a plugin that has not been loaded yet. Similar to `:packadd`. Like `:Lazy load foo.nvim`. Use `:Lazy! load` to skip `cond` checks. |
|
||||
| `:Lazy log [plugins]` | `require("lazy").log(opts?)` | Show recent updates |
|
||||
| `:Lazy profile` | `require("lazy").profile()` | Show detailed profiling |
|
||||
| `:Lazy reload {plugins}` | `require("lazy").reload(opts)` | Reload a plugin (experimental!!) |
|
||||
| `:Lazy restore [plugins]` | `require("lazy").restore(opts?)` | Updates all plugins to the state in the lockfile. For a single plugin: restore it to the state in the lockfile or to a given commit under the cursor |
|
||||
| `:Lazy sync [plugins]` | `require("lazy").sync(opts?)` | Run install, clean and update |
|
||||
| `:Lazy update [plugins]` | `require("lazy").update(opts?)` | Update plugins. This will also update the lockfile |
|
||||
| `:Lazy sync [plugins]` | `require("lazy").sync(opts?)` | Run install, clean and update |
|
||||
| `:Lazy update [plugins]` | `require("lazy").update(opts?)` | Update plugins. This will also update the lockfile |
|
||||
|
||||
Any command can have a **bang** to make the command wait till it finished. For example,
|
||||
if you want to sync lazy from the cmdline, you can use:
|
||||
|
|
@ -970,4 +970,3 @@ or create a file `build.lua` or `build/init.lua` in the root of your repo.
|
|||
This file will be loaded when the plugin is installed or updated.
|
||||
|
||||
This makes it easier for users, as they no longer need to specify a `build` command.
|
||||
|
||||
|
|
|
|||
|
|
@ -7,6 +7,8 @@ Table of Contents *lazy.nvim-table-of-contents*
|
|||
- ✨ Features |lazy.nvim-🚀-getting-started-✨-features|
|
||||
- ⚡️ Requirements |lazy.nvim-🚀-getting-started-⚡️-requirements|
|
||||
2. 🛠️ Installation |lazy.nvim-🛠️-installation|
|
||||
- Structured Setup |lazy.nvim-🛠️-installation-structured-setup|
|
||||
- Single File Setup |lazy.nvim-🛠️-installation-single-file-setup|
|
||||
3. 🔌 Plugin Spec |lazy.nvim-🔌-plugin-spec|
|
||||
- Source |lazy.nvim-🔌-plugin-spec-source|
|
||||
- Loading |lazy.nvim-🔌-plugin-spec-loading|
|
||||
|
|
@ -90,59 +92,52 @@ all available options.
|
|||
|
||||
|
||||
|
||||
STRUCTURED SETUP *lazy.nvim-🛠️-installation-structured-setup*
|
||||
|
||||
`lua title="~/.config/nvim/init.lua" require("config.lazy")`
|
||||
|
||||
>
|
||||
<!-- install_multi:start -->
|
||||
>lua
|
||||
require("config.lazy")
|
||||
<
|
||||
|
||||
```lua title="~/.config/nvim/lua/config/lazy.lua" – Bootstrap lazy.nvim local
|
||||
lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim" if not (vim.uv or
|
||||
vim.loop).fs_stat(lazypath) then local lazyrepo =
|
||||
"https://github.com/folke/lazy.nvim.git" vim.fn.system({ "git", "clone",
|
||||
"–filter=blob:none", "–branch=stable", lazyrepo, lazypath }) end
|
||||
vim.opt.rtp:prepend(lazypath)
|
||||
>lua
|
||||
-- Bootstrap lazy.nvim
|
||||
local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
|
||||
if not (vim.uv or vim.loop).fs_stat(lazypath) then
|
||||
local lazyrepo = "https://github.com/folke/lazy.nvim.git"
|
||||
vim.fn.system({ "git", "clone", "--filter=blob:none", "--branch=stable", lazyrepo, lazypath })
|
||||
end
|
||||
vim.opt.rtp:prepend(lazypath)
|
||||
|
||||
– Make sure to setup `mapleader` and `maplocalleader` before – loading
|
||||
lazy.nvim so that mappings are correct. – This is also a good place to setup
|
||||
other settings (vim.opt) vim.g.mapleader = ” ” vim.g.maplocalleader = "\"
|
||||
-- Make sure to setup `mapleader` and `maplocalleader` before
|
||||
-- loading lazy.nvim so that mappings are correct.
|
||||
-- This is also a good place to setup other settings (vim.opt)
|
||||
vim.g.mapleader = " "
|
||||
vim.g.maplocalleader = "\\"
|
||||
|
||||
– Setup lazy.nvim require("lazy").setup({ – highlight-start spec = { –
|
||||
import your plugins { import = "plugins" }, }, – highlight-end – Configure
|
||||
any other settings here. See the documentation for more details. –
|
||||
colorscheme that will be used when installing plugins. install = { colorscheme
|
||||
= { "habamax" } }, – automatically check for plugin updates checker = {
|
||||
enabled = true }, })
|
||||
-- Setup lazy.nvim
|
||||
require("lazy").setup({
|
||||
-- highlight-start
|
||||
spec = {
|
||||
-- import your plugins
|
||||
{ import = "plugins" },
|
||||
},
|
||||
-- highlight-end
|
||||
-- Configure any other settings here. See the documentation for more details.
|
||||
-- colorscheme that will be used when installing plugins.
|
||||
install = { colorscheme = { "habamax" } },
|
||||
-- automatically check for plugin updates
|
||||
checker = { enabled = true },
|
||||
})
|
||||
<
|
||||
|
||||
>
|
||||
You can then create your plugin specs in `~/.config/nvim/lua/plugins/`. Each
|
||||
file should return a table with the plugins you want to install.
|
||||
|
||||
<!-- install_multi:end -->
|
||||
For more info see Structuring Your Plugins </usage/structuring>
|
||||
|
||||
You can then create your plugin specs in `~/.config/nvim/lua/plugins/`.
|
||||
Each file should return a table with the plugins you want to install.
|
||||
|
||||
For more info see [Structuring Your Plugins](/usage/structuring)
|
||||
SINGLE FILE SETUP *lazy.nvim-🛠️-installation-single-file-setup*
|
||||
|
||||
<!-- prettier-ignore-start -->
|
||||
<pre>
|
||||
~/.config/nvim
|
||||
├── lua
|
||||
│ ├── config
|
||||
│ │ └── lazy.lua
|
||||
│ └── plugins
|
||||
│ ├── spec1.lua
|
||||
│ ├── **
|
||||
│ └── spec2.lua
|
||||
└── init.lua
|
||||
</pre>
|
||||
<!-- prettier-ignore-end -->
|
||||
|
||||
</TabItem>
|
||||
<TabItem value="single" label="Single File Setup">
|
||||
<!-- install_single:start -->
|
||||
|
||||
```lua title="~/.config/nvim/init.lua"
|
||||
>lua
|
||||
-- Bootstrap lazy.nvim
|
||||
local lazypath = vim.fn.stdpath("data") .. "/lazy/lazy.nvim"
|
||||
if not (vim.uv or vim.loop).fs_stat(lazypath) then
|
||||
|
|
@ -173,8 +168,6 @@ enabled = true }, })
|
|||
<
|
||||
|
||||
|
||||
|
||||
|
||||
==============================================================================
|
||||
3. 🔌 Plugin Spec *lazy.nvim-🔌-plugin-spec*
|
||||
|
||||
|
|
@ -550,8 +543,13 @@ will be added to the plugin’s spec.
|
|||
{
|
||||
root = vim.fn.stdpath("data") .. "/lazy", -- directory where plugins will be installed
|
||||
defaults = {
|
||||
-- By default, only LazyVim plugins will be lazy-loaded. Your custom plugins will load during startup.
|
||||
-- If you know what you're doing, you can set this to `true` to have all your custom plugins lazy-loaded by default.
|
||||
lazy = false, -- should plugins be lazy-loaded?
|
||||
version = nil,
|
||||
-- It's recommended to leave version=false for now, since a lot the plugin that support versioning,
|
||||
-- have outdated releases, which may break your Neovim install.
|
||||
version = nil, -- always use the latest git commit
|
||||
-- version = "*", -- try installing the latest stable version for plugins that support semver
|
||||
-- default `cond` you can use to globally disable a lot of plugins
|
||||
-- when running inside vscode for example
|
||||
cond = nil, ---@type boolean|fun(self:LazyPlugin):boolean|nil
|
||||
|
|
@ -1185,11 +1183,11 @@ command.
|
|||
==============================================================================
|
||||
16. Links *lazy.nvim-links*
|
||||
|
||||
1. *image*: docs/https:/user-images.githubusercontent.com/292349/208301737-68fb279c-ba70-43ef-a369-8c3e8367d6b1.png
|
||||
1. *image*: https://user-images.githubusercontent.com/292349/208301737-68fb279c-ba70-43ef-a369-8c3e8367d6b1.png
|
||||
2. *@theme/Tabs*:
|
||||
3. *@theme/TabItem*:
|
||||
4. *image*: docs/usage/https:/user-images.githubusercontent.com/292349/208301766-5c400561-83c3-4811-9667-1ec4bb3c43b8.png
|
||||
5. *image*: docs/usage/https:/user-images.githubusercontent.com/292349/208301790-7eedbfa5-d202-4e70-852e-de68aa47233b.png
|
||||
4. *image*: https://user-images.githubusercontent.com/292349/208301766-5c400561-83c3-4811-9667-1ec4bb3c43b8.png
|
||||
5. *image*: https://user-images.githubusercontent.com/292349/208301790-7eedbfa5-d202-4e70-852e-de68aa47233b.png
|
||||
|
||||
Generated by panvimdoc <https://github.com/kdheepak/panvimdoc>
|
||||
|
||||
|
|
|
|||
|
|
@ -11,13 +11,8 @@ sidebar_position: 5
|
|||
{
|
||||
root = vim.fn.stdpath("data") .. "/lazy", -- directory where plugins will be installed
|
||||
defaults = {
|
||||
-- By default, only LazyVim plugins will be lazy-loaded. Your custom plugins will load during startup.
|
||||
-- If you know what you're doing, you can set this to `true` to have all your custom plugins lazy-loaded by default.
|
||||
lazy = false, -- should plugins be lazy-loaded?
|
||||
-- It's recommended to leave version=false for now, since a lot the plugin that support versioning,
|
||||
-- have outdated releases, which may break your Neovim install.
|
||||
version = nil, -- always use the latest git commit
|
||||
-- version = "*", -- try installing the latest stable version for plugins that support semver
|
||||
version = nil,
|
||||
-- default `cond` you can use to globally disable a lot of plugins
|
||||
-- when running inside vscode for example
|
||||
cond = nil, ---@type boolean|fun(self:LazyPlugin):boolean|nil
|
||||
|
|
|
|||
Loading…
Reference in New Issue