---

Ⅰ. 插件描述

vim-gitlab is a vim client for GitLab

Ⅱ. 基本信息

创建日期：  2013-11-12 使用用户：  1 Github星：  14 插件作者：  syngan

Ⅲ. 安装方法

使用Vundle管理器安装

在你的.vimrc下添加:

Plugin 'syngan/vim-gitlab'

… 然后在Vim中运行以下命令:

:source %
:PluginInstall

对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。

使用NeoBundle管理器安装

在你的.vimrc下添加:

NeoBundle 'syngan/vim-gitlab'

… 然后在Vim中运行以下命令:

:source %
:NeoBundleInstall

使用VimPlug管理器安装

在你的.vimrc下添加:

Plug 'syngan/vim-gitlab'

… 然后在Vim中运行以下命令:

:source %
:PlugInstall

使用Pathogen管理器安装

在终端中运行以下命令:

cd ~/.vim/bundle
git clone https://github.com/syngan/vim-gitlab

Ⅳ. 文档说明

# vim-gitlab

vim-gitlab is a vim client for GitLab

• c.f. https://github.com/thinca/vim-github
• c.f. http://d.hatena.ne.jp/thinca/20100701/1277994373

GitLab を vim から参照・変更するプラグインです.

• 現状 issues のみに対応

• GitLab は 6-1-stable 以下でも動作しますが Web ブラウザで表示した時の issue #x の数字と, gitlab.vim で表示される数値が一致しません.
  (API が対応していないため)

  • c.f. https://github.com/gitlabhq/gitlabhq/commit/02693b72a4240a9d94246e590775a66eb48c55ed
  • https://github.com/gitlabhq/gitlabhq/tree/master/doc/api

id vs iid

When you work with API you may notice two similar fields in api entites: id and iid.
The main difference between them is scope. Example:

Issue
id: 46
iid: 5

• id - is uniq across all Issues table. It used for any api calls.
• iid - is uniq only in scope of single project. When you browse issues or merge requests with Web UI - you see iid.

So if you want to get issue with api you use http://host/api/v3/.../issues/:id.json
But when you want to create a link to web page - use http:://host/project/issues/:iid.json

• thinca さんの vim-github を元にコピー＆修正で作成しています.

Install

NeoBundleLazy 'syngan/vim-gitlab', {
    \ 'autoload' : {
    \ 'commands' : 'Gitlab'}}

• required

  • GitLab 6-2-stable
  • +python or curl or wget (vital.vim の Web.HTTP に依存)

Config

以下のように変数 g:gitlab_config を定義します.

• __name__ は任意に設定します.

• url はアクセスする GitLab の URL (必須)

  • e.g., https://hoge.com/apps/gitlab/
  • e.g., http://localhost:1192/
• user/email はログイン ID (必須)
• password はパスワード (任意)

g:gitlab_config['__name__'] = {
\    'url' : 'http://localhost/',
\    'user' : '',
\    'email' : 'admin@local.host',
\    'password' : 'optional',
\}

Usage

下記のようにして, g:gitlab_config で定義した __name__ にアクセスします.
root/sandbox はリポジトリ名.

:Gitlab __name__ issues root/sandbox

Screenshot

issues list

show issue #2

add comment

show issues #2