Ⅰ. 插件描述
Vim plugin for Phabricator and ArcanistⅡ. 基本信息
|
Ⅲ. 安装方法
使用Vundle管理器安装
在你的.vimrc下添加:Plugin 'jparise/vim-phabricator'
… 然后在Vim中运行以下命令:
:source %
:PluginInstall
对于Vundle版本 < 0.10.2,请用上面的Bundle替换Plugin。
使用NeoBundle管理器安装
在你的.vimrc下添加:NeoBundle 'jparise/vim-phabricator'
… 然后在Vim中运行以下命令:
:source %
:NeoBundleInstall
使用VimPlug管理器安装
在你的.vimrc下添加:Plug 'jparise/vim-phabricator'
… 然后在Vim中运行以下命令:
:source %
:PlugInstall
使用Pathogen管理器安装
在终端中运行以下命令:cd ~/.vim/bundle
git clone https://github.com/jparise/vim-phabricator
Ⅳ. 文档说明
# Phabricator Plugin for Vim
This Vim plugin provides features for interacting with
Phabricator-based repositories. It
builds upon the foundational git functionality provided by [Fugitive][].
- Syntax highlighting for Arcanist templates and configuration files
:Gbrowsesupport for browsing Phabricator URLs from the current buffer- Completion support for users and projects in Arcanist diff templates using
<C-X><C-O>(requires [curl][] and a Conduit API
token)
Installation
Using vim-plug
- Add
Plug 'jparise/vim-phabricator'to~/.vimrc vim +PluginInstall +qall
Using Vim Packages
mkdir -p ~/.vim/pack/jparise/start
cd ~/.vim/pack/jparise/start
git clone https://github.com/jparise/vim-phabricator.git phabricator
vim -u NONE -c "helptags phabricator/doc" -c qConfiguration
g:phabricator_hosts
This plugin automatically recognizes Phabricator repositories served from
hosts named phabricator (eg. phabricator.example.com).
This variable lists additional hosts that should also be considered
Phabricator hosts.
g:phabricator_api_token
Phabricator's Conduit API is used to generate candidates for user
and project completion. These API calls require an access token which can be
generated in Phabricator's per-user Settings interface. For example:
https://phabricator.example.com/settings/user/USERNAME/page/apitokens/
The plugin will first attempt to read the per-host API token from the user's~/.arcrc configuration file. For example:
{
"hosts": {
"https://secure.phabricator.com/api/": {
"token": "api-secrettokencharacters"
}
}
}If an API token can not be read from the ~/.arcrc file for the current
Phabricator host, the value stored in g:phabricator_api_token will be used.
License
This code is released under the terms of the MIT license. See LICENSE for
details.
Similar Projects
- arcanist.vim provides syntax
highlighting for Arcanist templates and configuration files. - phabrowser.vim provides a Fugitive
browse handler for Phabricator. - rhubarb.vim provides similar features
for GitHub-based repositories. - vscode-phabricator
provides similar Phabricator features for Visual Studio Code.