mikehaertl/yii2-apidoc-vim

Yii 2 apidoc as Vim helpfiles

Yii 2 API docs for Vim

Installation

Add mikehaertl/yii2-apidoc-vim to your Vundle configuration., _(*1)

Alternatively you can download the files from here, extract the package and move the docs/ directory to your ~/.vim directory., _(*2)

If the help is not available after installation, you can try to issue this command in VIM:, _(*3)

:helptags ~/.vimrc/doc

How to use

There is no configuration required for this plugin., _(*4)

:help yii/web/Controller

You should note though, that we use a forward slash (/) instead of a backslash (\) as namespace separator. This was neccessary because when searching for tags, Vim uses regular expressions. So any backslash would indicate the start of a search pattern and you would have to type e.g. yii\\base\\Controller. Autocomplete wouldn't work very well either., _(*5)

How to create the doc files

Note: This is only required if want to build your own flavour of the help files., _(*6)

Start in an empty directory and install the yii2-apidoc-vim package via composer:, _(*7)

composer require mikehaertl\yii2-apidoc-vim dev-master

Now you can run the apidocvim command to extract the docs in Vim format from any source files:, _(*8)

./apidocvim api path/to/some/source/code /path/to/output/dir

You can also use the update-all command to automatically extract the doc files from the currenty yii2 packages installed in vendor/., _(*9)

How to customize the created doc files

You can modify the view files in src/templates/views and adjust the render methods in src/templates/ApiRenderer.php., _(*10)