mirror of
https://github.com/nix-community/nixvim.git
synced 2025-07-19 10:14:52 +02:00
docs: New documentation using mdbook (#471)
* docs: mdbook init * Separate sub-options into their section * docs: enable fold * docs: merge core options into a single section * doc generation: fix submodules index pages * docs: add contributing section * docs: rename 'core' group to 'Neovim Options' docs: removed the index pages of empty sections docs: remove obsolete 'mergeFunctionResults' function * docs: use nix syntax highlighting * docs: point to the new repo url * docs: use recursive generation docs: split submodules into subsections * docs: fix contributing separator docs: fix missing submodules docs
This commit is contained in:
parent
718512f098
commit
ecd593386f
21 changed files with 301 additions and 78 deletions
|
@ -76,7 +76,7 @@ in {
|
|||
Change specific usages for a certain theme, or for all of them
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
wave = {
|
||||
ui = {
|
||||
|
@ -103,7 +103,7 @@ in {
|
|||
Change all usages of these colors.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
sumiInk0 = "#000000";
|
||||
fujiWhite = "#FFFFFF";
|
||||
|
|
|
@ -89,7 +89,7 @@ in {
|
|||
Each value can be either a boolean or a lua function that returns a boolean.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
markdown = true; # overrides default
|
||||
terraform = false; # disallow specific filetype
|
||||
|
@ -107,7 +107,7 @@ in {
|
|||
|
||||
The key `"*"` can be used to disable the default configuration.
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
javascript = true; # allow specific filetype
|
||||
typescript = true; # allow specific filetype
|
||||
|
@ -138,7 +138,7 @@ in {
|
|||
See `:h vim.lsp.start_client` for list of options.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
trace = "verbose";
|
||||
settings = {
|
||||
|
|
|
@ -126,7 +126,7 @@ in {
|
|||
- ultisnips
|
||||
|
||||
You can also provide a custom function:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
__raw = \'\'
|
||||
function(args)
|
||||
|
|
|
@ -122,7 +122,7 @@ in {
|
|||
layouts =
|
||||
helpers.defaultNullOpts.mkNullable (types.listOf layoutOption)
|
||||
''
|
||||
```
|
||||
```nix
|
||||
[
|
||||
{
|
||||
elements = [
|
||||
|
|
|
@ -317,7 +317,7 @@ in {
|
|||
- values are lua code defining the callback function.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
before_render = \'\'
|
||||
function (state)
|
||||
|
@ -626,7 +626,7 @@ in {
|
|||
mappings =
|
||||
mkMappingsOption
|
||||
''
|
||||
```
|
||||
```nix
|
||||
{
|
||||
"<space>" = {
|
||||
command = "toggle_node";
|
||||
|
@ -679,7 +679,7 @@ in {
|
|||
};
|
||||
filesystem = helpers.mkCompositeOption "Filesystem options" {
|
||||
window = mkWindowMappingsOption (lib.mdDoc ''
|
||||
```
|
||||
```nix
|
||||
{
|
||||
H = "toggle_hidden";
|
||||
"/" = "fuzzy_finder";
|
||||
|
@ -747,7 +747,7 @@ in {
|
|||
Hide by pattern.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
[
|
||||
"*.meta"
|
||||
"*/src/*/tsconfig.json"
|
||||
|
@ -808,7 +808,7 @@ in {
|
|||
|
||||
Either use a list of strings:
|
||||
|
||||
```
|
||||
```nix
|
||||
findArgs = {
|
||||
fd = [
|
||||
"--exclude"
|
||||
|
|
|
@ -21,7 +21,7 @@ in {
|
|||
You should either set a value for this option, or, you can instead set the `data` (and
|
||||
`configuration`) options.
|
||||
|
||||
```
|
||||
```nix
|
||||
plugins.nvim-jdtls = {
|
||||
enable = true;
|
||||
cmd = [
|
||||
|
@ -34,7 +34,7 @@ in {
|
|||
```
|
||||
|
||||
Or,
|
||||
```
|
||||
```nix
|
||||
plugins.nvim-jdtls = {
|
||||
enable = true;
|
||||
data = "/path/to/your/workspace";
|
||||
|
|
|
@ -36,7 +36,7 @@ in {
|
|||
only sucessful runs (or errored-out runs respectively)
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
[
|
||||
"Classic" # display results in the command-line area
|
||||
"VirtualTextOk" # display ok results as virtual text (multiline is shortened)
|
||||
|
|
|
@ -53,14 +53,14 @@ in
|
|||
|
||||
Examples:
|
||||
- `tmux`:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
socket_name = "default";
|
||||
target_pane = "{last}";
|
||||
}
|
||||
```
|
||||
- `zellij`:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
session_id = "current";
|
||||
relative_pane = "right";
|
||||
|
|
|
@ -100,7 +100,7 @@ in {
|
|||
''
|
||||
Lists of additional words that should not be counted as spelling errors.
|
||||
This setting is language-specific, so use an attrs of the format
|
||||
```
|
||||
```nix
|
||||
{
|
||||
"<LANGUAGE1>" = [
|
||||
"<WORD1>"
|
||||
|
@ -121,7 +121,7 @@ in {
|
|||
By default, no additional spelling errors will be ignored.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
"en-US" = [
|
||||
"adaptivity"
|
||||
|
@ -143,7 +143,7 @@ in {
|
|||
''
|
||||
Lists of rules that should be disabled (if enabled by default by LanguageTool).
|
||||
This setting is language-specific, so use an attrs of the format
|
||||
```
|
||||
```nix
|
||||
{
|
||||
"<LANGUAGE1>" = [
|
||||
"<WORD1>"
|
||||
|
@ -165,7 +165,7 @@ in {
|
|||
By default, no additional rules will be disabled.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
"en-US" = [
|
||||
"EN_QUOTES"
|
||||
|
@ -183,7 +183,7 @@ in {
|
|||
''
|
||||
Lists of rules that should be enabled (if disabled by default by LanguageTool).
|
||||
This setting is language-specific, so use an attrs of the format
|
||||
```
|
||||
```nix
|
||||
{
|
||||
"<LANGUAGE1>" = [
|
||||
"<WORD1>"
|
||||
|
@ -205,7 +205,7 @@ in {
|
|||
By default, no additional rules will be enabled.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
"en-GB" = [
|
||||
"PASSIVE_VOICE"
|
||||
|
@ -224,7 +224,7 @@ in {
|
|||
Lists of false-positive diagnostics to hide (by hiding all diagnostics of a specific rule
|
||||
within a specific sentence).
|
||||
This setting is language-specific, so use an attrs of the format
|
||||
```
|
||||
```nix
|
||||
{
|
||||
"<LANGUAGE1>" = [
|
||||
"<JSON1>"
|
||||
|
@ -256,7 +256,7 @@ in {
|
|||
If this list is very large, performance may suffer.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
"en-US" = [ ":/path/to/externalFile.txt" ];
|
||||
}
|
||||
|
@ -273,7 +273,7 @@ in {
|
|||
Some common fields are already ignored, even if you set this setting to an empty attrs.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
maintitle = false;
|
||||
seealso = true;
|
||||
|
@ -295,7 +295,7 @@ in {
|
|||
attrs.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
"\\label{}" = "ignore";
|
||||
"\\documentclass[]{}" = "ignore";
|
||||
|
@ -315,7 +315,7 @@ in {
|
|||
attrs.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
lstlisting = "ignore";
|
||||
verbatim = "ignore";
|
||||
|
@ -338,7 +338,7 @@ in {
|
|||
empty attrs.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
CodeBlock = "ignore";
|
||||
FencedCodeBlock = "ignore";
|
||||
|
|
|
@ -244,7 +244,7 @@ in {
|
|||
See plugin documentation for language specific options.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
python = {
|
||||
coverage_file = ".coverage";
|
||||
|
|
|
@ -60,7 +60,7 @@ in {
|
|||
either be defined as strings or tables.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
[
|
||||
"\r\n"
|
||||
")]}>"
|
||||
|
|
|
@ -93,7 +93,7 @@ in {
|
|||
https://github.com/danymat/neogen/blob/main/docs/adding-languages.md#default-generator
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
csharp = {
|
||||
template = {
|
||||
|
|
|
@ -84,7 +84,7 @@ in {
|
|||
`source`: The source of the asset, either an art asset key or the URL of an image asset.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
# Use art assets uploaded in Discord application for the configured client id
|
||||
js = [ "JavaScript" "javascript" ];
|
||||
|
|
|
@ -55,7 +55,7 @@ in {
|
|||
Configurations for keywords to be recognized as todo comments.
|
||||
|
||||
Default:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
FIX = {
|
||||
icon = " "; # Icon used for the sign, and in search results.
|
||||
|
@ -144,7 +144,7 @@ in {
|
|||
of highlight groups or use the hex color if hl not found as a fallback.
|
||||
|
||||
Default:
|
||||
```
|
||||
```nix
|
||||
{
|
||||
error = [ "DiagnosticError" "ErrorMsg" "#DC2626" ];
|
||||
warning = [ "DiagnosticWarn" "WarningMsg" "#FBBF24" ];
|
||||
|
@ -163,7 +163,7 @@ in {
|
|||
Arguments to use for the search command in list form.
|
||||
|
||||
Default:
|
||||
```
|
||||
```nix
|
||||
[
|
||||
"--color=never"
|
||||
"--no-heading"
|
||||
|
|
|
@ -19,7 +19,7 @@ in {
|
|||
Size of the terminal.
|
||||
`size` can be a number or function
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
size = 20
|
||||
```
|
||||
OR
|
||||
|
@ -78,7 +78,7 @@ in {
|
|||
Highlights which map to a highlight group name and a table of it's values.
|
||||
|
||||
Example:
|
||||
```
|
||||
```nix
|
||||
highlights = {
|
||||
Normal = {
|
||||
guibg = "<VALUE-HERE>";
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue