Expand README with installation and configuration instructions
Add comprehensive installation section covering: - Manual installation for Vim and NeoVim - Plugin manager installations: - vim-plug - packer.nvim - lazy.nvim - dein.vim - Vundle Add configuration section for setting g:licenser_author. Add sections documenting: - All supported licenses - All supported file types - Reference to :help licenser Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
This commit is contained in:
@@ -3,6 +3,78 @@
|
||||
A plugin for Vim and NeoVim that helps you add license headers to your source
|
||||
code files.
|
||||
|
||||
## Installation
|
||||
|
||||
### Manual Installation
|
||||
|
||||
1. Clone the repository:
|
||||
|
||||
```bash
|
||||
git clone https://github.com/naortega/vim-licenser.git
|
||||
```
|
||||
|
||||
2. Copy the plugin files to your Vim/NeoVim configuration directory:
|
||||
|
||||
```bash
|
||||
cp -r vim-licenser/plugin/* ~/.vim/plugin/
|
||||
cp -r vim-licenser/doc/* ~/.vim/doc/
|
||||
cp -r vim-licenser/licenses/* ~/.vim/licenses/
|
||||
```
|
||||
|
||||
For NeoVim, use `~/.config/nvim/` instead of `~/.vim/`.
|
||||
|
||||
### Using vim-plug
|
||||
|
||||
Add the following to your `init.vim` or `.vimrc`:
|
||||
|
||||
```vim
|
||||
Plug 'naortega/vim-licenser'
|
||||
```
|
||||
|
||||
Then run `:PlugInstall` in Vim/NeoVim.
|
||||
|
||||
### Using packer.nvim
|
||||
|
||||
Add the following to your `init.lua`:
|
||||
|
||||
```lua
|
||||
use 'naortega/vim-licenser'
|
||||
```
|
||||
|
||||
Then run `:PackerSync` in NeoVim.
|
||||
|
||||
### Using lazy.nvim
|
||||
|
||||
Add the following to your `init.lua`:
|
||||
|
||||
```lua
|
||||
{
|
||||
'naortega/vim-licenser',
|
||||
lazy = true,
|
||||
cmd = 'Licenser',
|
||||
}
|
||||
```
|
||||
|
||||
### Using dein.vim
|
||||
|
||||
Add the following to your `init.vim`:
|
||||
|
||||
```vim
|
||||
call dein#add('naortega/vim-licenser')
|
||||
```
|
||||
|
||||
Then run `:call dein#install()` in Vim/NeoVim.
|
||||
|
||||
### Using Vundle
|
||||
|
||||
Add the following to your `.vimrc`:
|
||||
|
||||
```vim
|
||||
Plugin 'naortega/vim-licenser'
|
||||
```
|
||||
|
||||
Then run `:PluginInstall` in Vim.
|
||||
|
||||
## Usage
|
||||
|
||||
You can add a license header to your source file by running the following
|
||||
@@ -12,6 +84,50 @@ command in Vim or NeoVim:
|
||||
:Licenser <license>
|
||||
```
|
||||
|
||||
### Configuration
|
||||
|
||||
Set your author name in your `init.vim` or `.vimrc`:
|
||||
|
||||
```vim
|
||||
let g:licenser_author = "Your Name"
|
||||
```
|
||||
|
||||
For NeoVim with `init.lua`:
|
||||
|
||||
```lua
|
||||
vim.g.licenser_author = "Your Name"
|
||||
```
|
||||
|
||||
### Supported Licenses
|
||||
|
||||
vim-licenser includes templates for the following licenses:
|
||||
|
||||
- AGPL (GNU Affero General Public License v3)
|
||||
- Apache2 (Apache License 2.0)
|
||||
- BSD2 (BSD 2-Clause License)
|
||||
- BSD3 (BSD 3-Clause License)
|
||||
- GPL (GNU General Public License v3)
|
||||
- GPLv2 (GNU General Public License v2)
|
||||
- ISC (ISC License)
|
||||
- LGPL (GNU Lesser General Public License v3)
|
||||
- MIT (MIT License)
|
||||
- MIT0 (MIT No Attribution License)
|
||||
- MPL2 (Mozilla Public License v2.0)
|
||||
- Unlicense (public domain)
|
||||
- Zlib (Zlib License)
|
||||
|
||||
Use tab completion to see all available licenses: `:Licenser <TAB>`
|
||||
|
||||
### Supported File Types
|
||||
|
||||
vim-licenser automatically detects your file type and applies the appropriate
|
||||
comment style. Supported file types include:
|
||||
bash, c, cpp, csharp, css, dart, go, groovy, haskell, html, java, javascript,
|
||||
json, kotlin, lua, matlab, perl, php, python, r, ruby, rust, scala, shell, sql,
|
||||
swift, typescript, typescriptreact, vim, xml, yaml
|
||||
|
||||
For more information, see `:help licenser` after installation.
|
||||
|
||||
## Adding New Licenses
|
||||
|
||||
To add a new license, create a new file in the `licenses` directory with the
|
||||
|
||||
Reference in New Issue
Block a user