在gitbook中添加代码链接
在gitbook中显示代码块很容易,直接用markdown编写就行。
这里介绍另一中显示代码块的方法————嵌入gist代码链接。
gist
GitHubGist是一个代码片段分享的服务。使用GitHubGist,你可以上传和分享自己的代码,或者搜索、评论或下载别人的代码,另外每个gist都是一个git,也就是说自带版本控制功能。更多的说明详见官方帮助文档。
本文主要介绍如何在gitbook中嵌入gist代码。
gitbook中嵌入gist代码
- 注册gist账号(可以使用GitHub的账号,也可以新建账号)
- 上传代码片段(也可以在gist中直接编辑,下面以我上传的代码为例
- 在右下方找到
Embed URL
(如下图), 复制里面的地址 - 在.md文档中想要嵌入代码块的地方粘贴
Embed URL
即可 - 最后编译出来的效果如下
- 点击代码下方的文件名,可以链接到GitHubGist上的代码网址,在这里可以对代码进行评论(评论可以使用markdown)
体验
用markdown展示代码块已经够方便了,为什么还要用嵌入gist代码的方式呢。于我来说,原因有以下几点:
- 便于储存代码块。将代码存在一个地方比分散在不同文章里更利于管理。
- 便于评论。Gitbook中添加Disqus插件可以实现评论功能,但不方便单独对文章中的代码进行评论,另外,在disqus评论中要用额外的html tag来实现代码区显示。
- 便于版本控制。可以查看代码的修改历史,看这个代码是怎么改进的。
ps: sublime text 2/3有gist的插件,可以很方便地上传代码到gist上。 pps:更多关于gist的好处可以看这个知乎问答