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:
Wolbyte 2023-08-07 13:18:01 +03:30 committed by GitHub
parent 718512f098
commit ecd593386f
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
21 changed files with 301 additions and 78 deletions

View file

@ -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";

View file

@ -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 = {

View file

@ -126,7 +126,7 @@ in {
- ultisnips
You can also provide a custom function:
```
```nix
{
__raw = \'\'
function(args)

View file

@ -122,7 +122,7 @@ in {
layouts =
helpers.defaultNullOpts.mkNullable (types.listOf layoutOption)
''
```
```nix
[
{
elements = [

View file

@ -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"

View file

@ -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";

View file

@ -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)

View file

@ -53,14 +53,14 @@ in
Examples:
- `tmux`:
```
```nix
{
socket_name = "default";
target_pane = "{last}";
}
```
- `zellij`:
```
```nix
{
session_id = "current";
relative_pane = "right";

View file

@ -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";

View file

@ -244,7 +244,7 @@ in {
See plugin documentation for language specific options.
Example:
```
```nix
{
python = {
coverage_file = ".coverage";

View file

@ -60,7 +60,7 @@ in {
either be defined as strings or tables.
Example:
```
```nix
[
"\r\n"
")]}>"

View file

@ -93,7 +93,7 @@ in {
https://github.com/danymat/neogen/blob/main/docs/adding-languages.md#default-generator
Example:
```
```nix
{
csharp = {
template = {

View file

@ -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" ];

View file

@ -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"

View file

@ -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>";