# 使用TravisCI构建Gitbook

# 为什么要使用Travis CI构建Gitbook？

为你的项目接入Travis CI后，可以实现你的项目完全在线自动部署，无论你在任何地方，只要能够接入到互联网，访问到GitHub，就可以更新你的电子书，同时使其自动发不到GitHub上。

特别是你的电子书需要和一些非技术类同学协作时，借助Gitbook，他可以只通过浏览器对电子书进行修改，无需在自己的电脑上偶主Gitbook环境

# 配置你步骤

创建.travis.yml文件

Travis的构建基于.travis.yml文件进行的，因此，为了让Travis CI能够正常构建，我们先来创建.travis.yml。

访问你的GitHub项目主页，点击其中的Create new File

在弹出的界面中填入文件名 .travis.yml

language: node_js

node_js:
  - "8"

cache:
  directories:
    - $HOME/.npm

before_install:
  - export TZ='Asia/Shanghai'

install:
  - npm install gitbook-cli -g
  - gitbook install

script:
  - gitbook build . ./build

branches:
  only:
    - master

deploy:
  provider: pages
  skip_cleanup: true
  github_token: $GITHUB_TOKEN
  local_dir: build
  on:
    branch: master

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

添加完成后，选择**commit new file 即可。

# 配置Travis CI

如果你想要借助Travis CI来构建，除了创建配置文件以外，还需要使用你的GitHub账号登陆Travis CI，进行一些简单的配置

访问Travis CI (opens new window)官网，使用Github登陆

登陆后，点击右上角用户头像，在谭书的下拉窗口中选择Settings。

在下方的Repository列表中找到你的项目

点击项目后的Settings，进入到项目的界面

在项目界面中找到More Options，选择其中的Settings

进入到项目的设置界面。

在下方的Environment Variables中添加一个新的名为$GITHUB_TOKEN的环境变量，将你自己的Personal Access Token (opens new window)填入其中，用于后续的GitHub Pages自动上传

添加完成后，再次点击More Options，选择其中的Trigger Build。

在弹出的界面中直接点击按钮开始构建

随后，你就可以等待Travis CI 的自动构建了

稍等片刻，当你发现Travis CI的构建变成绿色后，就说明已经构建完成了

此时，回到Github，点击界面中的Branc，就可以看到所有的分支了