前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >博客文章和文档迁移到gitbook

博客文章和文档迁移到gitbook

作者头像
owent
发布2018-08-01 15:50:13
5870
发布2018-08-01 15:50:13
举报
文章被收录于专栏:owentowent

使用*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

本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2016-01-15,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
相关产品与服务
持续集成
CODING 持续集成(CODING Continuous Integration,CODING-CI)全面兼容 Jenkins 的持续集成服务,支持 Java、Python、NodeJS 等所有主流语言,并且支持 Docker 镜像的构建。图形化编排,高配集群多 Job 并行构建全面提速您的构建任务。支持主流的 Git 代码仓库,包括 CODING 代码托管、GitHub、GitLab 等。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档