From b4abb3c82d50ee2f47e8173e4b427839d65173f9 Mon Sep 17 00:00:00 2001 From: Soliprem Date: Thu, 11 Dec 2025 18:32:09 +0100 Subject: [PATCH] treewide: fix a lot of broken / dead links --- docs/manual/configuring.md | 4 +- docs/manual/configuring/languages.md | 84 +++++++++---------- docs/manual/configuring/overriding-plugins.md | 2 +- docs/manual/hacking.md | 4 +- docs/manual/release-notes/rl-0.1.md | 2 +- docs/manual/release-notes/rl-0.6.md | 12 +-- docs/manual/release-notes/rl-0.7.md | 2 +- docs/manual/release-notes/rl-0.8.md | 10 +-- docs/manual/tips/plugin-sources.md | 4 +- docs/manual/tips/pure-lua-config.md | 2 +- modules/neovim/init/spellcheck.nix | 2 +- modules/plugins/languages/julia.nix | 2 +- modules/wrapper/environment/options.nix | 2 +- modules/wrapper/rc/options.nix | 2 +- 14 files changed, 67 insertions(+), 67 deletions(-) diff --git a/docs/manual/configuring.md b/docs/manual/configuring.md index 4c119bee..99e1755f 100644 --- a/docs/manual/configuring.md +++ b/docs/manual/configuring.md @@ -1,7 +1,7 @@ # Configuring nvf {#ch-configuring} -[helpful tips section]: #ch-helpful-tips -[options reference]: /nvf/options.html +[helpful tips section]: ./tips.html#ch-helpful-tips +[options reference]: ./options.html nvf allows for _very_ extensive configuration in Neovim through the Nix module interface. The below chapters describe several of the options exposed in nvf for diff --git a/docs/manual/configuring/languages.md b/docs/manual/configuring/languages.md index bd2e487d..1b8c5330 100644 --- a/docs/manual/configuring/languages.md +++ b/docs/manual/configuring/languages.md @@ -6,49 +6,49 @@ formatters, and `nvim-lint` linter integration. This gets you capabilities ranging from autocompletion to formatting to diagnostics. The following languages have sections under the `vim.languages` attribute. -- Rust: [vim.languages.rust.enable](#opt-vim.languages.rust.enable) -- Nix: [vim.languages.nix.enable](#opt-vim.languages.nix.enable) -- SQL: [vim.languages.sql.enable](#opt-vim.languages.sql.enable) -- C/C++: [vim.languages.clang.enable](#opt-vim.languages.clang.enable) -- Typescript/Javascript: [vim.languages.ts.enable](#opt-vim.languages.ts.enable) -- Python: [vim.languages.python.enable](#opt-vim.languages.python.enable): -- Zig: [vim.languages.zig.enable](#opt-vim.languages.zig.enable) -- Markdown: [vim.languages.markdown.enable](#opt-vim.languages.markdown.enable) -- HTML: [vim.languages.html.enable](#opt-vim.languages.html.enable) -- Dart: [vim.languages.dart.enable](#opt-vim.languages.dart.enable) -- Go: [vim.languages.go.enable](#opt-vim.languages.go.enable) -- Lua: [vim.languages.lua.enable](#opt-vim.languages.lua.enable) -- PHP: [vim.languages.php.enable](#opt-vim.languages.php.enable) -- F#: [vim.languages.fsharp.enable](#opt-vim.languages.fsharp.enable) -- Assembly: [vim.languages.assembly.enable](#opt-vim.languages.assembly.enable) -- Astro: [vim.languages.astro.enable](#opt-vim.languages.astro.enable) -- Bash: [vim.languages.bash.enable](#opt-vim.languages.bash.enable) -- Clang: [vim.languages.clang.enable](#opt-vim.languages.clang.enable) -- Clojure: [vim.languages.clojure.enable](#opt-vim.languages.clojure.enable) -- C#: [vim.languages.csharp.enable](#opt-vim.languages.csharp.enable) -- CSS: [vim.languages.css.enable](#opt-vim.languages.css.enable) -- CUE: [vim.languages.cue.enable](#opt-vim.languages.cue.enable) -- Elixir: [vim.languages.elixir.enable](#opt-vim.languages.elixir.enable) -- Gleam: [vim.languages.gleam.enable](#opt-vim.languages.gleam.enable) -- HCL: [vim.languages.hcl.enable](#opt-vim.languages.hcl.enable) -- Helm: [vim.languages.helm.enable](#opt-vim.languages.helm.enable) -- Julia: [vim.languages.julia.enable](#opt-vim.languages.julia.enable) -- Kotlin: [vim.languages.kotlin.enable](#opt-vim.languages.kotlin.enable) -- Nim: [vim.languages.nim.enable](#opt-vim.languages.nim.enable) -- Nu: [vim.languages.nu.enable](#opt-vim.languages.nu.enable) -- OCaml: [vim.languages.ocaml.enable](#opt-vim.languages.ocaml.enable) -- Odin: [vim.languages.odin.enable](#opt-vim.languages.odin.enable) -- R: [vim.languages.r.enable](#opt-vim.languages.r.enable) -- Ruby: [vim.languages.ruby.enable](#opt-vim.languages.ruby.enable) -- Scala: [vim.languages.scala.enable](#opt-vim.languages.scala.enable) -- Svelte: [vim.languages.svelte.enable](#opt-vim.languages.svelte.enable) -- Tailwind: [vim.languages.tailwind.enable](#opt-vim.languages.tailwind.enable) +- Rust: [vim.languages.rust.enable](./options.html#option-vim-languages-rust-enable) +- Nix: [vim.languages.nix.enable](./options.html#option-vim-languages-nix-enable) +- SQL: [vim.languages.sql.enable](./options.html#option-vim-languages-sql-enable) +- C/C++: [vim.languages.clang.enable](./options.html#option-vim-languages-clang-enable) +- Typescript/Javascript: [vim.languages.ts.enable](./options.html#option-vim-languages-ts-enable) +- Python: [vim.languages.python.enable](./options.html#option-vim-languages-python-enable): +- Zig: [vim.languages.zig.enable](./options.html#option-vim-languages-zig-enable) +- Markdown: [vim.languages.markdown.enable](./options.html#option-vim-languages-markdown-enable) +- HTML: [vim.languages.html.enable](./options.html#option-vim-languages-html-enable) +- Dart: [vim.languages.dart.enable](./options.html#option-vim-languages-dart-enable) +- Go: [vim.languages.go.enable](./options.html#option-vim-languages-go-enable) +- Lua: [vim.languages.lua.enable](./options.html#option-vim-languages-lua-enable) +- PHP: [vim.languages.php.enable](./options.html#option-vim-languages-php-enable) +- F#: [vim.languages.fsharp.enable](./options.html#option-vim-languages-fsharp-enable) +- Assembly: [vim.languages.assembly.enable](./options.html#option-vim-languages-assembly-enable) +- Astro: [vim.languages.astro.enable](./options.html#option-vim-languages-astro-enable) +- Bash: [vim.languages.bash.enable](./options.html#option-vim-languages-bash-enable) +- Clang: [vim.languages.clang.enable](./options.html#option-vim-languages-clang-enable) +- Clojure: [vim.languages.clojure.enable](./options.html#option-vim-languages-clojure-enable) +- C#: [vim.languages.csharp.enable](./options.html#option-vim-languages-csharp-enable) +- CSS: [vim.languages.css.enable](./options.html#option-vim-languages-css-enable) +- CUE: [vim.languages.cue.enable](./options.html#option-vim-languages-cue-enable) +- Elixir: [vim.languages.elixir.enable](./options.html#option-vim-languages-elixir-enable) +- Gleam: [vim.languages.gleam.enable](./options.html#option-vim-languages-gleam-enable) +- HCL: [vim.languages.hcl.enable](./options.html#option-vim-languages-hcl-enable) +- Helm: [vim.languages.helm.enable](./options.html#option-vim-languages-helm-enable) +- Julia: [vim.languages.julia.enable](./options.html#option-vim-languages-julia-enable) +- Kotlin: [vim.languages.kotlin.enable](./options.html#option-vim-languages-kotlin-enable) +- Nim: [vim.languages.nim.enable](./options.html#option-vim-languages-nim-enable) +- Nu: [vim.languages.nu.enable](./options.html#option-vim-languages-nu-enable) +- OCaml: [vim.languages.ocaml.enable](./options.html#option-vim-languages-ocaml-enable) +- Odin: [vim.languages.odin.enable](./options.html#option-vim-languages-odin-enable) +- R: [vim.languages.r.enable](./options.html#option-vim-languages-r-enable) +- Ruby: [vim.languages.ruby.enable](./options.html#option-vim-languages-ruby-enable) +- Scala: [vim.languages.scala.enable](./options.html#option-vim-languages-scala-enable) +- Svelte: [vim.languages.svelte.enable](./options.html#option-vim-languages-svelte-enable) +- Tailwind: [vim.languages.tailwind.enable](./options.html#option-vim-languages-tailwind-enable) - Terraform: - [vim.languages.terraform.enable](#opt-vim.languages.terraform.enable) -- Typst: [vim.languages.typst.enable](#opt-vim.languages.typst.enable) -- Vala: [vim.languages.vala.enable](#opt-vim.languages.vala.enable) -- WGSL: [vim.languages.wgsl.enable](#opt-vim.languages.wgsl.enable) -- YAML: [vim.languages.yaml.enable](#opt-vim.languages.yaml.enable) + [vim.languages.terraform.enable](./options.html#option-vim-languages-terraform-enable) +- Typst: [vim.languages.typst.enable](./options.html#option-vim-languages-typst-enable) +- Vala: [vim.languages.vala.enable](./options.html#option-vim-languages-vala-enable) +- WGSL: [vim.languages.wgsl.enable](./options.html#option-vim-languages-wgsl-enable) +- YAML: [vim.languages.yaml.enable](./options.html#option-vim-languages-yaml-enable) Adding support for more languages, and improving support for existing ones are great places where you can contribute with a PR. diff --git a/docs/manual/configuring/overriding-plugins.md b/docs/manual/configuring/overriding-plugins.md index 223bf5b6..e44c1d08 100644 --- a/docs/manual/configuring/overriding-plugins.md +++ b/docs/manual/configuring/overriding-plugins.md @@ -1,6 +1,6 @@ # Overriding plugins {#ch-overriding-plugins} -The [additional plugins section](#sec-additional-plugins) details the addition +The [additional plugins section](./hacking.html#sec-additional-plugins) details the addition of new plugins to nvf under regular circumstances, i.e. while making a pull request to the project. You may _override_ those plugins in your config to change source versions, e.g., to use newer versions of plugins that are not yet diff --git a/docs/manual/hacking.md b/docs/manual/hacking.md index 85bb3ed1..609ddc92 100644 --- a/docs/manual/hacking.md +++ b/docs/manual/hacking.md @@ -273,7 +273,7 @@ An example, simple keybinding, can look like this: ``` There are many settings available in the options. Please refer to the -[documentation](https://notashelf.github.io/nvf/options.html#opt-vim.keymaps) to +[documentation](./options.html#option-vim-keymaps) to see a list of them. **nvf** provides a helper function, so that you don't have to write the mapping @@ -601,7 +601,7 @@ require('lz.n').load({ }) ``` -[`vim.lazy.plugins` spec]: https://notashelf.github.io/nvf/options.html#opt-vim.lazy.plugins +[`vim.lazy.plugins` spec]: ./options.html#option-vim-lazy-plugins A full list of options can be found in the [`vim.lazy.plugins` spec] on the rendered manual. diff --git a/docs/manual/release-notes/rl-0.1.md b/docs/manual/release-notes/rl-0.1.md index 8fc48ca8..bdb922b5 100644 --- a/docs/manual/release-notes/rl-0.1.md +++ b/docs/manual/release-notes/rl-0.1.md @@ -15,7 +15,7 @@ DAG implementation are from them. longer defined. If you use hare and would like it added back, please file an issue. -- {option}`vim.startPlugins) & [](#opt-vim.optPlugins` are now an enum of +- {option}`vim.startPlugins` & {option} `vim-optPlugins` are now an enum of `string` for options sourced from the flake inputs. Users can still provide vim plugin packages. diff --git a/docs/manual/release-notes/rl-0.6.md b/docs/manual/release-notes/rl-0.6.md index b40e2930..13cdd7bb 100644 --- a/docs/manual/release-notes/rl-0.6.md +++ b/docs/manual/release-notes/rl-0.6.md @@ -41,7 +41,7 @@ end vim.api.nvim_set_keymap('n', 'a', ':lua camelToSnake()', { noremap = true, silent = true }) ``` -## Changelog {#sec-release-0.6-changelog} +## Changelog {#sec-release-0-6-changelog} [ksonj](https://github.com/ksonj): @@ -95,7 +95,7 @@ vim.api.nvim_set_keymap('n', 'a', ':lua camelToSnake()', { noremap = and also has been removed. - `which-key.nvim` categories can now be customized through - [vim.binds.whichKey.register](#opt-vim.binds.whichKey.register) + [vim.binds.whichKey.register](./options.html#option-vim-binds-whichKey-register) - Added `magick` to `vim.luaPackages` for `image.nvim`. @@ -125,10 +125,10 @@ vim.api.nvim_set_keymap('n', 'a', ':lua camelToSnake()', { noremap = - Lualine module now allows customizing `always_divide_middle`, `ignore_focus` and `disabled_filetypes` through the new options: - [vim.statusline.lualine.alwaysDivideMiddle](#opt-vim.statusline.lualine.alwaysDivideMiddle), - [vim.statusline.lualine.ignoreFocus](#opt-vim.statusline.lualine.ignoreFocus) + [vim.statusline.lualine.alwaysDivideMiddle](./options.html#option-vim-statusline-lualine-alwaysDivideMiddle), + [vim.statusline.lualine.ignoreFocus](./options.html#option-vim-statusline-lualine-ignoreFocus) and - [vim.statusline.lualine.disabledFiletypes](#opt-vim.statusline.lualine.disabledFiletypes). + [vim.statusline.lualine.disabledFiletypes](./options.html#option-vim-statusline-lualine-disabledFiletypes). - Updated all plugin inputs to their latest versions (**21.04.2024**) - this brought minor color changes to the Catppuccin theme. @@ -159,7 +159,7 @@ vim.api.nvim_set_keymap('n', 'a', ':lua camelToSnake()', { noremap = arguments to take `luaBefore`, `luaConfig` and `luaAfter` as strings, which are then concatted inside a lua block. -- Added {option}`vim.luaConfigPre) and [](#opt-vim.luaConfigPost` for inserting +- Added {option}`vim.luaConfigPre` and {option} `vim-luaConfigPost` for inserting verbatim Lua configuration before and after the resolved Lua DAG respectively. Both of those options take strings as the type, so you may read the contents of a Lua file from a given path. diff --git a/docs/manual/release-notes/rl-0.7.md b/docs/manual/release-notes/rl-0.7.md index d5bb7a51..36d61105 100644 --- a/docs/manual/release-notes/rl-0.7.md +++ b/docs/manual/release-notes/rl-0.7.md @@ -115,7 +115,7 @@ The changes are, in no particular order: replicate the same functionality by setting `shiftwidth`, `tabstop` and `softtabstop` under `vim.options` as you see fit. -## Changelog {#sec-release-0.7-changelog} +## Changelog {#sec-release-0-7-changelog} [ItsSorae](https://github.com/ItsSorae): diff --git a/docs/manual/release-notes/rl-0.8.md b/docs/manual/release-notes/rl-0.8.md index 3fe354c5..62f42638 100644 --- a/docs/manual/release-notes/rl-0.8.md +++ b/docs/manual/release-notes/rl-0.8.md @@ -74,7 +74,7 @@ - Add {option}`vim.lsp.lightbulb.autocmd.enable` for manually managing the previously managed lightbulb autocommand. - - A warning will occur if [](#opt-vim.lsp.lightbulb.autocmd.enable) and + - A warning will occur if {option} vim-lsp-lightbulb-autocmd-enable) and `vim.lsp.lightbulb.setupOpts.autocmd.enabled` are both set at the same time. Pick only one. @@ -85,7 +85,7 @@ - Add [yazi.nvim] as a companion plugin for Yazi, the terminal file manager. -- Add {option}`vim.autocmds) and [](#opt-vim.augroups` to allow declaring +- Add {option}`vim.autocmds` and {option}`vim-augroups` to allow declaring autocommands via Nix. - Fix plugin `setupOpts` for yanky.nvim and assert if shada is configured as a @@ -225,8 +225,8 @@ [thamenato](https://github.com/thamenato): -[ruff]: (https://github.com/astral-sh/ruff) -[cue]: (https://cuelang.org/) +[ruff]: https://github.com/astral-sh/ruff +[cue]: https://cuelang.org/ - Add [ruff] as a formatter option in `vim.languages.python.format.type`. - Add [cue] support under `vim.languages.cue`. @@ -553,7 +553,7 @@ [valterschutz](https://github.com/valterschutz): -[ruff]: (https://github.com/astral-sh/ruff) +[ruff]: https://github.com/astral-sh/ruff - Add [ruff-fix] as a formatter option in `vim.languages.python.format.type`. diff --git a/docs/manual/tips/plugin-sources.md b/docs/manual/tips/plugin-sources.md index 7cf6a470..a6f8d71d 100644 --- a/docs/manual/tips/plugin-sources.md +++ b/docs/manual/tips/plugin-sources.md @@ -26,7 +26,7 @@ startup. } ``` -[`vim.extraPlugins`]: https://notashelf.github.io/nvf/options.html#opt-vim.extraPlugins +[`vim.extraPlugins`]: ./options.html#option-vim-extraPlugins This will fetch aerial.nvim from nixpkgs, and add it to Neovim's runtime path to be loaded manually. Although for plugins that require manual setup, you are @@ -43,7 +43,7 @@ encouraged to use [`vim.extraPlugins`]. } ``` -[custom plugins section]: https://notashelf.github.io/nvf/index.xhtml#ch-custom-plugins +[custom plugins section]: ./configuring.html#ch-custom-plugins More details on the extraPlugins API is documented in the [custom plugins section]. diff --git a/docs/manual/tips/pure-lua-config.md b/docs/manual/tips/pure-lua-config.md index e4ce03df..d81d9ee5 100644 --- a/docs/manual/tips/pure-lua-config.md +++ b/docs/manual/tips/pure-lua-config.md @@ -105,7 +105,7 @@ this } ``` -[DAG system]: https://notashelf.github.io/nvf/index.xhtml#ch-using-dags +[DAG system]: ./configuring.html#ch-using-dags After you load your custom configuration, you may use an `init.lua` located in your custom configuration directory to configure Neovim exactly as you would diff --git a/modules/neovim/init/spellcheck.nix b/modules/neovim/init/spellcheck.nix index 9f635bf5..724b432d 100644 --- a/modules/neovim/init/spellcheck.nix +++ b/modules/neovim/init/spellcheck.nix @@ -29,7 +29,7 @@ in { To add your own language files, you may place your `spell` directory in either {file}`$XDG_CONFIG_HOME/nvf` or in a path that is included in the - [additionalRuntimePaths](#opt-vim.additionalRuntimePaths) list provided by nvf. + [additionalRuntimePaths](./options.html#option-vim-additionalRuntimePaths) list provided by nvf. ''; }; diff --git a/modules/plugins/languages/julia.nix b/modules/plugins/languages/julia.nix index 577798c7..971e9f03 100644 --- a/modules/plugins/languages/julia.nix +++ b/modules/plugins/languages/julia.nix @@ -107,7 +107,7 @@ in { option, since there is no way to provide only the LSP server. If you want to avoid that, you have to change - [vim.lsp.servers.julials.cmd](#opt-vim.lsp.servers._name_.cmd) to use + {option}`vim.lsp.servers.julials.cmd` to use the Julia binary in {env}`PATH`, and add the `LanguageServer` package to Julia in your devshells. diff --git a/modules/wrapper/environment/options.nix b/modules/wrapper/environment/options.nix index d3b28b0f..5b2f1f63 100644 --- a/modules/wrapper/environment/options.nix +++ b/modules/wrapper/environment/options.nix @@ -47,7 +47,7 @@ in { internally to add plugins to Neovim's runtime. To add additional plugins to your configuration, consider - using the [{option}`vim.extraPlugins`](#opt-vim.extraPlugins) + using the {option}`vim.extraPlugins` option. ''; }; diff --git a/modules/wrapper/rc/options.nix b/modules/wrapper/rc/options.nix index 7ba15bd8..f1baaa17 100644 --- a/modules/wrapper/rc/options.nix +++ b/modules/wrapper/rc/options.nix @@ -284,7 +284,7 @@ in { default = ""; defaultText = literalMD '' By default, this option will **append** paths in - {option}`vim.additionalRuntimePaths` + {option}`vim-additionalRuntimePaths` to the `runtimepath` and enable the experimental Lua module loader if {option}`vim.enableLuaLoader` is set to true. '';