Add a basic README.md

This commit is contained in:
Folkert Kevelam 2024-10-13 20:13:56 +02:00
parent 3879ab1eed
commit 8937c36d68

View File

@ -0,0 +1,54 @@
# Specification Switcher
## TOC
1. [Installation](#-Installation)
2. [Getting Started](#-Getting-Started)
## Installation
`SpecSwitcher` is not yet hosted on Github, so installing the plugin may
need some additional steps. Additionaly, the minimum version for each
API call hasn't been tracked yet so for now the official supported neovim
version is v0.10+
### Install using packer
`Packer` allows the use of a complete URL, which can then be renamed for
ease of use.
```
use {
'https://git.folkert-kevelam.nl/folkert/Neovim-SpecSwitcher.git',
as = 'SpecSwitcher'
}
```
## Getting Started
The plugin consists of two public functions: `setup()` and `Switch()`.
`setup()` is required since it sets the extension mapping and allowed
descend directories.
### Quick Note
As of the moment of writing, the `setup()` functions already sets a keymap
for the switch: `<leader>n`. If you want a different shortcut, the option
`switch_shortcut` in the setup can be used.
### Basic Setup
```
require('SpecSwitcher').setup({
descend_dirs={
"include",
"src"
},
extensions={
{"ads", "adb"},
{"c", {"h", "H", "hh"}},
{"C", {"H", "HH"}},
},
switch_shortcut="<leader>sw"
})
```