
https://www.gitbook.com
昨天
@robertyan 分享了将steemit上的文章镜像到github的方法,非常感谢还帮我整理了一下(https://steemblog.github.io/@lemooljiang ),虽然还有些小缺点,离实用还有点距离,不过做为备份,或是分享给国内的朋友看看还是方便多了。
当然,今天我要说的是另外一个好用的工具--gitbook。现在的工具越来越好用了!平时学习做笔记多了,文件也多起来了,找起来可能就不是很方便了。偶然间获得的工具gitbook可以很方便地将.md文件转成电子书,真是太方便了!
使用起来超简单的。只有三个命令:
- 安装,npm install gitbook-cli -g
- 初始化,gitbook init
初始化书籍目录,会自动生成两个文件(README.md 和 SUMMARY.md)。README.md 是对书籍的简单介绍, SUMMARY.md 是书籍的目录结构。因为这步有时很慢,所以可以将初步生成的这两个文件(README.md 和 SUMMARY.md )打包成模板,以后要用的话直接拷过去即可!
- 编译和预览书籍,gitbook serve
这步可以启动本地的服务器,可以直接访问了,http://localhost:4000 。同时也会打包生成html静态文件(—book),这样就可以像一个网站一样使用了。
html不能跳转的解决办法
gitbook直接打包生成,会有个小问题:页面之间不能跳转。这是由于点击事件被js代码禁用,所以点击没有反应,但是如果右键,在新窗口/新标签页打开的话是可以跳转的。解决办法如下:
- 找到目录下的theme.js文件
- 找到下面的代码: 将 if(m) 改成 if(false)
由于代码是压缩后的,会没有空格,搜索的时候可以直接搜索: if(m)for(n.handler&&
网络研习社系列文章:
@lemooljiang #network-institute