gitbook的安装使用

安装gitbook-cli工具
npm install gitbook-cli -g
初始化一本书

gitbook init会在空项目中创建README.md和SUMMARY.md两个文件:

  • README.md文件是项目的介绍文件。
  • SUMMARY.md是gitbook书籍的目录。
mkdir book
cd book
//然后使用gitbook init来初始化一本书:
gitbook init
本地启动服务编写书籍
gitbook serve

文档打包
gitbook build .	//命令来生成最终的项目

生成电子书

GitBook 可以生成一个网站,但也可以输出内容作为电子书(ePub,Mobi,PDF)

# Generate a PDF file
$ gitbook pdf ./ ./mybook.pdf

# Generate an ePub file
$ gitbook epub ./ ./mybook.epub

# Generate a Mobi file
$ gitbook mobi ./ ./mybook.mobi
项目部署到GitHub Pages

由于gitbook生成的项目跟文档的源码是两个部分,所以可以把文档放到master分支上,部署的网站放到gh-pages 分支。

  • github上创建公共仓库
  • 项目中添加.gitignore文件,忽略# 忽略gitbook生成的项目目录_book
  • 提交代码到github代码仓库上
~ git init
~ git add .
~ git commit -m 'gitbook'
~ git remote add origin https://github.com/smileyqp/smileyqp.git 	//此处替换成自己的git仓库
~ git push -u origin master

为了部署方便,可以创建一个脚本文件deploy.sh,内容如下

#!/usr/bin/env sh

echo '开始执行命令'
# 生成静态文件
echo '执行命令:gitbook build .'
gitbook build .

# 进入生成的文件夹
echo "执行命令:cd ./_book
"
cd ./_book

# 初始化一个仓库,仅仅是做了一个初始化的操作,项目里的文件还没有被跟踪
echo "执行命令:git init
"
git init

# 保存所有的修改
echo "执行命令:git add -A"
git add -A

# 把修改的文件提交
echo "执行命令:commit -m 'deploy'"
git commit -m 'deploy'

# 如果发布到 https://<USERNAME>.github.io/<REPO>
echo "执行命令:git push -f https://github.com/smileyqp/smileyqp.git master:gh-pages"
git push -f https://github.com/smileyqp/smileyqp.git master:gh-pages

# 返回到上一次的工作目录
echo "回到刚才工作目录"
cd -

文件保存后,在终端执行如下命令开始把最终项推送到gh-pages分支:

bash deploy.sh

最后:gitbook简直不要太好用!最近打算用gitbook整理react native项目开发相关的东西!点击gitbook实例查看。

原文地址:https://www.cnblogs.com/smileyqp/p/12675343.html