GitBook 自建網站-安裝紀錄

試著安裝不公開的GitBook網站 。結論：又一個以Git之名做行銷手段的案例 。

誤會大了：GitBook官網與自建GitBook網站

GitBook官網

• 可說俱有知識管理特性的網站，讓人響往。

• 有登入、授權、文章編輯、管理等等完整的應用。

• 網路上一些 GitBook open source 資訊讓人以為可以自建不公開的GitBook知識管理網站，但實際上這是個大大大的誤會。

自建GitBook網站

• 其實只是個公開的個人的電子書網站建置工具。

• 透過 gitbook-cli 建置(靜態)網站

• 只有電子書網站核心而己。

• 雖與GitBook官網的核心是一樣的，但應用部份落差太遙遠等同是不一樣的產品。

參考:gitbook安裝-windows環境

自建GitBook網站 - 安裝指令

前題：已安裝好node與npm了

C:\Temp> node -v
v12.16.0
C:\Temp> npm -v
6.13.4

開始安裝 gitbook-cli

C:\Temp>npm install -g gitbook-cli
C:\Temp>gitbook -V
CLI version: 2.3.2
GitBook version: 3.2.3

自建GitBook網站 my-gitbook

C:\>cd MyGitBook
C:\MyGitBook>gitbook init
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished

C:\MyGitBook>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 0 asset files
info: >> generation finished with success in 0.4s !

C:\MyGitBook>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 0 asset files
info: >> generation finished with success in 0.5s !

Starting server ...
Serving book on http://localhost:4000

沒圖沒真象

GitBook 自建網站 與 GitBook 官網 完全不是同一個產品。下面比較這兩者功能差異是天與地啊！

GitBook 自建網站畫面

GitBook 官網畫面

結論

GitBook官網 與 GitBook 自建網站 是完全不同的產品，看其畫面差異就…Orz。 又一個以Git之名做行銷手段的案例。

補充：原來GitBook大改版了。v1版是做電子書的。v2版可以做知識管理。 請參考：淺談新版 GitBook（GitBook V2） —— 失去交流開放精神的企業導向產品