通过sublime+gist管理碎片知识

碎片化时代,更加凸显灵感、代码等碎片管理的重要性,尤其是如何加快搜索速度

前言

在我们进入到碎片化时代以后,便利贴除了收集我们的碎片知识、灵感、临时工作以外,在搜索方面相比较电子网络工具而言,会稍显不足。

一开始,从工作中需要,我对于碎片知识更多的局限在“代码”,而使用代码片段管理的时候,工具蛮多的,有例如Dash、Xcode等。

而这些都有一个不便的地方就是,代码(碎片知识笔记)跟随软件一体化,无法单独实现管理。

而今天想要介绍的Gist则是一个共享平台,Sublime Text则是在代码开发过程中常用的一个记事本,两者一结合,在通过网盘(由于我使用的平台都是Mac,则直接使用iCloudDrive管理,若有跨平台的,建议可以使用例如Dropbox等)进行本地管理和跨平台使用。

可能还存在更好的工具,不过对个人而言,使用gist最大的好处是版本管理和搜索,这也正是我所需要的。

一、构建思路

基于代码使用习惯,为了减少编码过程和知识片段的频繁切换,我选择使用Sublime Text 3 + Gist形成个人的碎片知识管理搜索平台
整体流程类似如下:

Gist碎片知识管理流程.png

二、ST+Gist工具准备

(1)Github账户准备

1. 注册Github账户

GistGithub的一款代码管理平台,只有拥有github账户,自动拥有gist功能。

2. Gist的Token准备

由于Gist在提供给第三方工具使用的时候,需要进行权限校验,使用github账户,同时需要提供gist自动生成的token指令。
token生成器非常简单,主要有两种方式

  • 方式一:在网站上获取
    路径:Setting -> Developer settings -> Personal access tokens -> Generate new token
    Generate new token

填写Token description,勾选开通的服务,勾选gist,点击Generate token后Copy Token


Token description

此时,将生成的一串字符串记录下来即可


Copy Token
  • 方式二:通过命令行获取
curl -v -u username -X POST https://api.github.com/authorizations --data {"\"scopes\":[\"gist\"], \"note\": \"SublimeText 2/3 Gist plugin\”}”

其中 username 替换成你自己的github的用户名即可

(2)Sublime Text软件准备

1. 软件下载安装

mac和windows的操作软件不同,在官网上下载即可,这个软件是免费的。

2. 安装Package Control

简单的一个语句,参考官网说明

3. 安装Gist插件

Mac上使用Cmd+Shift+P —输入—> PCIP(或者Install Package) —输入—> Gist

4. 配置Gist插件

将第一步准备好的Token配置到Gist配置文件内即可
操作步骤:从菜单中的 Preferences -> Package Settings -> Gist -> Settings - User 来打开该设置文件


设置路径

写入如下内容,保存即可:

{"token": "6b573d47a20c6dca10156a0e71fb163c410d41d4,}

(3)建立碎片项目的文件目录结构

Sublime Text有一个很好的功能,就是刻意将不在一起的目录组合成一个项目
通过Project ->Add Folder to Project即可完成目录的添加

Add Folder to Project

添加某一个文件目录后,SublimeText的项目管理栏会显示类似如下


项目管理栏

值此,完成了这个初期的准备工作。当然,至于碎片下的文件目录如何管理,则是另一个关键问题,在自己收集不同的片段后可以可以进行文件归并和调整,形成个人的碎片知识管理体系。

三、知识片段管理

(1)新建文件

一般而言,每一个单独的碎片内容,我会单独建立一个文件来保存。

在Sublime Text新建空白文档,并保存文件(习惯性动作,避免临时文件内容丢失),输入需要保存的内容信息,通过命令框(⌘+⇧+P)调用 Gist:Creat Public Gist 建立 Gist

由于 Gist 不提供分类(建议在本地的项目上通过文件夹区分分类即可),所以在输入 Description 时,添加固定的便签识别,譬如“个人成长”、“目标管理”等、代码的话建议使用“语言:分类”,例如“Python:Socket”等

(2)搜索、修改与提交

通过命令框(⌘+⇧+P)调用 Gist:Open Gist,即可启用搜索功能,通过标签(就是第一步创建的时候填入的描述信息),可以找到对应的gist内容,在本地修改后,同样通过命令框(⌘+⇧+P)调用Update Gist,完成知识片段的提交。

当然如果按照本地搭建数据的时候,就可以直接打开本地文件进行修改,修改后提交即可。

本地文件的搜索可以通过Alfred(Mac版本),windows可以通过google桌面功能。

(3)利用官网功能

Gist是Github的一个基本功能,可以在官网上查找他人的Gist,然后Fork到本地,充分利用网络资源,这是一项不错的技能。

(4)SublimeText快捷键说明

在SublimeTest编辑Ctrl+Shift+P,输入gist,便看到了以下几个操作选项:

  • Create Private Gist,Ctrl+K, Ctrl+P
    创建一个私有的代码片段

  • Create Public Gist,Ctrl+K, Ctrl+I
    创建一个公有的代码片段

  • Add File to Gist
    以文件方式将文件内容添加到Gist

  • Insert Gist,Ctrl+K, Ctrl+[
    在当前编辑文件中,插入选择的代码片段

  • Open Gist,Ctrl+K, Ctrl+O
    打开Gist网站上的代码片段,编辑以后,Ctrl+Shift+P使用Update Gist命令对代码片段进行更新

  • Update Gist
    和Open Gist 配合使用,用于更新代码片段

  • Delete Gist
    和Open Gist 配合使用,用于删除代码片段

  • Rename Gist
    和Open Gist 配合使用,用于更改文件名

  • Embed As Script
    作为脚本嵌入

  • Change Gist Description
    修改当前Gist的描述信息

  • Copy Gist URL
    拷贝当前gist对应的gist网站的URL路径

  • Open Gist in Browser
    在浏览器打开当前编辑的Gist信息

四、 Gist工具推荐

为啥要推荐软件呢,很简单,软件会简化流程,以下软体,按需使用。

GIST官网
  • Mac
    • Gisto
Gisto
  • Windows
    • Gistbox


      Gistbox

结语

愿工具若飞翔的翅膀一般,助我们更加优雅的管理碎片知识,让我们在碎片时代更加聚合,更加系统的翱翔。

教程相关信息

  • Gist说明:Gist需要飞出去看 FXXX Q
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,324评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,303评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,192评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,555评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,569评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,566评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,927评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,583评论 0 257
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,827评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,590评论 2 320
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,669评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,365评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,941评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,928评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,159评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,880评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,399评论 2 342

推荐阅读更多精彩内容