mirror of
https://github.com/NotAShelf/neovim-flake.git
synced 2025-12-20 12:50:09 +01:00
NotAShelf
8a1ef233eb
Signed-off-by: NotAShelf <raf@notashelf.dev> Change-Id: Ie853fc60a60c6ff6a945dc67560639ac6a6a6964
115 lines
4.1 KiB
Markdown
115 lines
4.1 KiB
Markdown
# Introduction {#nvf-manual}
|
|
|
|
Generated for nvf @NVF_VERSION@
|
|
|
|
## Preface {#ch-preface}
|
|
|
|
### What is nvf {#sec-what-is-it}
|
|
|
|
[Nix]: https://nixos.org
|
|
|
|
**nvf** is a highly modular, configurable, extensible and _easy to use_ Neovim
|
|
configuration framework built for and designed to be used with [Nix]. Boasting
|
|
flexibility, robustness and ease of use (among other positive traits), this
|
|
project allows you to configure a fully featured Neovim instance with a few
|
|
lines of Nix while leaving all kinds of doors open for integrating Lua in your
|
|
configurations _whether you are a beginner or an advanced user_.
|
|
|
|
## Try it Out {#ch-try-it-out}
|
|
|
|
Thanks to the portability of Nix, you can try out **nvf** without actually
|
|
installing it to your machine. Below are the commands you may run to try out
|
|
different configurations provided by this flake. As of v0.5, two specialized
|
|
configurations are provided:
|
|
|
|
- **Nix** (`packages.nix`) - Nix language server + simple utility plugins
|
|
- **Maximal** (`packages.maximal`) - Variable language servers + utility and
|
|
decorative plugins
|
|
|
|
You may try out any of the provided configurations using the `nix run` command
|
|
on a system where Nix is installed.
|
|
|
|
```sh
|
|
# Add the nvf cache
|
|
$ cachix use nvf # Optional: it'll save you CPU resources and time
|
|
|
|
# Run the minimal configuration with the cache enabled
|
|
$ nix run github:notashelf/nvf#nix # Will run the default minimal configuration
|
|
```
|
|
|
|
Do keep in mind that this is **susceptible to garbage collection** meaning that
|
|
the built outputs will be removed from your Nix store once you garbage collect.
|
|
|
|
## Using Prebuilt Configurations {#sec-using-prebuilt-configs}
|
|
|
|
<!-- markdownlint-disable MD014 -->
|
|
|
|
```bash
|
|
$ nix run github:notashelf/nvf#nix
|
|
$ nix run github:notashelf/nvf#maximal
|
|
```
|
|
|
|
<!-- markdownlint-enable MD014 -->
|
|
|
|
### Available Configurations {#sec-available-configs}
|
|
|
|
> [!NOTE]
|
|
> The below configurations are provided for demonstration purposes, and are
|
|
> **not** designed to be installed as is. You may refer to the installation
|
|
> steps below and the helpful tips section for details on creating your own
|
|
> configurations.
|
|
|
|
#### Nix {#sec-configs-nix}
|
|
|
|
`Nix` configuration by default provides LSP/diagnostic support for Nix alongside
|
|
a set of visual and functional plugins. By running `nix run .#`, which is the
|
|
default package, you will build Neovim with this config.
|
|
|
|
```bash
|
|
$ nix run github:notashelf/nvf#nix test.nix
|
|
# => This will open a file called `test.nix` with Nix LSP and syntax highlighting
|
|
```
|
|
|
|
This command will start Neovim with some opinionated plugin configurations, and
|
|
is designed specifically for Nix. The `nix` configuration lets you see how a
|
|
fully configured Neovim setup _might_ look like without downloading too many
|
|
packages or shell utilities.
|
|
|
|
#### Maximal {#sec-configs-maximal}
|
|
|
|
`Maximal` is the ultimate configuration that will enable support for more
|
|
commonly used language as well as additional complementary plugins. Keep in
|
|
mind, however, that this will pull a lot of dependencies.
|
|
|
|
```bash
|
|
$ nix run github:notashelf/nvf#maximal -- test.nix
|
|
# => This will open a file called `test.nix` with a variety of plugins available
|
|
```
|
|
|
|
It uses the same configuration template with the [Nix](#sec-configs-nix)
|
|
configuration, but supports many more languages, and enables more utility,
|
|
companion or fun plugins.
|
|
|
|
> [!WARNING]
|
|
> Running the maximal config will download _a lot_ of packages as it is
|
|
> downloading language servers, formatters, and more. If CPU time and bandwidth
|
|
> are concerns, please use the default package instead.
|
|
|
|
## Installing nvf {#ch-installation}
|
|
|
|
<!-- markdownlint-disable MD051 -->
|
|
|
|
[module installation section]: #ch-module-installation
|
|
|
|
<!-- markdownlint-enable MD051 -->
|
|
|
|
There are multiple ways of installing **nvf** on your system. You may either
|
|
choose the standalone installation method, which does not depend on a module
|
|
system and may be done on any system that has the Nix package manager or the
|
|
appropriate modules for NixOS and Home Manager as described in the
|
|
[module installation section].
|
|
|
|
```{=include=}
|
|
installation/custom-configuration.md
|
|
installation/modules.md
|
|
```
|