Skip to content

Commit

Permalink
docs(readme): update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
NStefan002 committed Nov 10, 2024
1 parent 730ebb1 commit 1595e58
Showing 1 changed file with 61 additions and 0 deletions.
61 changes: 61 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -1 +1,62 @@
# wormhole.nvim

`Wormhole.nvim` is a Neovim plugin designed to make navigating between multiple
open windows effortless. When activated, it spawns unique labels for each
window, allowing you to jump directly to any window by pressing the
corresponding label key. Ideal for users who work with numerous splits.

## 📺 Showcase

## ⚡️ Requirements

- Neovim version >= 0.10.0

## 📋 Installation

> [!NOTE]
>
> - There is no need to call the `setup` function, only call it if you need to change some options
> - There is no need to lazy load `wormhole`, it lazy loads by default.
[lazy](https://github.com/folke/lazy.nvim):

```lua
return {
"NStefan002/wormhole.nvim",
lazy = false,
version = "*",
}
```

[rocks.nvim](https://github.com/nvim-neorocks/rocks.nvim)

`:Rocks install wormhole.nvim`

## ⚙️ Configuration

- Default settings

```lua
require("wormhole").setup({
labels_type = "home_row",
custom_labels = {},
label_highlight = { link = "IncSearch" },
})
```

| Column1 | Column2 |
| -------------- | --------------- |
| `labels_type` | Which characters to use for labels. Can be one of the following: `home_row`, `numbers`, `custom` |
| `custom_labels` | Array of custom labels to use. Only used if `labels_type` is set to `custom` |
| `label_highlight` | Options for highlight, see `:nvim_set_hl()` |

## ❓ How to use

- You need to set a keymap to activate the `wormhole` functionality. For example:

```lua
vim.keymap.set("n", "<leader>wl", "<Plug>(WormholeLabels)", { desc = "Wormhole Labels" })
vim.keymap.set("n", "<Esc>", "<Plug>(WormholeCloseLabels)", { desc = "Wormhole Close Labels" })
```

- Run `:checkhealth wormhole` to diagnose possible configuration problems

0 comments on commit 1595e58

Please sign in to comment.