发布一本用 GitBook 编辑的书

在上一篇的文章里，咱们已经写好了一本名叫 erdong-first-book 的书，可是在本地浏览很不方便，咱们但愿放到网络上，能够随时、方便的访问这个书籍。这个需求可使用多种方式来实现，好比第一种，能够经过 GitBook 官网来发布这本书，GitBook 除了是一个电子书的工具觉得，自身也有一个网址，在该网站注册成为会员后，能够发布本身的电子书，而且能够和 GitHub 进行关联。

除了使用 GitBook 官网之外，能够直接将电子书放在 GitHub 上，经过 GitHub Pages 来发布这本书。

使用 GitHub 发布你的书籍

接下来咱们看一下如何使用 GitHub Pages 来发布一本书。

首先你须要一个 GitHub 的帐号，在你的帐号下建立一个用来放置你书籍的仓库，这两个步骤在网络上有太多的资料，很容易就能够达成了。

建立好仓库之后，在仓库中建立一个 docs 文件夹，用来放置 GitBook 生成的静态文件。

打开 GitHub 仓库的设置页面，找到 GitHub Pages 选项，选择 master branch /docs folder 选项便可。

注意：必定要先在仓库中建立 docs 文件夹，不然没法勾选该选项。

作完上述步骤之后开始使用 Git 上传你写好的内容到 GitHub , 关键点是将 GitBook 生成的静态文件 _book 重命名为 docs 上传替换刚才建立的 docs 文件夹便可。

这个时候使用浏览器打开 http://your_github_id.github.io/your_github_gitbook 这个地址便可。好比个人 GitBook 地址是
http://erdong.github.io/gitbook-notes-samples ，你们在点击之后发现会自动跳转到 https://erdong.site/gitbook-notes-samples 是由于我作了域名绑定。

本地 GitBook 迁移

在迁移前可使用以下命令查看一下曾经使用 npm 安装过什么模块

npm list -g --depth 0

• list : 已经安装的 node 包
• -g ： 全局的安装包
• --depth : 包的显示层级，0 表明显示第一级的包，数字越大，显示的越全。

迁移其实很是简单，你在原来的环境将整本书打包，最好把文件夹里的node_modules 目录也一块儿打包，这样在新的环境就不须要安装这些组件了。在新的环境按照以下顺序依次进行安装你以前安装过的组件

< 1.> 安装 npm
< 2.> 安装 gitbook
< 3.> 拷贝打包好的文件夹
< 4.> 减压到新的位置

这样就完成了你的书的迁移。你在新的位置能够继续进行内容的编写、静态文件的生成，和以前同样，没有任何区别。