很多人之前从来没有接触过gitbook,先上东西,看看做出来的结果是什么样的:
为什么要使用gitbook?
使用gitbook结合github提供的pages功能,可以让你非常方便的搭建起自己的知识管理平台,你可以把你日常的读书笔记、工作总结、方法论、以及任何有被记录价值的信息,记录在上面。
然后,你可以随时随地通过网页来访问这些内容,因为人的精力都是有限的,学过一次的东西就不需要从头再来,gitbook可以极大地节省信息检索的时间,同时可以让自身有一个积累。
安装gitbook所需组件
首先需要下载node.js并安装,因为gitbook需要依赖node.js的环境,这个可以直接在官网下载:
然后一路点点点,按照默认方式安装即可。
第二步:安装gitbook命令行工具,这一步是让你可以操作gitbook的前提条件,在cmd里面输入:
npm install -g gitbook-cli
第三步:查看是否安装完成,使用命令行:
gitbook -V
连接github和gitbook
第一:把刚才新建的项目clone到本地,然后在这个文件夹下面创建gitbook,使用命令:
$ gitbook init
这时候会生成下面两个文件:
├── README.md└── SUMMARY.md
接着就可以启动gitbook,命令如下:
$ gitbook serve
启动之后就可以在浏览器中查看了:
如果你在上面这个连接当中看到自己的gitbook启动了,那就说明已经安装成功了,但这仅仅实在本地可以打开,接下来,还需要把这个文件推到线上,这样就可以在任何地方都可以看到了:
git add .git commit -m 'init' git push -u origin master
$ git subtree push --prefix=_book origin gh-pages
如果没问题的话,就可以在下面的链接访问你自己的项目了:
https://.github.io//
其中,是你的github用户名,是项目名称,打开URL即可访问推到线上的gitbook。
更多细节和扩展功能欢迎大家一起讨论。
领取专属 10元无门槛券
私享最新 技术干货