69 lines
2.4 KiB
Markdown
69 lines
2.4 KiB
Markdown
vim-wakatime
|
|
============
|
|
|
|
Quantify your coding inside Vim.
|
|
|
|
|
|
Installation
|
|
------------
|
|
|
|
1. Install [Vundle](https://github.com/gmarik/vundle), the Vim plugin manager.
|
|
|
|
2. Using [Vundle](https://github.com/gmarik/vundle):<br />
|
|
`echo "Bundle 'wakatime/vim-wakatime'" >> ~/.vimrc && vim +BundleInstall`
|
|
|
|
or using [Pathogen](https://github.com/tpope/vim-pathogen):<br />
|
|
`cd ~/.vim/bundle && git clone git://github.com/wakatime/vim-wakatime.git`
|
|
|
|
3. Enter your [api key](https://wakatime.com/settings#apikey), then press `enter`.
|
|
|
|
4. Use Vim and your coding activity will be displayed on your [WakaTime dashboard](https://wakatime.com).
|
|
|
|
Note: WakaTime depends on [Python](http://www.python.org/getit/) being installed to work correctly.
|
|
|
|
|
|
Screen Shots
|
|
------------
|
|
|
|
|
|
|
|
|
|
Configuring
|
|
-----------
|
|
|
|
To use a custom python binary:
|
|
|
|
let g:wakatime_PythonBinary = '/usr/bin/python'
|
|
|
|
The default is to use `python` from your system PATH.
|
|
|
|
WakaTime plugins share a common config file `~/.wakatime.cfg` located in your user home directory with [these options][wakatime-cli-config] available.
|
|
|
|
|
|
Troubleshooting
|
|
---------------
|
|
|
|
Run `:WakaTimeDebugEnable` in Vim then run this Terminal command:
|
|
|
|
`tail -f ~/.wakatime.log`
|
|
|
|
Enabling Debug Mode writes Vim Script errors to your Vim Status Bar and tells [wakatime-cli][wakatime-cli] to write verbose logs to `$WAKATIME_HOME/.wakatime.log`.
|
|
|
|
Debug mode can make it hard to find the real error because of all the extra logging, so also try disabling Debug Mode while tailing `~/.wakatime.log` and editing files in Vim.
|
|
With Debug Mode enabled, the plugin sends data synchronously so disable it when finished debugging with `:WakaTimeDebugDisable`.
|
|
|
|
The [How to Debug Plugins][how to debug] guide shows how to check when coding activity was last received from Vim use the [User Agents API][user agents api].
|
|
For more general troubleshooting info, see the [wakatime-cli Troubleshooting Section][wakatime-cli-help].
|
|
|
|
|
|
Uninstalling
|
|
------------
|
|
|
|
Remove `Bundle 'wakatime/vim-wakatime'` from your `.vimrc` file, then delete your `~/.wakatime.cfg` config file.
|
|
|
|
|
|
[wakatime-cli]: https://github.com/wakatime/wakatime
|
|
[wakatime-cli-config]: https://github.com/wakatime/wakatime#configuring
|
|
[wakatime-cli-help]: https://github.com/wakatime/wakatime#troubleshooting
|
|
[how to debug]: https://wakatime.com/faq#debug-plugins
|
|
[user agents api]: https://wakatime.com/developers#user_agents
|