mirror of
https://github.com/nix-community/nixvim.git
synced 2025-12-24 01:41:14 +01:00
docs: use official names of NixOS, Home Manager and nix-darwin
This commit is contained in:
parent
e006fa229c
commit
4c4cac6445
11 changed files with 22 additions and 22 deletions
|
|
@ -10,7 +10,7 @@ If Nixvim is built using the standalone method, you can access our "helpers" as
|
|||
}
|
||||
```
|
||||
|
||||
If Nixvim is being used as as a home-manager module, a nixos module, or as a darwin module, our "helpers" can be accessed via the `config.lib` option:
|
||||
If Nixvim is being used as as a Home Manager module, a NixOS module, or as a nix-darwin module, our "helpers" can be accessed via the `config.lib` option:
|
||||
|
||||
```nix
|
||||
{ config, ... }:
|
||||
|
|
|
|||
|
|
@ -9,4 +9,4 @@
|
|||
NixVim options specification
|
||||
.SH "DESCRIPTION"
|
||||
.PP
|
||||
This page lists all the options that can be used in NixVim. It can either be used as a Home-Manager module, an NixOS module or a standalone package. Please refer to the installation instructions for more details.
|
||||
This page lists all the options that can be used in NixVim. It can either be used as a Home Manager module, an NixOS module or a standalone package. Please refer to the installation instructions for more details.
|
||||
|
|
|
|||
|
|
@ -1,7 +1,7 @@
|
|||
# Platform-specific options
|
||||
|
||||
All of Nixvim's options are available within `programs.nixvim.*` when Nixvim is used via wrapper modules,
|
||||
such as our NixOS, home-manager, or nix-darwin modules.
|
||||
such as our NixOS, Home Manager, or nix-darwin modules.
|
||||
|
||||
When Nixvim is used standalone (without a wrapper module), its options are available at the "top-level".
|
||||
See [Standalone Usage](./standalone.md) for more info.
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@ There are **no** standalone-specific options available.
|
|||
|
||||
## Using in another configuration
|
||||
|
||||
Here is an example on how to integrate into a NixOS or Home-manager configuration when using flakes.
|
||||
Here is an example on how to integrate into a NixOS or Home Manager configuration when using flakes.
|
||||
|
||||
The example assumes your standalone config is the `default` package of a flake, and you've named the input "`nixvim-config`".
|
||||
```nix
|
||||
|
|
@ -17,7 +17,7 @@ The example assumes your standalone config is the `default` package of a flake,
|
|||
{
|
||||
# NixOS
|
||||
environment.systemPackages = [ inputs.nixvim-config.packages.${system}.default ];
|
||||
# home-manager
|
||||
# Home Manager
|
||||
home.packages = [ inputs.nixvim-config.packages.${system}.default ];
|
||||
}
|
||||
```
|
||||
|
|
@ -53,7 +53,7 @@ This will generate a `init.lua` that will contain the comments from each stages:
|
|||
|
||||
The `config` used to produce a standalone nixvim derivation can be accessed as an attribute on the derivation, similar to `<nixvim>.extend`.
|
||||
|
||||
This may be useful if you want unrelated parts of your NixOS or home-manager configuration to use the same value as something in your nixvim configuration.
|
||||
This may be useful if you want unrelated parts of your NixOS, Home Manager or nix-darwin configuration to use the same value as something in your nixvim configuration.
|
||||
|
||||
## Accessing nixvim options
|
||||
|
||||
|
|
|
|||
|
|
@ -90,7 +90,7 @@ This usually means one of two things:
|
|||
When building nixvim using flakes and our ["standalone mode"][standalone], we usually recommend _not_ declaring a "follows" for `inputs.nixvim`.
|
||||
This is so that nixvim is built against the same nixpkgs revision we're using in our test suite.
|
||||
|
||||
If you are building nixvim using the NixOS, home-manager, or nix-darwin modules then we advise that you keep your nixpkgs lock as close as possible to ours.
|
||||
If you are building nixvim using the NixOS, Home Manager, or nix-darwin modules then we advise that you keep your nixpkgs lock as close as possible to ours.
|
||||
|
||||
> [!TIP]
|
||||
> Once [#1784](https://github.com/nix-community/nixvim/issues/1784) is implemented, there will be alternative ways to achieve this using the module system.
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@ Failure to use the correct branch, or an old revision of nixpkgs will likely res
|
|||
|
||||
NixVim can be used in four ways:
|
||||
- As a NixOS module
|
||||
- As a Home-Manager module
|
||||
- As a Home Manager module
|
||||
- As a nix-darwin module
|
||||
- As a standalone derivation
|
||||
|
||||
|
|
@ -45,14 +45,14 @@ When using flakes you can simply add `nixvim` to the inputs:
|
|||
|
||||
## Usage
|
||||
|
||||
NixVim can be used standalone or as a module for NixOS, home-manager, or nix-darwin.
|
||||
NixVim can be used standalone or as a module for NixOS, Home Manager, or nix-darwin.
|
||||
|
||||
When used standalone, a custom NixVim derivation is produced that can be used like any other package.
|
||||
|
||||
When used as a module, NixVim can be enabled though `programs.nixvim.enable`.
|
||||
|
||||
|
||||
### Usage as a module (NixOS, home-manager, nix-darwin)
|
||||
### Usage as a module (NixOS, Home Manager, nix-darwin)
|
||||
|
||||
When using NixVim as a module you must import the NixVim module into your module system.
|
||||
The three imports are:
|
||||
|
|
@ -92,7 +92,7 @@ options as `programs.nixvim.<path>.<to>.<option> = <value>`.
|
|||
> }
|
||||
> ```
|
||||
|
||||
When you use nixvim as a module, an additional module argument is passed on allowing you to peek through the configuration with `hmConfig`, `nixosConfig`, and `darwinConfig` for home-manager, NixOS, and nix-darwin respectively.
|
||||
When you use nixvim as a module, an additional module argument is passed on allowing you to peek through the configuration with `hmConfig`, `nixosConfig`, and `darwinConfig` for Home Manager, NixOS, and nix-darwin respectively.
|
||||
This is useful if you use nixvim both as part of an environment and standalone.
|
||||
|
||||
For more platform-specific options and information, see [Nixvim Platforms](../platforms/index.md).
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue