分享每一天-结合 GitHub Pages 使用 GitBook，打造自己的在线电子书

结合 GitHub Pages 使用 GitBook，打造自己的在线电子书

工具推荐 1967 0 创建时间：2020-09-24 15:42:53

**结合 GitHub Pages 使用 GitBook，打造自己的在线电子书**

#### 1、安装node.js

gitbook是Node.js环境下，用于构建电子书的工具，所以要先安装Node.js。

下载链接：https://nodejs.org/en/

#### 2、安装gitbook-cli

gitbook-cli 是gitbook的命令行工具，可在cmd中运行如下命令：

```javascript
npm install -g gitbook-cli
```
执行下面命令，查看 gitbook-cli 的版本，以确定其是否成功安装。
```javascript
$ gitbook -V
CLI version: 2.3.2GitBook version: 3.2.3
```
#### 3、构建电子书

3.1 创建存储电子书所用的文件夹，并cd到该文件夹

```javascript
$ mkdir book
$ cd book
```
3.2 初始化电子书：

```javascript
$ gitbook init
```

这时候会生成下面两个文件：

├── README.md
└── SUMMARY.md

3.3 启动gitbook

```javascript
$ gitbook serve
```

启动之后可打开浏览器，在http://localhost:4000，查看最终效果。

这一步会生成_book文件夹；

#### 4、结合github Pages

GitHub Pages 是 GitHub 提供的静态网站托管服务。

GitHub 上的每个仓库都可以拥有一个 GitHub Pages，对应的 URL 如下：

```javascript
https://<username>.github.io/<repository>/
```
其中，是你的github用户名，是项目名称。

GitHub Pages 的静态资源支持下面 3 个来源：

master 分支
master 分支的 /docs 目录
gh-pages 分支

4.1 新建github项目

新建github项目有两种方法，一种是在本地使用git命令行，一种是在github网页上新建：

4.1.1 本地命令行新建

git init
git remote add origin https://github.com/github账号/项目名(需与本地目录一致).git

4.1.2 网页新建

登录github账号，点击New repository，创建项目 ;

添加项目名称和描述，然后创建项目 ;

并克隆到本地；

4.2 把本地项目推到github

```javascript
git add .
git commit -m 'init' git push -u origin master
```

4.3 将远程文件的推到其他分支

_book 目录中包含静态电子书页面，执行下面命令，将 _book 目录推送到 GitHub 仓库的 gh-pages 分支，

便于他人访问；

```javascript
$ git subtree push --prefix=_book origin gh-pages
```

5 更新gitbook

工具：markdown编辑器 typora

每次更新之后需要执行命令：

$ gitbook build

这一步是把更新的内容同步到_book文件夹中；

接着推到github:

```javascript
git add .
git commit -m 'aaa' git push
```

并推到gh-pages分支：

```javascript
$ git subtree push --prefix=_book origin gh-pagesbi
```

结合 GitHub Pages 使用 GitBook，打造自己的在线电子书

商品推荐

广告推荐

推荐文章