發佈一本用 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.> 減壓到新的位置

這樣就完成了你的書的遷移。你在新的位置能夠繼續進行內容的編寫、靜態文件的生成，和以前同樣，沒有任何區別。