安装
-
安装Gist插件: Package Control中Install搜索Gist, 点击安装即可. 否则, Sublime中打开Package文件夹,
git clone git://github.com/condemil/Gist即可. -
配置Token:
- Preference->Package Settings->Gist 找到 Setting Default
- 先试试保存打开的Gist.sublime-settings文件, 如果不能保存, Preference-> Browse Packages, 进去Package文件夹后新建一个
Gist文件夹. 重新保存刚才的Gist.sublime-settings - Setting->Personal Access Tokens, 然后Generate New Token, 名字随便起, 下面只勾选一个Gist. 完成后, 显示一个串, 如33ab6f4394f86a0118893cf87fd3b466b20dbas9b, 复制该串. 特别注意该串只会出现一次! 若刷新页面就看不到了, 要把之前的删掉重建..赶紧复制并且不要乱刷新页面..
- 将该串填写到
"token": "",里. 测试工具栏 Tools->Gist->Open Gist.. 如果能显示出Gist里的项目即成功, 报错则有问题罗.
除了token配置比较关键, 一些常用配置包括:
- “gist_prefix”: “” 可以限定只显示Gist以特定开头的库.
- “gist_tag”: “tag” 可以限定只显示有特定tag的库
- “save-update-hook”: true 可以保存文件时直接更新Gist. 否则会提示保存到本地.
缺省快捷键(可以在Preference->Package Settings->Gist->Key Bindings - Default找到)
{ "keys": ["super+k", "super+i"], "command": "gist" },
{ "keys": ["super+k", "super+p"], "command": "gist_private" },
{ "keys": ["super+k", "super+s"], "command": "gist_update_file" },
{ "keys": ["super+k", "super+o"], "command": "gist_list" },
{ "keys": ["super+k", "super+["], "command": "insert_gist_list" },
{ "keys": ["super+k", "super+]"], "command": "gist_add_file" }
Window版就是相应super改为ctrl.
使用
可以通过命令面板(Cmd+shift+P) 输入Gist, 获取Gist插件功能. 原理是编辑器中的文件和Gist中对应起来, 并对应上相应的Gist. 随后可以对该Gist进行修改, 或者对文件进行修改. 如果是本地文件时, cmd+s 保存文件还可以update到Gist上.
如果本地打开的文件绑定到Gist后, 网上删掉了对应的Gist(可以没有对应文件, 保存会update上去), cmd+s 会报错 (Gist: Github returned error 404: Not Found), 此时关闭文件再打开即可(恢复没有绑定Gist).
创建新Gist (cmd+k, cmd+i/p)
可以使用快捷键直接将文件用于创建新Gist, 也可以选择一段代码后右键Create Gist. 可以创建公共Gist或者私有Gist.
- 使用
Super k, Super i会以当前文件/选择创建新公共库, 会提示Gist Description(Optional), Gist File Name(Optional). 前者是Gist描述, 后者是创建的文件名. 可以Ese取消. - 使用
Super k, Super p或右键选择会以当前文件/选择创建新私有库.
Add file to Gist (cmd+k, cmd+])
将当前文件插入到指定的Gist中. 常用. 只能文件在没绑定gist前使用.
Insert Gist (cmd+k, cmd+[)
将Gist对应的内容黏贴到当前文件中. 非常方便的真正代码片段功能!
Open Gist (cmd+k, cmd+o)
可以通过选择来打开指定Gist, 会打开相应的文件! 文件并绑定gist信息, 可以直接保存来update.
Embed as script
打开选择一个Gist, 将整个Gist(所以文件)以HTML script标签返回. 适合写网页中套用JS脚本.
Update File (cmd+k, cmd+s)
保存文件修改到Gist中.(绑定gist后能用)
Rename File
修改gist中该文件的名字.(绑定gist后能用)
Delete Gist
删除绑定的整个Gist.(绑定gist后能用)
Change Gist Description
改变Gist的描述.(绑定gist后能用)
Copy Gist Url
只能获得其网上地址.(绑定gist后能用)
Open Gist in browser
将在浏览器打开当期编辑文件对应的Gist.(绑定gist后能用)
就这么多啦, enjoy~