gitbook快速入门及命令行命令

版权声明:本文为博主原创文章,未经博主允许不得转载。 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.mdSUMMARY.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

github项目地址

END

猜你喜欢

转载自blog.csdn.net/momDIY/article/details/84205316