vim配置之——ctags与TagList的配置以及NERDTree && doxygentoolkit的安装

参考（2）vim插件：显示树形目录插件NERDTree安装 和 使用

本文档主要对Linux下vim的ctags，TagList，NerdTree与doxgentoolkit进行相关的配置。

以下部分也是对于其他的摘抄：
一、软件ctags
（1）到 http://prdownloads.sourceforge.net/ctags/ctags-5.6.tar.gz
           下载ctags源码ctags-5.6.tar.gz

   （2）解压并安装
           假设在家目录下taogle用户的目录下：
           tar zxvf ctags-5.6.tar.gz
           cd ctags-5.6
          ./configure && make && make install

  （3）使用
          <1> 对于一个工程文件夹如：cd  /home/y/NXP_IMXSOLOX/linux-imx-imx_4.1.15_2.0.0_ga
          <2> 建立ctags文件，在该目录下运行 ctags －R  
              —— "-R"表示递归创建，也就包括源代码根目录下的任何子目录下的源程式（如果你的源码是多层的目录, 就去最上层的目录）。从而在src目录下建立了一个“tags”文件，"tags"文档中包括这些对象的列表。
            如果修改程序后，比如增加了函数定义，删除了变量定义，tags文件不能自动rebuild，必须再次在当前"tags"文件所在的目录下运行 $ctags -R

  （4）跳转
        1)用vim打开一个已经建过标签的c文件    
        2)ctrl+] 找到光标所在位置的标签定义的地方
        3)ctrl+t 回到跳转之前的标签处
     注意：此时运行vim，必须在"tags"文件所在的目录下运行。否则，运行它会找不到"tags"文件，而需要在vim中用":set tags="命令设定"tags"文件的路径。对于一个稍微大点的项目，你可能在任何一个目录下打开vim，然而在每个目录下都生成一个tags文件并不 是个好主意，那么如何解决呢？方法是在.vimrc中增加一行：  

    set tags=tags;/  

    这是告诉vim在当前目录找不到tags文件时请到上层目录查找。
注意：运行vim的时候，必须在"tags"文档所在的目录下运行。否则无法进行索引

二、需要额外安装的脚本：
1、taglist

     下载Taglist，地址是http://sourceforge.net/projects/vim-taglist/files/vim-taglist/
解压taglist_45.zip，可以看到有两个目录doc和plugin，结构如下
taglist_45
|
|-------- doc
|         -------- taglist.txt
|
-------- plugin
          -------- taglist.vim
      执行下列shell命令，即安装完成

cp  doc/taglist.txt           /home/y/.vim
cp  plugin/taglist.vim     /home/y/.vim

     用途:
          打开后，可以显示源码的整体架构，方便地进行跳转。(用惯source insight的人一定勾起某些回忆了^_^)

          在最后添加如下内容

           """""""""""""""""Taglist设置"""""""""""""""""
            let Tlist_Auto_Open = 1
            let Tlist_Ctags_Cmd = '/usr/bin/ctags'        
            let Tlist_Show_One_File = 1
            let Tlist_Exit_OnlyWindow = 1

三：NERDTree的安装
（1）软件包获取：官网：http://download.csdn.net/detail/qq_27977257/9699985
（2）解压缩之后，把 plugin/NERD_tree.vim 和doc/NERD_tree.txt分别拷贝到~/.vim/plugin 和 ~/.vim/doc 目录。
注意：若在启动vim的时候出现：

Error detected while processing /home/.vim/plugin/NERD_tree.vim:
line 68:
E117: Unknown function: nerdtree#runningWindows
E116: Invalid arguments for function <SNR>10_initVariable
line 96:
E117: Unknown function: nerdtree#runningWindows
E15: Invalid expression: nerdtree#runningWindows()
line 141:
E117: Unknown function: nerdtree#loadClassFiles
.................................

