轉載自:https://www.cnblogs.com/yuanpeng-java/p/10384300.html
一.在 Mac 環境上搭建 gitbook
#1.安裝node.js,在node.js官網下載,直接安裝穩定版本。
https://nodejs.org/en/
#2.檢測 node.js 是否安裝成功
npm -v
#3.安裝 gitboot 和命令行工具 -g 代表全局安裝
sudo npm install gitbook -g
sudo npm install -g gitbook-cli
#4.檢測是否安裝成功 v 大寫
gitbook -V
gitbook -version
#更新 gitbook 命令行工具
sudo npm update gitbook-cli -g
#卸載 GitBook 命令
sudo npm uninstall gitbook-cli -g
#查看安裝位置
which gitbook
#5.安裝 gitboot editor,方便編輯書籍
https://legacy.gitbook.com/editor/osx
#6.安裝calibre,calibre是一款非常方便的開源電子書轉換軟件
https://calibre-ebook.com/download
#7.將安裝的calibre放在應用程序中,執行
sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
二.gitbook的使用
# 1.創建 mygitbook 文件夾,作為第一本書,並切換到這個文件夾下面
mkdir mygitbook && cd mygitbook
#2.初始化 gitbook 工作目錄,創建必要的文件
gitbook init
#README.md - 項目的介紹都寫在這個文件里。
#SUMMARY.md - GitBook 的目錄結構在這里配置。
#3.編輯目錄結構
#4.目錄建好以后在根目錄下執行命令,只支持2級目錄:
gitbook init
#編寫 gitbook 內容,重新編譯
gitbook build
#5.在根目錄執行命令,啟動服務:
gitbook serve
#6.訪問,用瀏覽器打開 http://localhost:4000/ 或 http://127.0.0.1:4000/ 查看顯示書籍的效果。結束預覽 ctrl+c
#7.生成電子書,依賴於Calibregitbook mobi ./ ./MyFirstBook.mobi
三.將寫好的文章推送到 github 上
#注冊 GitHub.com 賬號,並新建一個項目。在“Setting(設置)”頁面獲取到“Git URL(Git 鏈接)”
#在本地安裝 git
#在本地新建一個文件夾,並通過 Git 命令把剛才新建的遠程項目抓取到本地
$ mkdir MyFirstBook-Git
$ cd MyFirstBook-Git
$ git init
$ git pull https://git.gitbook.com/kindlefere/myfirstbook.git
#然后把本地項目“MyFirstBook”中的所有內容拷貝到剛才新建的文件夾中,如上面的“MyFirstBook-Git”。然后使用 Git 命令把本地的項目上傳到遠程
$ git add -A
$ git commit -m "提交說明"
$ git remote add gitbook https://git.gitbook.com/kindlefere/myfirstbook.git
$ git push -u gitbook master
#修改內容后只需要輸入以下 Git 命令即可
$ git add [修改的文件]
$ git commit -m "提交說明"
$ git push -u gitbook master
