Sublime Gitlab Integrate

这是一个Sublime Text 2/3插件，它将各种Gitlab功能（目前主要处理问题管理）集成到编辑器中。

安装

有三种安装方式

• 已安装Package Control

  1. (推荐) 在“安装包”菜单中搜索“Gitlab Integrate”，然后选择它

• 没有安装Package Control

  1. 将此仓库克隆到 [你的Sumblime安装目录]/Packages/
  2. 将此仓库复制/下载到任何位置，然后将文件复制到 [你的Sublime安装目录]/Packages/GitlabIntegrate

安装完成后，可以使用 cmd+shift+x（Mac）或 ctrl+shift+x（Win/Linux）激活插件。

配置

在使用GitlabIntegrate之前，您应该配置用户设置文件。如果您不这样做，将出现介绍文档并提示您这么做。用户设置可以通过以下三种方式找到（如果文件不存在，您可能需要创建该文件）

1. 菜单中

偏好设置 -> 软件包设置 -> Gitlab Integrate -> 设置 - 用户

1. 菜单中

工具 -> Gitlab Integrate -> 进入用户设置

1. 文件浏览器中

[sublime安装目录]/Packages/User/GitlabIntegrate.sublime-settings

然后，将以下文本复制粘贴到文件中（替换任何现有文本）。确保编辑项目主机和用户令牌字段

{
    //The project host
    "project_host":"",

    //Your user token for GitLab, found in [host]/profile/account 
    "user_token":"",    

    //Displays the new installation window
    "display_intro":false,

    //The name of the tab when using Edit Issue In Tab (note: if you open another tab with this name, weird things might happen)
    "edit_issue_in_tab_name": "[GLI]: Editing Issue",

    //Suppresses output of closed issues for the Select Issue command
    "hide_closed_issues":false,

    //Appears before all GitlabIntegrate outputs in the console and status bar
    "output_prefix":"[GLI]:",

    /*
    The default project ID.
    This can be found by running GitlabIntegrate's "Get Project IDs" command after configuring 
    your host and user_token. All the projects you have access to should be listed with their IDs.
    */
    "project_id": 0    

    //set to false if you want to use HTTPS with a self-signed certificate
    "verify_ssl":true
}

使用方法

GitlabIntegrate功能可以通过菜单（工具 -> Gitlab Integrate）、快捷键（Windows/Linux上的Ctrl+Shift+X，Mac上的Cmd+Shift+X）或命令面板（默认：Mac上的Cmd+Shift+P，Windows/Linux上的Ctrl+Shift+P）访问。命令面板中的所有GLI命令都以“GLI:”开头。

在标签页中编辑问题：此模式在单独的视图中打开选定的问题以进行编辑。要保存更改，只需关闭标签页即可。

命令参数：通过状态/输入栏输入命令时，参数必须以逗号分隔。所有可能的参数都在输入框左侧括号内列出。方括号（[]）中的参数是可选的。

可选参数和关键字参数：可选参数可以通过在参数值前加上其名称和一个未转义的等号（E.g.，要创建一个名为“test_issue”的新问题并将其分配给用户“robert”，无需指定描述，请在“创建问题”输入框中键入test_issue, assign_to=username）。如果没有指定关键字，则按从左到右的顺序处理参数。除了标签外，每个参数都在提示中以关键字的形式表示。

关于参数的特殊说明:

• 标签:

  • 标签的关键字是labels
  • 如果要指定多个标签，必须引用整个列表（例如，对于针对问题编号#10的添加标签到问题命令，您将键入：10, "first_label, second_label"或10, labels="first_label, second_label"）
  • 如果您只指定一个标签，则无需引用。
  • 在编辑问题命令中指定标签将替换所有当前标签。明确指定无标签（例如labels=,或labels="",）将从问题中删除所有标签。

• Assign_to：用户可以通过用户名或用户ID（如果知道他们的ID）来识别。GLI将自动检测您使用了哪种方法。

• 转义字符：在标题/描述中的逗号（,）、等号（=）和双引号（"）必须使用反斜杠（\）转义。只有在编辑问题查看模式下才必须转义双引号。

修改

在修改GitlabIntegrate之前，用户应阅读修改说明.md。