Skip to content

Latest commit

 

History

History
91 lines (62 loc) · 3.11 KB

README.md

File metadata and controls

91 lines (62 loc) · 3.11 KB

All vim plugins, ready to go

This repo auto generates nix packages for vim/neovim plugins. Packages are automatically updated twice per week using a GitHub Actions. Plugins are fetched from the manifest.yaml and awesome-neovim repo.

This is a fork of this repo; however, we fetch all additions from the original repo, so we will never have less plugins. Further, the original deletes plugins that are available in the nixpkgs. We, instead, try to assemble a list of all available plugins. Therefore, to access plugins you will never have to search in two places.

Available plugins

The plugins.md contains an auto-generated list of all available plugins.

Usage

  • Sometimes, a new plugin has the same name as an existing one. In this case, we rename the new plugin to <plugin-name>-<owner>.

To access the plugins, you need to add the overlay. The overlay adds extra Vim plugins to pkgs.vimExtraPlugins. First, add this repo to your inputs:

inputs.nixneovimplugins.url = github:NixNeovim/NixNeovimPlugins

Next, apply the provided overlay:

nixpkgs.overlays = [
  inputs.nixneovimplugins.overlays.default
];

Finally, you can add the packages to your vim/neovim config. For example you can use NixNeovim or you can add the plugins directly:

 programs.neovim = {
   plugins = [
     pkgs.vimExtraPlugins.nvim-colorizer-lua
   ];
 }

More info on using neovim with nix can be found here: NixOS Neovim

Contribution

How to add a new plugin

1. Add the plugin to manifest.yaml:

The new yaml format has the following format

- owner: nvim-telescope
  repo: telescope.nvim
  # the following keys are optional
  branch: ... # explicitly select branch
  custom_name: ... # set custom name, used to fix name clashes
  license: ... # specify license
  commit: ... # specify commit to use, can be used when newest version is broken
  warning: ... # add a waning that will be displayed when using the plugin, will also be visible in plugins.md

Supported are Github (default), SourceHut, and GitLab.

2. Create a Pull Request

  • Create a pull request with the changed manifest.yaml (and blocklist.yaml if neccessary).
  • A GitHub action will check your contribution and generate all neccessary nix code for your new plugin. It will also take care of sorting and cleaning the manifest.yaml
  • After all checks have passed, I will merge your change.

I am happy for any contribution. :)

How to remove a new plugin

this contains old information. Just open an issue for now

Copy the entry from manifest.yaml to blocklist.yaml and create a PR. The GitHub Actions will do the rest, including removing the entry from manifest.yaml

Credits

This is originally based on work by m15a