vim-header

Ⅰ. 插件描述

Easily adds brief author info and license headers

Ⅱ. 基本信息

创建日期：  2016-03-09
使用用户：  42
Github星：  84
插件作者：  H.Alper Tuna

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加: 
Plugin 'alpertuna/vim-header-hard-things'
… 然后在Vim中运行以下命令: 
:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加: 
NeoBundle 'alpertuna/vim-header-hard-things'
… 然后在Vim中运行以下命令: 
:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加: 
Plug 'alpertuna/vim-header-hard-things'
… 然后在Vim中运行以下命令: 
:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令: 
cd ~/.vim/bundle
git clone https://github.com/alpertuna/vim-header

Ⅳ. 文档说明

vim-header

Easily adds brief author info and license headers

Table of Contents

Install

Preferred installation method is
Pathogen

cd ~/.vim/bundle
git clone https://github.com/alpertuna/vim-header

Or you can use your own way

Usage

This is a general usage example.
You can add these lines into your .vimrc

let g:header_field_author = 'Your Name'
let g:header_field_author_email = 'your@mail'
map <F4> :AddHeader<CR>

Pressing F4 in normal mode will add a brief author information at the top of
your buffer.

Examples

For example, when you open a file named start.sh and press F4 after above
settings, plugin will add these lines at the top of your buffer

#!/bin/bash
# File: start.sh
# Author: Your Name <your@mail>
# Date: 13.03.2016
# Last Modified Date: 13.03.2016
# Last Modified By: Your Name <your@mail>

or for a file named index.php

<?php
/*
 * File: index.php
 * @author: Your Name <your@mail>
 * Date: 13.03.2016
 * Last Modified Date: 13.03.2016
 * Last Modified By: Your Name <your@mail>
 */

⬆ back to top

Commands

Adding Headers

  • :AddHeader Adds brief author information or updates if exists
  • :AddMinHeader Adds minified version of author information

Adding Licenses

  • :AddMITLicense Adds MIT License
  • :AddApacheLicense Adds Apache License
  • :AddGNULicense Adds GNU GP License v3
  • :AddAGPLicense Adds GNU Affero GP License v3
  • :AddWTFPLLicense Adds WTFPL License

⬆ back to top

Settings

These settings are for your $MYVIMRC (vim: .vimrc, neovim:
.config/nvim/init.vim)

Settings List

Settings related to headers:

Settings related to headers' fields:

Settings related to supported filetypes:

g:header_auto_add_header

let g:header_auto_add_header = 0

Toggles automatic headers' addition. 1 by default.

g:header_alignment

let g:header_alignment = 0

Aligns headers' values. 1 by default.

g:header_max_size

let g:header_max_size = 20

Sets the range from which vim-header will search for required headers (ones sets
in global options) to determinate if it should update existing headers or add
new ones.

This options is used to prevent text replacement if your file contains text
matching headers (for instance File:). See
#20
for more explanations. 7 by default.

g:header_field_filename

let g:header_field_filename = 0

Toggles File: header field. 1 by default.

g:header_field_filename_path

let g:header_field_filename_path = 1

Uses filename instead of full path in File: header field. 0 by default.

g:header_field_author

let g:header_field_author = 'Your Name'

Sets defined value for Author: and Last Modified By: fields. Empty string
disables it. '' by default.

g:header_field_author_email

let g:header_field_author_email = 'your@mail'

Adds defined value surrounded by <, > after author name in Author: and
Last Modified By: fields. g:header_field_author must be set and not be empty
in order to add email to its value. Empty string disables adding email value.
'' by default.

g:header_field_copyright

let g:header_field_copyright = ''

Adds custom copyright lines. '' by default.

g:header_field_timestamp

let g:header_field_timestamp = 0

Toggles Date: header field. 1 by default.

g:header_field_modified_timestamp

let g:header_field_modified_timestamp = 0

Toggles Last Modified Date: header field. 1 by default.

g:header_field_modified_by

let g:header_field_modified_by = 0

Toggles Last Modified By: header field. This header value relies on
g:header_field_author value. In order to shows up **g:header_field_author
must be set and not be empty. 1 by default**.

g:header_field_timestamp_format

let g:header_field_timestamp_format = '%d.%m.%Y'

Sets timestamp format. %d.%m.%Y by default.

g:header_field_license_id

let g:header_field_license_id = 'BSD-3-Clause'

Sets license field. '' by default.

g:header_cfg_comment_char

let g:header_cfg_comment_char = ';'

Sets cfg's filetype comment character as this filetype supports multiple set of
comment characters (;, //, #, ...). # by default.

⬆ back to top

Filetypes support

Supported filetypes are:

  • asm
  • c
  • cfg
  • clojure
  • cpp
  • cs
  • css
  • dosini
  • elixir
  • erlang
  • go
  • groovy
  • haskel
  • java
  • javascript
  • jsx
  • less
  • lisp
  • lua
  • matlab/octave
  • ocaml
  • php
  • perl
  • plaintex
  • pug
  • python
  • rst
  • ruby
  • rust
  • sass
  • scala
  • scheme
  • sh
  • tex
  • tmux
  • vhdl
  • verilog
  • vim
  • xdefaults
  • yaml
  • vimwiki
  • proto

And licenses are:

  • MIT
  • Apache
  • GNU
  • WTFPL

If you want more filetypes or licenses, you can open issues or provide any
improvements by pull requests on
alpertuna/vim-header. Also you can
correct my English on README file or at comments in source code.

Thanks to Contributors

Contributors List

⬆ back to top

添加新评论