则可以将目录下的全部文件移动到$.vim目录下，这样就不会出现错误了，亲测。
在家目录下的.vimrc文件中我们需要添加：

  -----------------------------------------------------------------
    " plugin - NERD_tree.vim 以树状方式浏览系统中的文件和目录
    " :ERDtree 打开NERD_tree :NERDtreeClose 关闭NERD_tree
    " o 打开关闭文件或者目录 t 在标签页中打开
    " T 在后台标签页中打开 ! 执行此文件
    " p 到上层目录 P 到根目录
    " K 到第一个节点 J 到最后一个节点
    " u 打开上层目录 m 显示文件系统菜单（添加、删除、移动操作）
    " r 递归刷新当前目录 R 递归刷新当前根目录
    "-----------------------------------------------------------------
    " F3 NERDTree 切换
    map <F3> :NERDTreeToggle<CR>
    imap <F3> <ESC>:NERDTreeToggle<CR>
     
    let g:NERDTreeWinPos="left"
    let g:NERDTreeWinSize=25
    let g:NERDTreeShowLineNumbers=1
    let g:neocomplcache_enable_at_startup = 1
    "-----------------------------------------------------------------
    " plugin - NERD_commenter.vim 注释代码用的，
    " [count],cc 光标以下count行逐行添加注释(7,cc)
    " [count],cu 光标以下count行逐行取消注释(7,cu)
    " [count],cm 光标以下count行尝试添加块注释(7,cm)
    " ,cA 在行尾插入 /* */,并且进入插入模式。 这个命令方便写注释。
    " 注：count参数可选，无则默认为选中行或当前行
    "-----------------------------------------------------------------
    let NERDSpaceDelims=1 " 让注释符与语句之间留一个空格
    let NERDCompactSexyComs=1 " 多行注释时样子更好看

五：doxygentoolkit的用法
对于这个插件：可能对于某些人员而言是一个累赘，单对于在公司开发的人员而言确是一个不可缺少的插件，有关详细信息请百度，这里只介绍其安装的方法与使用的情况
插件获取：http://www.stack.nl/~dimitri/doxygen/download.html
安装步骤可以其网页上获取

    git clone https://github.com/doxygen/doxygen.git

cd doxygen

mkdir build
cd build
cmake -G "Unix Makefiles" ..                //可能有些需要进行sudo apt-get install cmake
make

make install

获取vimrc文件：http://download.csdn.net/detail/qq_27977257/9700042

cp DoxygenToolKlt.vim $.vim/pulg/

在vimrc中增加以下：

‘’-----------------------------------------------------------------
" plugin - DoxygenToolkit.vim 由注释生成文档，并且能够快速生成函数标准注释
"-----------------------------------------------------------------
let g:DoxygenToolkit_authorName="Mar_Wang, ext.wei.wang2@uaes.com"
let g:DoxygenToolkit_briefTag_funcName="yes"
let g:doxygen_enhanced_color=1
map <leader>da :DoxAuthor<CR>
map <leader>df :Dox<CR>
map <leader>db :DoxBlock<CR>
map <leader>dc a /* */<LEFT><LEFT><LEFT>
"-----------------------------------------------------------------

之后在vim中进行
     License
             将光标放在需要生成 License 的地方，然后输入命令 :DoxLic
    Author
             将光标放在合适的地方，然后输入命令 :DoxAuthor
    Function / Class
             将光标放在 function 或者 class 的名字所在的一行，然后输入命令 :Dox
    Ignore code fragment (C/C++ Only)
             如果想忽略调试部分的代码，那么只需要执行命令 :DoxUndoc(DEBUG) 即可
    Group
             输入命令 DoxBlock 来插入一个注释块

六：将我自己的vim配置贴上，希望对于有的朋友以帮助

