事先准备:
gitbook基于node.js所以首先安装node.js
下载地址:https://nodejs.org/en/download/
然后安装gitbook
进入命令行: $ npm install -g gitbook-cli
Gitbook安装成功后:
就可以开始使用gitbook了:
执行完后,你会看到多了两个文件 —— README.md 和 SUMMARY.md,它们的作用如下:
README.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置
image.png
编辑 SUMMARY.md 文件
然后创建对应的目录和md文件
自己建立.md文档然后与summary.md目录结构对应
接着我们在终端执行 gitbook serve 来预览这本书籍,执行命令后会对 Markdown 格式的文档进行转换,默认转换为 html 格式,最后提示 “Serving book on http://localhost:4000”
游览器访问http://localhost:4000效果如下:
image.png
serve 命令也可以指定端口:gitbook serve --port 2333
如果想发布到服务器,点击发布到Gitbook
image.png
会重定向进入官网: https://www.gitbook.com/
注册账号,或者使用GitHub直接登录(注册登录要梯子的)
然后一步步按照提示就可以使用了