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) —— 失去交流開放精神的企業導向產品

Last updated