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
|
A plugin for Vim and NeoVim that helps you add license headers to your source
|
||||||
code files.
|
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
|
## Usage
|
||||||
|
|
||||||
You can add a license header to your source file by running the following
|
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>
|
: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
|
## Adding New Licenses
|
||||||
|
|
||||||
To add a new license, create a new file in the `licenses` directory with the
|
To add a new license, create a new file in the `licenses` directory with the
|
||||||
|
|||||||
Reference in New Issue
Block a user