博客文章和文档迁移到gitbook

使用*Markdown*写blog已经很久了,近期接触并且看了下流传已久的gitbook平台,感觉做得确实不错。、

之前写blog的时候一直用得是stackedit,是因为stackedit的对*Markdown*做了很多扩展,功能很强大,有自动目录、流程图、时序图等等,然后可以浏览器直接开很方便。但实际上这些功能写出的东西虽然不错,但是放到比如github上的时候,github不支持。目前大多数平台对*Mardown*的扩展都只是到了和github差不多的地步,没有到stackedit的程度。这也导致同样写得东西,复制到github或者其他的平台的时候还得过一遍样式,比较麻烦。而且这些扩展的功能也用得不太多。另外stackedit时不时被墙然后访问很不稳定也是挺麻烦的一件事儿。

再来说这个gitbook,看中他是觉得它做了一个可持续集成的功能。就是github *push*完以后可以通知gitbook然后让gitbook自动构建文档内容。这点和比如jenkinstravis等等的CI系统很像。然后支持构建成pdf、epub(开源电子书格式)、mobi(kindle电子书格式)和在线书籍。然后版式也挺漂亮,还支持模板,引用等等,感觉确实蛮适合出版发行的。虽然目前为止*Markdown*的功能丰富程度比起Latex还差不少,但是上手难度也比Latex低不少。还是非常有潜力的,而且gitbook支持用javascript写得插件,以后变数也可以很多。

所以我决定也尝尝鲜,首先是吧blog里的文章记录转移过来,然后后面的开源项目的wiki或者文档也用这玩意构建。因为我用*Markdown*写博文的时候本来就备份了一份在github,所以有现成的仓库,然后把目录结构和配置调整成gitbook所支持的就可以了。话说好像已经很多国内的文档和开源书籍用这个生成了。

然后主要是之前很多文章里用到了一些stackedit的扩展功能比如说在stackedit里表示目录树。像这些功能gitbook里有插件提供一样的功能,但是语法不太一样。反正是博文又不是出书也不是文档,我就不更新了。实际上对阅读影响也不大,而且在我的blog里内容是正常的。

尝试一段时间熟悉了以后可以在这上面再去写各种文档(其实大致看了一下很简单内容也不多)。顺便吐槽一下现在5.0beta的gitbook的编辑器真不好用,虽然很好看,但是还没4.0好用,拼写检查不支持中文导致茫茫多红线,不识别英文和其他UTF-8导致不能双击选中英文单词。

最后顺带测试一下导入License

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏HaHack

化繁为简的企业级Git管理实战(三):分支管理策略

1244
来自专栏FreeBuf

域名劫持事件发生后的应急响应策略

Morphus实验室讲述了这样一个故事,在某周六的早上,你作为一家大公司的CSO(首席安全官),突然开始收到了雪片般飞来的消息。他们告诉你有游客在访问了你公司的...

2396
来自专栏Java帮帮-微信公众号-技术文章全总结

研究微信即时通讯的服务端、朋友圈、红包、推送等方案

即时通信:前端获得消息发送到服务端,服务端处理后通过推送的方式,给到接收方;Android使用长连机制,联通网络长连十几分钟,电信仅五六分钟,因此需要根据测试的...

3973
来自专栏程序员的SOD蜜

闲话权限系统的设计

一、权限的本质 权限管理,首先要理清权限的本质:权限就是对受保护资源的有限许可访问。 理解了权限的本质,就好谈权限的管理了。 权限就是对受保护资源的有限许可访问...

3818
来自专栏杨逸轩 ' sBlog

如何建立个人博客?

8439
来自专栏java思维导图

为什么前后端分离了,你比从前更痛苦?

前后端分离早已经不是新闻,当真正分离之后确遇到了更多问题。要想解决现在的痛,就要知道痛的原因:

722
来自专栏顶级程序员

微软一脸懵逼:32TB的Win10源码泄露!

综合自:36氪、 Solidot、快科技、程序猿等媒体 黑客泄露微软 Win 10 大量源代码,数据超过 32 TB 据 theregister 报道,已经有多...

4467
来自专栏木子昭的博客

"杀手级"抓包软件wireshark入门wireshark是什么最基本的过滤规则

wireshark是什么 ? wireshark_logo wireshark是一款抓取数据包的软件,通过它可以看到局域网内的通讯信息 在使用交换机组建局域网的...

3957
来自专栏成猿之路

为什么前后端分离了,你比从前更痛苦?

前后端分离早已经不是新闻,当真正分离之后确遇到了更多问题。要想解决现在的痛,就要知道痛的原因:

1023
来自专栏开源项目

本周新晋优秀开源项目榜单 | 码云周刊第 76 期

1563

扫码关注云+社区

领取腾讯云代金券