在經過了長時間的折騰之後,終於在mac環境成功的安裝了gitbook。
安裝gitbook的主要流程如下:
安裝node.js>安裝gitbook>安裝gitbook編輯器》安裝calibre>匯出pdf。
安裝node.js
crillermacbook-pro:~ criller$ node -v
v6.10
.2
安裝gitbook
這個點是最坑的。尤其是在mac環境下,我先後嘗試了以下**:
npm install gitbook -g
npm install -g gitbook-cli
還有好幾個,先說明下,以上**都是錯誤的,不是卡主了就是不能動。原來,mac環境下需要用到sudo這個指令。
sudo npm install gitbook-cli
-g
一定要用到-g,這個代表全域性安裝,我去掉-g安裝了一次,也成功了,但是在終端使用gitbook -v檢視的時候發現根本沒安裝,這是我遇到的坑最多的地方。
在終端輸入gitbook -v之後即可檢視當前gitbook版本,代表安裝成功。需要注意的是「v」一定要大寫。
crillermacbook-pro:~ criller$ gitbook -v
cli version: 2.3
.0gitbook version: 3.2
.2
安裝gitbook編輯器
接下來就是安裝gitbook桌面編輯器了。有的人可能會問,你都已經安裝了終端環境下的gitbook了,為什麼還要安裝桌面端呢?
安裝了gitbook桌面端之後,你可以在客戶端中新建一本書籍。然後用終端生成html。
使用gitbook build命令。
crillermacbook-pro:import criller$ cd jianli
crillermacbook-pro:jianli criler$ gitbook build
info: 7 plugins are installed
info: 6 explicitly listed
info: loading plugin "highlight"
... ok
info: loading plugin "search"
... ok
info: loading plugin "lunr"
... ok
info: loading plugin "sharing"
... ok
info: loading plugin "fontsettings"
... ok
info: loading plugin "theme-default"
... ok
info: found 1 pages
info: found 7 asset files
info: >> generation finished with success in
1.0s !
crillermacbook-pro:jianli criller$
看到success的提示沒,這個時候系統檔案根目錄下就生成了乙個_book的資料夾。開啟就是該書籍的html格式了。
你也可以直接將該書籍在本地預覽。
使用gitbook serve命令
crillermacbook-air:jianli criller$ gitbook serve
live reload server started on port: 35729
press ctrl+c to quit ...
info: 7 plugins are installed
info: loading plugin "livereload"
... ok
info: loading plugin "highlight"
... ok
info: loading plugin "search"
... ok
info: loading plugin "lunr"
... ok
info: loading plugin "sharing"
... ok
info: loading plugin "fontsettings"
... ok
info: loading plugin "theme-default"
... ok
info: found 1 pages
info: found 7 asset files
info: >> generation finished with success in
1.2s !
starting server ...
serving book on http://localhost:4000
玩過kindle的都知道,calibre是一款非常方便的開源電子書轉換軟體。在這裡,我們也是用到ebook-convert這個外掛程式。
這裡我通過諮詢了一些大神,在這個過程中他們給了我很大的幫助。也檢視了很多教程,所有教程中都說了兩個問題。
但是執行多次都沒有結果,win系統執行這步可能已經正確了。因為mac環境許可權的原因,這裡加入sudo重新執行即可。
執行完成之後,重新進入書籍目錄。
crillermacbook-pro:import criller$ cd jianli
crillermacbook-pro:jianli criller$ gitbook pdf . jianli.pdf
info: 7 plugins are installed
info: 6 explicitly listed
info: loading plugin "highlight"
... ok
info: loading plugin "search"
... ok
info: loading plugin "lunr"
... ok
info: loading plugin "sharing"
... ok
info: loading plugin "fontsettings"
... ok
info: loading plugin "theme-default"
... ok
info: found 1 pages
info: found 7 asset files
info: >> generation finished with success in
7.5s !
info: >> 1 file(s) generated
gitBook環境搭建
markdown是編寫文件的利器,使用gitbook來配合markdown自然就是絕配了。1.安裝gitbook 安裝gitbook之前需要先安裝好node.js.這個網上都有。之後安裝gitbook 就是小菜一碟 npm install g gitbook 2.gitbook轉換為pdf 這個部分...
GitBook 安裝使用,及遇到的坑 Mac下
1 安裝gitbook命令列 code npm install g gitbook cli code 2 檢視是否安裝成功 code gitbook v code 3 開始使用 1 初始化 code mkdir test gitbook cd test gitbook touch readme.md...
MAC下Intellij IDEA Go環境配置
配置乙個gopath環境變數,是工作目錄。根據約定,gopath下需要建立3個目錄 bin 儲存編譯後的可執行檔案 pkg 存放編譯後生成的包檔案 src 存放專案的原始碼 我把gopath建立在 users xinshaofeng study gowork vi bash profile 加入 e...