Ⅰ. 插件描述
Plugin for dealing with source files under various VCS controlⅡ. 基本信息
|
Ⅲ. 安装方法
使用Vundle管理器安装
在你的.vimrc下添加:Plugin '/aurum':source %
:PluginInstall对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。
使用NeoBundle管理器安装
在你的.vimrc下添加:NeoBundle '/aurum':source %
:NeoBundleInstall使用VimPlug管理器安装
在你的.vimrc下添加:Plug '/aurum':source %
:PlugInstall使用Pathogen管理器安装
在终端中运行以下命令:cd ~/.vim/bundle
git clone https://github.com/vim-scripts/aurumⅣ. 文档说明
This plugin provides a vim <--> VCS (currently mercurial, git and subversion)
integration for your projects. Features:
- Partially committing changes (:AuRecord [1]).
- Viewing file state at particular revision (aurum://file [2], :AuFile [3]).
- Viewing uncommited changes in a vimdiff [4], as well as changes between
specific revisions (:AuVimDiff [5]). It is also possible to open multiple
tabs with all changes to all files viewed as side-by-side diffs.
- Viewing revisions log (:AuLog [6]). Output is highly customizable.
- Viewing working directory status (:AuStatus [7]).
- Commiting changes (:AuCommit [8]), commit messages are remembered in case of
rollback (g:aurum_remembermsg [9]).
- Obtaining various URL’s out of remote repository URL (like URL of the HTML
version of the current file with URL fragment pointing to the current line
attached: useful for sharing) (:AuHyperlink [10]). For mercurial it also
supports git and subversion revisions (in case you are using hg-git and
hgsubversion respectively).
- aurum#changeset() [11], aurum#repository() [12] and aurum#status() [13] functions
that are to be used from modeline.
- Frontends for various other VCS commands.
Most commands can be reached with a set of mappings (see aurum-mappings [14]),
all mappings are customizable.
Plugin’s mercurial driver is able to use mercurial python API as well as its
CLI, but remember that the former is much slower and less tested. In order to
use mercurial python API you must have vim compiled with +python [15] (mercurial
currently does not support python 3) and have mercurial in python’s sys.path
(note: on windows msi installer is not adding mercurial to sys.path, so you
won’t be able to use its python API).
Plugin requires some additional plugins:
- frawor (https://bitbucket.org/ZyX_I/frawor)
- (optional) ansi_esc_echo (https://bitbucket.org/ZyX_I/ansi_esc_echo)
- (optional) one of
- Command-T (vimscript #3025)
- ctrlp (vimscript #3736)
- FuzzyFinder (vimscript #1984)
- unite (vimscript #3396)
- ku (vimscript #2337)
- tlib (vimscript #1863)
for :AuFile [3] prompt option and a number of OpenAny/AnnotateAny mappings.
(with their dependencies).
Note: aurum supports VAM (https://github.com/MarcWeber/vim-addon-manager). It
is prefered that you use it for aurum installation.
Project page: https://bitbucket.org/ZyX_I/aurum
Documentation: http://vimpluginloader.sourceforge.net/doc/aurum.txt.html
[1] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#.3aAuRecord
[2] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#aurum.3a.2f.2ffile
[3] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#.3aAuFile
[4] http://vimcommunity.bitbucket.org/doc/diff.txt.html#vimdiff
[5] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#.3aAuVimDiff
[6] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#.3aAuLog
[7] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#.3aAuStatus
[8] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#.3aAuCommit
[9] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#g.3aaurum_remembermsg
[10] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#.3aAuHyperlink
[11] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#aurum.23changeset.28.29
[12] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#aurum.23repository.28.29
[13] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#aurum.23status.28.29
[14] http://vimcommunity.bitbucket.org/doc/aurum.txt.html#aurum-mappings
[15] http://vimcommunity.bitbucket.org/doc/various.txt.html#.2bpython