mirror of
https://github.com/NotAShelf/nvf.git
synced 2025-11-04 12:42:21 +00:00
NotAShelf
2728e65a5e
Some checks failed
Check for typos in the source tree / check-typos (push) Waiting to run
Set up binary cache / cachix (default) (push) Has been cancelled
Set up binary cache / cachix (maximal) (push) Has been cancelled
Set up binary cache / cachix (nix) (push) Has been cancelled
Validate flake & check documentation / Validate Flake Documentation (docs) (push) Has been cancelled
Validate flake & check documentation / Validate Flake Documentation (docs-html) (push) Has been cancelled
Validate flake & check documentation / Validate Flake Documentation (docs-json) (push) Has been cancelled
Validate flake & check documentation / Validate Flake Documentation (docs-manpages) (push) Has been cancelled
Validate flake & check documentation / Validate hyperlinks in documentation sources (push) Has been cancelled
Validate flake & check formatting / Validate Flake (push) Has been cancelled
Validate flake & check formatting / Formatting via Alejandra (push) Has been cancelled
Build and deploy documentation / Check latest commit (push) Has been cancelled
Build and deploy documentation / publish (push) Has been cancelled
89 lines
2.5 KiB
Markdown
89 lines
2.5 KiB
Markdown
# NixOS Module {#ch-nixos-module}
|
|
|
|
The NixOS module allows us to customize the different `vim` options from inside
|
|
the NixOS configuration without having to call for the wrapper yourself. It is
|
|
the recommended way to use **nvf** alongside the home-manager module depending
|
|
on your needs.
|
|
|
|
To use it, we first add the input flake.
|
|
|
|
```nix
|
|
{
|
|
inputs = {
|
|
# Optional, if you intend to follow nvf's obsidian-nvim input
|
|
# you must also add it as a flake input.
|
|
obsidian-nvim.url = "github:epwalsh/obsidian.nvim";
|
|
|
|
# Required, nvf works best and only directly supports flakes
|
|
nvf = {
|
|
url = "github:notashelf/nvf";
|
|
# You can override the input nixpkgs to follow your system's
|
|
# instance of nixpkgs. This is safe to do as nvf does not depend
|
|
# on a binary cache.
|
|
inputs.nixpkgs.follows = "nixpkgs";
|
|
# Optionally, you can also override individual plugins
|
|
# for example:
|
|
inputs.obsidian-nvim.follows = "obsidian-nvim"; # <- this will use the obsidian-nvim from your inputs
|
|
};
|
|
};
|
|
}
|
|
```
|
|
|
|
Followed by importing the NixOS module somewhere in your configuration.
|
|
|
|
```nix
|
|
{
|
|
# assuming nvf is in your inputs and inputs is in the argset
|
|
# see example below
|
|
imports = [ inputs.nvf.nixosModules.default ];
|
|
}
|
|
```
|
|
|
|
## Example Installation {#sec-example-installation-nixos}
|
|
|
|
```nix
|
|
{
|
|
inputs = {
|
|
nixpkgs.url = "github:NixOS/nixpkgs/nixos-unstable";
|
|
nvf.url = "github:notashelf/nvf";
|
|
};
|
|
|
|
outputs = { nixpkgs, nvf, ... }: {
|
|
# ↓ this is your host output in the flake schema
|
|
nixosConfigurations."your-hostname" = nixpkgs.lib.nixosSystem {
|
|
modules = [
|
|
nvf.nixosModules.default # <- this imports the NixOS module that provides the options
|
|
./configuration.nix # <- your host entrypoint, `programs.nvf.*` may be defined here
|
|
];
|
|
};
|
|
};
|
|
}
|
|
```
|
|
|
|
Once the module is properly imported by your host, you will be able to use the
|
|
`programs.nvf` module option anywhere in your configuration in order to
|
|
configure **nvf**.
|
|
|
|
```nix{
|
|
programs.nvf = {
|
|
enable = true;
|
|
# your settings need to go into the settings attribute set
|
|
# most settings are documented in the appendix
|
|
settings = {
|
|
vim.viAlias = false;
|
|
vim.vimAlias = true;
|
|
vim.lsp = {
|
|
enable = true;
|
|
};
|
|
};
|
|
};
|
|
}
|
|
```
|
|
|
|
::: {.note}
|
|
|
|
**nvf** exposes a lot of options, most of which are not referenced in the
|
|
installation sections of the manual. You may find all available options in the
|
|
[appendix](https://notashelf.github.io/nvf/options)
|
|
|
|
:::
|