mirror of
https://github.com/nix-community/nixvim.git
synced 2025-06-23 01:08:43 +02:00
docs: Add basic documentation system based on nmd
You can now run `nix build '.#docs'` to build HTML documentation documenting every single option on nixvim! Fortunately, thanks to the 'description' field, most options are already documented, but there are still a fair few that need documenting. I will be taking care of those in the next few days. When those are done, I will find a way to automatically rebuild documentation on every repo push, and also add a PR hook requiring documentation. Additionally, I will try to find a way to have per-page plugin docs.
This commit is contained in:
parent
69cf1b6204
commit
eef84178ab
42 changed files with 184 additions and 51 deletions
155
docs/plugins/colorschemes/base16.md
Normal file
155
docs/plugins/colorschemes/base16.md
Normal file
|
@ -0,0 +1,155 @@
|
|||
# base16
|
||||
Base16 is a set of colorschemes, so it comes with several themes you can choose from:
|
||||
|
||||
- 3024
|
||||
- apathy
|
||||
- ashes
|
||||
- atelier-cave-light
|
||||
- atelier-cave
|
||||
- atelier-dune-light
|
||||
- atelier-dune
|
||||
- atelier-estuary-light
|
||||
- atelier-estuary
|
||||
- atelier-forest-light
|
||||
- atelier-forest
|
||||
- atelier-heath-light
|
||||
- atelier-heath
|
||||
- atelier-lakeside-light
|
||||
- atelier-lakeside
|
||||
- atelier-plateau-light
|
||||
- atelier-plateau
|
||||
- atelier-savanna-light
|
||||
- atelier-savanna
|
||||
- atelier-seaside-light
|
||||
- atelier-seaside
|
||||
- atelier-sulphurpool-light
|
||||
- atelier-sulphurpool
|
||||
- atlas
|
||||
- bespin
|
||||
- black-metal-bathory
|
||||
- black-metal-burzum
|
||||
- black-metal-dark-funeral
|
||||
- black-metal-gorgoroth
|
||||
- black-metal-immortal
|
||||
- black-metal-khold
|
||||
- black-metal-marduk
|
||||
- black-metal-mayhem
|
||||
- black-metal-nile
|
||||
- black-metal-venom
|
||||
- black-metal
|
||||
- brewer
|
||||
- bright
|
||||
- brogrammer
|
||||
- brushtrees-dark
|
||||
- brushtrees
|
||||
- chalk
|
||||
- circus
|
||||
- classic-dark
|
||||
- classic-light
|
||||
- codeschool
|
||||
- cupcake
|
||||
- cupertino
|
||||
- darktooth
|
||||
- default-dark
|
||||
- default-light
|
||||
- dracula
|
||||
- eighties
|
||||
- embers
|
||||
- flat
|
||||
- fruit-soda
|
||||
- github
|
||||
- google-dark
|
||||
- google-light
|
||||
- grayscale-dark
|
||||
- grayscale-light
|
||||
- greenscreen
|
||||
- gruvbox-dark-hard
|
||||
- gruvbox-dark-medium
|
||||
- gruvbox-dark-pale
|
||||
- gruvbox-dark-soft
|
||||
- gruvbox-light-hard
|
||||
- gruvbox-light-medium
|
||||
- gruvbox-light-soft
|
||||
- harmonic-dark
|
||||
- harmonic-light
|
||||
- heetch-light
|
||||
- heetch
|
||||
- helios
|
||||
- hopscotch
|
||||
- horizon-dark
|
||||
- ia-dark
|
||||
- ia-light
|
||||
- icy
|
||||
- irblack
|
||||
- isotope
|
||||
- macintosh
|
||||
- marrakesh
|
||||
- material-darker
|
||||
- material-lighter
|
||||
- material-palenight
|
||||
- material
|
||||
- material-vivid
|
||||
- materia
|
||||
- mellow-purple
|
||||
- mexico-light
|
||||
- mocha
|
||||
- monokai
|
||||
- nord
|
||||
- oceanicnext
|
||||
- ocean
|
||||
- onedark
|
||||
- one-light
|
||||
- outrun-dark
|
||||
- papercolor-dark
|
||||
- papercolor-light
|
||||
- paraiso
|
||||
- phd
|
||||
- pico
|
||||
- pop
|
||||
- porple
|
||||
- railscasts
|
||||
- rebecca
|
||||
- seti
|
||||
- shapeshifter
|
||||
- snazzy
|
||||
- solarflare
|
||||
- solarized-dark
|
||||
- solarized-light
|
||||
- spacemacs
|
||||
- summerfruit-dark
|
||||
- summerfruit-light
|
||||
- synth-midnight-dark
|
||||
- tomorrow-night-eighties
|
||||
- tomorrow-night
|
||||
- tomorrow
|
||||
- tube
|
||||
- twilight
|
||||
- unikitty-dark
|
||||
- unikitty-light
|
||||
- woodland
|
||||
- xcode-dusk
|
||||
- zenburn
|
||||
|
||||
More information can be found on the official base16 website, [here](http://chriskempson.com/projects/base16/).
|
||||
|
||||
## Options
|
||||
|
||||
### `colorschemes.base16.enable`
|
||||
**Description**: Enables base16
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.base16.useTruecolor`
|
||||
**Description**: Whether to use truecolor for the colorschemes. If set to
|
||||
false, you'll need to set up base16 in your shell.
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
**Default**: `true`
|
||||
|
||||
### `colorschemes.base16.setUpBar`
|
||||
**Description**: Whether to install the matching plugin for your statusbar. This does nothing as of yet, waiting for upstream support.
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
**Default**: `true`
|
144
docs/plugins/colorschemes/gruvbox.md
Normal file
144
docs/plugins/colorschemes/gruvbox.md
Normal file
|
@ -0,0 +1,144 @@
|
|||
# gruvbox
|
||||
This plugin sets up the `gruvbox` colorscheme.
|
||||
|
||||
## Options
|
||||
### `colorschemes.gruvbox.enable`
|
||||
**Description**: Enable gruvbox
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.gruvbox.italics`
|
||||
**Description**: Enable italics
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.gruvbox.bold`
|
||||
**Description**: Enable bold
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.gruvbox.underline`
|
||||
**Description**: Enable underlined text
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.gruvbox.undercurl`
|
||||
**Description**: Enable undercurled text
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.gruvbox.contrastDark`
|
||||
**Description**: Contrast for the dark mode
|
||||
|
||||
**Type**: `nullOr (enum [ "soft" "medium" "hard" ])`
|
||||
|
||||
**Default**: `null`
|
||||
|
||||
### `colorschemes.gruvbox.contrastLight`
|
||||
**Type**: `nullOr (enum [ "soft" "medium" "hard" ])`
|
||||
|
||||
**Default**: `null`
|
||||
|
||||
**Description**: "Contrast for the light mode";
|
||||
|
||||
### `colorschemes.gruvbox.highlightSearchCursor`
|
||||
**Type**: `nullOr colors`
|
||||
|
||||
**Default**: `null`
|
||||
|
||||
**Description**: "The cursor background while search is highlighted";
|
||||
|
||||
### `colorschemes.gruvbox.numberColumn`
|
||||
**Description**: The number column background
|
||||
|
||||
**Type**: `nullOr colors`
|
||||
|
||||
**Default**: `null`
|
||||
|
||||
### `colorschemes.gruvbox.signColumn`
|
||||
**Description**: "The sign column background";
|
||||
|
||||
**Type**: `nullOr colors`
|
||||
|
||||
**Default**: `null`
|
||||
|
||||
### `colorschemes.gruvbox.colorColumn`
|
||||
**Description**: "The color column background";
|
||||
|
||||
**Type**: `nullOr colors`
|
||||
|
||||
**Default**: `null`
|
||||
|
||||
### `colorschemes.gruvbox.vertSplitColor`
|
||||
**Description**: "The vertical split background color";
|
||||
|
||||
**Type**: `nullOr colors`
|
||||
|
||||
**Default**: `null`
|
||||
|
||||
### `colorschemes.gruvbox.italicizeComments`
|
||||
**Description**: "Italicize comments";
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
**Default**: `true`
|
||||
|
||||
### `colorschemes.gruvbox.italicizeStrings`
|
||||
**Description**: "Italicize strings";
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
**Default**: `false`
|
||||
|
||||
### `colorschemes.gruvbox.invertSelection`
|
||||
**Description**: "Invert the select text";
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
**Default**: `true`
|
||||
|
||||
### `colorschemes.gruvbox.invertSigns`
|
||||
**Description**: "Invert GitGutter and Syntastic signs";
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
**Default**: `false`
|
||||
|
||||
### `colorschemes.gruvbox.invertIndentGuides`
|
||||
**Description**: "Invert indent guides";
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
**Default**: `false`
|
||||
|
||||
### `colorschemes.gruvbox.invertTabline`
|
||||
**Description**: "Invert tabline highlights";
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
**Default**: `false`
|
||||
|
||||
### `colorschemes.gruvbox.improvedStrings`
|
||||
**Description**: "Improved strings";
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
**Default**: `false`
|
||||
|
||||
### `colorschemes.gruvbox.improvedWarnings`
|
||||
**Description**: "Improved warnings";
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
**Default**: `false`
|
||||
|
||||
### `colorschemes.gruvbox.transparentBg`
|
||||
**Description**: Transparent background
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.gruvbox.trueColor`
|
||||
**Description**: Enable true color support
|
||||
|
||||
**Type**: `bool`
|
||||
|
6
docs/plugins/colorschemes/one.md
Normal file
6
docs/plugins/colorschemes/one.md
Normal file
|
@ -0,0 +1,6 @@
|
|||
# vim-one
|
||||
## Options
|
||||
### `colorschemes.one.enable`
|
||||
**Description**: Enable vim-one
|
||||
|
||||
**Type**: `bool`
|
6
docs/plugins/colorschemes/onedark.md
Normal file
6
docs/plugins/colorschemes/onedark.md
Normal file
|
@ -0,0 +1,6 @@
|
|||
# onedark
|
||||
## Options
|
||||
### `colorschemes.onedark.enable`
|
||||
**Description**: Enable onedark
|
||||
|
||||
**Type**: `bool`
|
70
docs/plugins/colorschemes/tokyonight.md
Normal file
70
docs/plugins/colorschemes/tokyonight.md
Normal file
|
@ -0,0 +1,70 @@
|
|||
# tokyonight
|
||||
This plugin sets up the `tokyonight` colorscheme.
|
||||
|
||||
## Options
|
||||
### `colorschemes.tokyonight.enable`
|
||||
**Description**: Enable tokyonight
|
||||
|
||||
**Type***: `bool`
|
||||
|
||||
### `colorschemes.tokyonight.style`
|
||||
**Description**: Theme style
|
||||
|
||||
**Type**: `nullOr (enum [ "storm" "night" "day" ])`
|
||||
|
||||
**Default**: `null`
|
||||
|
||||
### `colorschemes.tokyonight.terminalColors`
|
||||
**Description**: Configure the colors used when opening a `:terminal` in Neovim
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.tokyonight.italicComments`
|
||||
**Description**: Make comments italic
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.tokyonight.italicKeywords`
|
||||
**Description**: Make keywords italic
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.tokyonight.italicFunctions`
|
||||
**Description**: Make functions italic
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.tokyonight.italicVariables`
|
||||
**Description**: Make variables and identifiers italic
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.tokyonight.transparent`
|
||||
**Description**: Enable this to disable setting the background color
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.tokyonight.hideInactiveStatusline`
|
||||
**Description**: Enabling this option will hide inactive statuslines and replace them with a thin border
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.tokyonight.transparentSidebar`
|
||||
**Description**: Sidebar like windows like NvimTree get a transparent background
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.tokyonight.darkSidebar`
|
||||
**Description**: Sidebar like windows like NvimTree get a darker background
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.tokyonight.darkFloat`
|
||||
**Description**: Float windows like the lsp diagnostic windows get a darker background
|
||||
|
||||
**Type**: `bool`
|
||||
|
||||
### `colorschemes.tokyonight.lualineBold`
|
||||
**Description**: When true, section headers in the lualine theme will be bold
|
||||
|
||||
**Type**: `bool`
|
0
docs/plugins/git/fugitive.md
Normal file
0
docs/plugins/git/fugitive.md
Normal file
0
docs/plugins/git/gitgutter.md
Normal file
0
docs/plugins/git/gitgutter.md
Normal file
0
docs/plugins/languages/ledger.md
Normal file
0
docs/plugins/languages/ledger.md
Normal file
0
docs/plugins/languages/nix.md
Normal file
0
docs/plugins/languages/nix.md
Normal file
0
docs/plugins/languages/treesitter.md
Normal file
0
docs/plugins/languages/treesitter.md
Normal file
0
docs/plugins/languages/zig.md
Normal file
0
docs/plugins/languages/zig.md
Normal file
0
docs/plugins/nvim-lsp/clangd.md
Normal file
0
docs/plugins/nvim-lsp/clangd.md
Normal file
0
docs/plugins/nvim-lsp/default.md
Normal file
0
docs/plugins/nvim-lsp/default.md
Normal file
0
docs/plugins/nvim-lsp/lspsaga.md
Normal file
0
docs/plugins/nvim-lsp/lspsaga.md
Normal file
0
docs/plugins/nvim-lsp/rnix-lsp.md
Normal file
0
docs/plugins/nvim-lsp/rnix-lsp.md
Normal file
0
docs/plugins/nvim-lsp/rust-analyzer.md
Normal file
0
docs/plugins/nvim-lsp/rust-analyzer.md
Normal file
0
docs/plugins/pluginmanagers/packer.md
Normal file
0
docs/plugins/pluginmanagers/packer.md
Normal file
0
docs/plugins/statuslines/airline.md
Normal file
0
docs/plugins/statuslines/airline.md
Normal file
0
docs/plugins/statuslines/lightline.md
Normal file
0
docs/plugins/statuslines/lightline.md
Normal file
0
docs/plugins/utils/barbar.md
Normal file
0
docs/plugins/utils/barbar.md
Normal file
0
docs/plugins/utils/commentary.md
Normal file
0
docs/plugins/utils/commentary.md
Normal file
0
docs/plugins/utils/endwise.md
Normal file
0
docs/plugins/utils/endwise.md
Normal file
0
docs/plugins/utils/goyo.md
Normal file
0
docs/plugins/utils/goyo.md
Normal file
0
docs/plugins/utils/nvim-autopairs.md
Normal file
0
docs/plugins/utils/nvim-autopairs.md
Normal file
0
docs/plugins/utils/startify.md
Normal file
0
docs/plugins/utils/startify.md
Normal file
0
docs/plugins/utils/telescope.md
Normal file
0
docs/plugins/utils/telescope.md
Normal file
0
docs/plugins/utils/undotree.md
Normal file
0
docs/plugins/utils/undotree.md
Normal file
Loading…
Add table
Add a link
Reference in a new issue