1
1
mirror of https://github.com/orhun/git-cliff.git synced 2024-09-11 15:05:30 +03:00

docs(nix): add installation instructions for Nix (#669)

This commit is contained in:
0x61nas 2024-06-02 22:47:14 +03:00 committed by GitHub
parent 8ffc0548fe
commit 63c8ad43e9
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -0,0 +1,62 @@
---
sidebar_position: 4
---
# Nix
If you are using Nix, **git-cliff** can be installed from the [official latest staple channel][channel-link].
## Using nix-shell
To temporarily install git-cliff in a shell environment, run:
```sh
nix-shell -p git-cliff
```
## Using nix-env
To install git-cliff permanently, use:
```sh
nix-env -iA nixpkgs.git-cliff
```
> [!WARNING]
> Using nix-env permanently modifies a local profile of installed packages.
> This must be updated and maintained by the user in the same way as with a traditional package manager,
> foregoing many of the benefits that make Nix uniquely powerful.
> Using nix-shell or a NixOS configuration is recommended instead.
## The new CLI
If you're using the new experimental CLI, you can use any of the following:
### `nix run
```sh
nix run nixpkgs#git-cliff
```
### `nix shell`
To open a new shell with git-cliff available, use:
```sh
nix shell nixpkgs#git-cliff
```
## Using the Unstable Channel
While new releases of **git-cliff** typically become available in the stable channel relatively quickly, you can use the unstable channel if you want to access the latest features and updates sooner.
To add and update the unstable channel, run:
```sh
nix-channel --add https://nixos.org/channels/nixpkgs-unstable
nix-channel --update nixpkgs
```
After updating to the unstable channel, you can use any of the previous installation commands to install **git-cliff**.
[channel-link]: https://search.nixos.org/packages?channel=24.05&show=git-cliff&from=0&size=50&sort=relevance&type=packages&query=git-cliff