set tags=tags
    "设置行号
    set number
    "语法高亮
    syntax on
    "自动对其
    set tabstop=4
    set softtabstop=4
    set shiftwidth=4
    set autoindent
    set cindent
    set smartindent
    set showmatch
    set tags=tags;/      “设置ctags
    set nocompatible " 关闭 vi 兼容模式
    syntax on " 自动语法高亮
    set number " 显示行号
    set cursorline " 突出显示当前行
    set ruler " 打开状态栏标尺
    set shiftwidth=4 " 设定 << 和 >> 命令移动时的宽度为 4
    set softtabstop=4 " 使得按退格键时可以一次删掉 4 个空格
    set tabstop=4 " 设定 tab 长度为 4
    set nobackup " 覆盖文件时不备份
    set autochdir " 自动切换当前目录为当前文件所在的目录
    filetype plugin indent on " 开启插件
    set backupcopy=yes " 设置备份时的行为为覆盖
    set ignorecase smartcase " 搜索时忽略大小写，但在有一个或以上大写字母时仍保持对大小写敏感
    set nowrapscan " 禁止在搜索到文件两端时重新搜索
    set incsearch " 输入搜索内容时就显示搜索结果
    set hlsearch " 搜索时高亮显示被找到的文本
    set noerrorbells " 关闭错误信息响铃
    set novisualbell " 关闭使用可视响铃代替呼叫
    set t_vb= " 置空错误铃声的终端代码
    " set showmatch " 插入括号时，短暂地跳转到匹配的对应括号
    " set matchtime=2 " 短暂跳转到匹配括号的时间
    set magic " 设置魔术
    set hidden " 允许在有未保存的修改时切换缓冲区，此时的修改由 vim 负责保存
    set guioptions-=T " 隐藏工具栏
    set guioptions-=m " 隐藏菜单栏
    set smartindent " 开启新行时使用智能自动缩进
    set backspace=indent,eol,start
    " 不设定在插入状态无法用退格键和 Delete 键删除回车符
    set cmdheight=1 " 设定命令行的行数为 1
    set laststatus=2 " 显示状态栏 (默认值为 1, 无法显示状态栏)
    set statusline= %<%F[%1*%M%*%n%R%H]%= %y %0(%{&fileformat} %{&encoding} %c:%l/%L%)
    " 设置在状态行显示的信息
    "set foldenable " 开始折叠
    "set foldmethod=syntax " 设置语法折叠
    "set foldcolumn=0 " 设置折叠区域的宽度
    "setlocal foldlevel=1 " 设置折叠层数为
    " set foldclose=all " 设置为自动关闭折叠
    " nnoremap <space> @=((foldclosed(line('.')) < 0) ? 'zc' : 'zo')<CR>
    " 用空格键来开关折叠
    " return OS type, eg: windows, or linux, mac, et.st..
    function! MySys()
        if has("win16") || has("win32") || has("win64") || has("win95")
            return "windows"
        elseif has("unix")
            return "linux"
        endif
    endfunction
    " 用户目录变量$VIMFILES
    if MySys() == "windows"
        let $VIMFILES = $VIM.'/vimfiles'
    elseif MySys() == "linux"
        let $VIMFILES = $HOME.'/.vim'
    endif
     
    " 设定doc文档目录
    let helptags=$VIMFILES.'/doc'
    " 设置字体 以及中文支持
    if has("win32")
        set guifont=Inconsolata:h12:cANSI
    endif
     
    " 配置多语言环境
    if has("multi_byte")
        " UTF-8 编码
        set encoding=utf-8
        set termencoding=utf-8
        set formatoptions+=mM
        set fencs=utf-8,gbk
     
        if v:lang =~? '^(zh)|(ja)|(ko)'
            set ambiwidth=double
        endif
        if has("win32")
            source $VIMRUNTIME/delmenu.vim
            source $VIMRUNTIME/menu.vim
            language messages zh_CN.utf-8
        endif
    else
        echoerr "Sorry, this version of (g)vim was not compiled with +multi_byte"
    endif
    " Buffers操作快捷方式!
    nnoremap <C-RETURN> :bnext<CR>
    nnoremap <C-S-RETURN> :bprevious<CR>
    " Tab操作快捷方式!
    nnoremap <C-TAB> :tabnext<CR>
    nnoremap <C-S-TAB> :tabprev<CR>
    "关于tab的快捷键
    " map tn :tabnext<cr>
    " map tp :tabprevious<cr>
    " map td :tabnew .<cr>
    " map te :tabedit
    " map tc :tabclose<cr>
    "窗口分割时,进行切换的按键热键需要连接两次,比如从下方窗口移动
    "光标到上方窗口,需要<c-w><c-w>k,非常麻烦,现在重映射为<c-k>,切换的
    "时候会变得非常方便.
    nnoremap <C-h> <C-w>h
    nnoremap <C-j> <C-w>j
    nnoremap <C-k> <C-w>k
    nnoremap <C-l> <C-w>l
    "一些不错的映射转换语法（如果在一个文件中混合了不同语言时有用）
    nnoremap <leader>1 :set filetype=xhtml<CR>
    nnoremap <leader>2 :set filetype=css<CR>
    nnoremap <leader>3 :set filetype=javascript<CR>
    nnoremap <leader>4 :set filetype=php<CR>
     
    " set fileformats=unix,dos,mac
    " nmap <leader>fd :se fileformat=dos<CR>
    " nmap <leader>fu :se fileformat=unix<CR>
    " use Ctrl+[l|n|p|cc] to list|next|previous|jump to count the result
    " map <C-x>l <ESC>:cl<CR>
    " map <C-x>n <ESC>:cn<CR>
    " map <C-x>p <ESC>:cp<CR>
    " map <C-x>c <ESC>:cc<CR>
     
     
    " 让 Tohtml 产生有 CSS 语法的 html
    " syntax/2html.vim，可以用:runtime! syntax/2html.vim
    let html_use_css=1
     
    " Python 文件的一般设置，比如不要 tab 等
    autocmd FileType python set tabstop=4 shiftwidth=4 expandtab
    autocmd FileType python map <F12> :!python %<CR>
    " 选中状态下 Ctrl+c 复制
    vmap <C-c> "+y
    " 打开javascript折叠
    let b:javascript_fold=1
    " 打开javascript对dom、html和css的支持
    let javascript_enable_domhtmlcss=1
    " 设置字典 ~/.vim/dict/文件的路径
    autocmd filetype javascript set dictionary=$VIMFILES/dict/javascript.dict
    autocmd filetype css set dictionary=$VIMFILES/dict/css.dict
    autocmd filetype php set dictionary=$VIMFILES/dict/php.dict
     
    "-----------------------------------------------------------------
    " plugin - bufexplorer.vim Buffers切换
    " e 全屏方式查看全部打开的文件列表
    " v 左右方式查看 s 上下方式查看
    "-----------------------------------------------------------------
    "-----------------------------------------------------------------
    " plugin - taglist.vim 查看函数列表，需要ctags程序
    " F4 打开隐藏taglist窗口
    "-----------------------------------------------------------------
    if MySys() == "windows" " 设定windows系统中ctags程序的位置
        let Tlist_Ctags_Cmd = '"'.$VIMRUNTIME.'/ctags.exe"'
    elseif MySys() == "linux" " 设定windows系统中ctags程序的位置
        let Tlist_Ctags_Cmd = '/usr/bin/ctags'
    endif
    nnoremap <silent><F4> :TlistToggle<CR>
    let Tlist_Show_One_File = 1 " 不同时显示多个文件的tag，只显示当前文件的
    let Tlist_Exit_OnlyWindow = 1 " 如果taglist窗口是最后一个窗口，则退出vim
    let Tlist_Use_Right_Window = 1 " 在右侧窗口中显示taglist窗口
    let Tlist_File_Fold_Auto_Close=1 " 自动折叠当前非编辑文件的方法列表
    let Tlist_Auto_Open = 0
    let Tlist_Auto_Update = 1
    let Tlist_Hightlight_Tag_On_BufEnter = 1
    let Tlist_Enable_Fold_Column = 0
    let Tlist_Process_File_Always = 1
    let Tlist_Display_Prototype = 0
    let Tlist_Compact_Format = 1
    "-----------------------------------------------------------------
    " plugin - mark.vim 给各种tags标记不同的颜色，便于观看调式的插件。
    " m mark or unmark the word under (or before) the cursor
    " 
 manually input a regular expression. 用于搜索.
    " 
 clear this mark (i.e. the mark under the cursor), or clear all highlighted marks .
    " * 当前MarkWord的下一个 # 当前MarkWord的上一个
    " / 所有MarkWords的下一个 ? 所有MarkWords的上一个
    "-----------------------------------------------------------------
    "-----------------------------------------------------------------
    " plugin - NERD_tree.vim 以树状方式浏览系统中的文件和目录
    " :ERDtree 打开NERD_tree :NERDtreeClose 关闭NERD_tree
    " o 打开关闭文件或者目录 t 在标签页中打开
    " T 在后台标签页中打开 ! 执行此文件
    " p 到上层目录 P 到根目录
    " K 到第一个节点 J 到最后一个节点
    " u 打开上层目录 m 显示文件系统菜单（添加、删除、移动操作）
    " r 递归刷新当前目录 R 递归刷新当前根目录
    "-----------------------------------------------------------------
    " F3 NERDTree 切换
    map <F3> :NERDTreeToggle<CR>
    imap <F3> <ESC>:NERDTreeToggle<CR>
    let g:NERDTreeWinPos="left"
    let g:NERDTreeWinSize=25
    let g:NERDTreeShowLineNumbers=1
    let g:neocomplcache_enable_at_startup = 1
    "-----------------------------------------------------------------
    " plugin - NERD_commenter.vim 注释代码用的，
    " [count],cc 光标以下count行逐行添加注释(7,cc)
    " [count],cu 光标以下count行逐行取消注释(7,cu)
    " [count],cm 光标以下count行尝试添加块注释(7,cm)
    " ,cA 在行尾插入 /* */,并且进入插入模式。 这个命令方便写注释。
    " 注：count参数可选，无则默认为选中行或当前行
    "-----------------------------------------------------------------
    let NERDSpaceDelims=1 " 让注释符与语句之间留一个空格
    let NERDCompactSexyComs=1 " 多行注释时样子更好看
     
     
    "-----------------------------------------------------------------
    " plugin - DoxygenToolkit.vim 由注释生成文档，并且能够快速生成函数标准注释
    "-----------------------------------------------------------------
    let g:DoxygenToolkit_authorName="Mar_Wang, ext.wei.wang2@uaes.com"
    let g:DoxygenToolkit_briefTag_funcName="yes"
    let g:doxygen_enhanced_color=1
    map <leader>da :DoxAuthor<CR>
    map <leader>df :Dox<CR>
    map <leader>db :DoxBlock<CR>
    map <leader>dc a /* */<LEFT><LEFT><LEFT>
    "-----------------------------------------------------------------
    " plugin – ZenCoding.vim 很酷的插件，HTML代码生成
    " 插件最新版：http://github.com/mattn/zencoding-vim
    " 常用命令可看：http://nootn.com/blog/Tool/23/
    "-----------------------------------------------------------------
     
     
    "-----------------------------------------------------------------
    " plugin – checksyntax.vim JavaScript常见语法错误检查
    " 默认快捷方式为 F5
    "-----------------------------------------------------------------
    let g:checksyntax_auto = 0 " 不自动检查
    "-----------------------------------------------------------------
    " plugin - NeoComplCache.vim 自动补全插件
    "-----------------------------------------------------------------
    let g:AutoComplPop_NotEnableAtStartup = 1
    let g:NeoComplCache_EnableAtStartup = 1
    let g:NeoComplCache_SmartCase = 1
    let g:NeoComplCache_TagsAutoUpdate = 1
    let g:NeoComplCache_EnableInfo = 1
    let g:NeoComplCache_EnableCamelCaseCompletion = 1
    let g:NeoComplCache_MinSyntaxLength = 3
    let g:NeoComplCache_EnableSkipCompletion = 1
    let g:NeoComplCache_SkipInputTime = '0.5'
    let g:NeoComplCache_SnippetsDir = $VIMFILES.'/snippets'
    " <TAB> completion.
    inoremap <expr><TAB> pumvisible() ? "<C-n>" : "<TAB>"
    " snippets expand key
    imap <silent> <C-e> <Plug>(neocomplcache_snippets_expand)
    smap <silent> <C-e> <Plug>(neocomplcache_snippets_expand)
     
     
    "-----------------------------------------------------------------