版权声明:本文为博主原创文章,未经博主允许不得转载。 https://blog.csdn.net/momDIY/article/details/84205316
一、何为gitbook?
通过git与markdown构建书籍的开源工具,可转换为PDF,ePub,mobi或html等格式。其中git非必须,完全可以使用其他的代码提交工具代替。
二、上手使用
1.前提
- 安装好node环境
- 了解git命令
- 了解markdown语法
2.安装依赖
$ npm install -g gitbook
3.项目初始化
路径切换到你要创建项目的地方,输入以下命令回车
$ gitbook init
此时你会发现项目中多了两个文件,README.md
与SUMMARY.md
。其中SUMMARY.md
为项目目录,通过该目录可跳转到不同文章;README.md
为项目介绍,一般为gitbook书籍的第一章。
4.打包
这一步可将一个个markdown文件转化为一个直接由浏览器打开的html项目,样式就如同我们曾经见过的gitbook书籍。
$ gitbook build
执行完该命令项目中会多出一个_book
的文件夹,其中存放的就是打包生成的项目代码(包含html、css、js及引用到的图片)。
三、gitbook命令行
1. gitbook init
gitbook项目初始化。
2. gitbook serve
启动gitbook项目并提供http://localhost:4000
为浏览器浏览链接。
3. gitbook build [path]
构建gitbook项目,构建路径可省略,默认为_book
四、脚手架
需要快速搭建gitbook项目时推荐使用。通过以下命令即可快速安装。
$ npm install -g gitbook-cli