使用GitBook平臺釋出電子書

berlinix發表於2014-10-23

上次說到用GitBook製作電子書,側重在使用gitbook這個命令列工具,今天要說的重點是GitBook這個平臺。當你把書放到GitBook上後,可以設定書的價格(每筆交易GitBook抽走20%作為佣金),也可以設定為免費,以及接受捐贈。如果你要收費或接受捐贈,則需要一個PayPal賬戶。在開始前,我要友情提示一句,在國內訪問GitBook的速度很慢,通過VPN訪問才好。

第-1步 用git這個原始碼管理工具來管理你的Markdown檔案。最好有個GitHub賬戶,這樣每次push到GitHub時,GitBook都會自動為你的更新build新的版本(同時生成HTML、PDF、ePUB、MOBI這4個版本)。

第0步 註冊一個GitBook帳號。

第1步 在GitBook新增一本書,填寫書名等基本資訊即可。完成後,GitBook會為你生成一個git倉庫,其格式為:

https://push.gitbook.io/{author}/{book}.git

author即你的GitBook使用者名稱,book即你的書名,如我建立的書的git倉庫:

https://push.gitbook.io/berlinix/guaidanuniversity.git

這樣你可以在編寫完Markdown後,通過git push同步到GitBook。

第2步 把你本地的Markdown檔案push到GitBook。我發現git push時常失敗(伺服器返回5xx錯誤),因此還有一種方法就是把你的GitHub專案與GitBook關聯。每次push到GitHub時,會通過GitBook的webhook自動同步到GitBook上。

在Book Setting中簡單配置一下即可,如我的配置為:berlinix/gdu (GitHub使用者名稱為berlinix,GitHub倉庫名為gdu)

在第一次push後,就可以看到你在GitBook上的電子書了,其訪問地址為:

http://{author}.gitbooks.io/{book}/

這是你電子書的主頁,從這個頁面可以直接開啟HTML版本,或下載PDF等電子書版本,一般使用者也可以為你的書新增評論。如:

http://berlinix.gitbooks.io/guaidanuniversity/

要直接訪問HTML版本,可以通過連結:

https://www.gitbook.io/read/book/{author}/{book}

直接訪問,如:

https://www.gitbook.io/read/book/berlinix/guaidanuniversity

至此,GitBook平臺的基本用法就介紹完畢。下面是我的一些使用經驗。

個性化域名

HTML版本的URL很複雜,可以使用個性化域名簡化之。在域名註冊商那裡新增一條CNAME記錄即可,如:

CNAME gdu.berlinix.com www.gitbook.io 300

並把gdu.berlinix.com配置到Book Setting中去,這樣可以通過簡單的gdu.berlinix.com來取代https://www.gitbook.io/read/book/berlinix/guaidanuniversity。同理,電子書的主頁也可設定個性化域名,就不再贅述。

刪除電子書

同樣是在Book Setting中,可以刪除電子書。在電子書列表中沒有刪除介面。

GitBook電子書封面

可以為電子書新增封面。只需新增2個名為cover.jpgcover_small.jpg的兩個圖片即可。官方建議cover.jpg尺寸1800*2360,cover_small.jpg尺寸200*262。花2元即可在淘寶上找個做封面的人為你製造一個簡單的封面,做得好就要花更多一些了 :)

GitBook帳號頭像

似乎只接受Gravatar.com的頭像。把Gravatar帳號關聯過去即可。Gravatar提供的服務是把你的郵箱和頭像關聯起來,當你在其他網站註冊時就不用每次都上傳同一個頭像,只需簡單與Gravatar帳號關聯即可。這樣替換頭像也方便了,一次替換、處處生效。

訪問優化

按GitBook的訪問速度,如果真讓人訪問GitBook上的HTML頁面真是自尋死路啊,因此最好是把GitBook編譯後的HTML放在自己的網站上。同時,為自己網站的HTML生成Disqus支援。例如你可以訪問我放到自己伺服器後的頁面(用手機訪問效果也非常好):

http://www.berlinix.com/gdu/index.html

電子書Bug

上次說到GitBook生成PDF的中文字型非常醜陋,另外還有一個問題,那就是生成的PDF可能是殘全不全的。我編譯後發現內容只剩一半。我已郵件過去報告這個Bug,還在等回信 :)

總體而言,GitBook還是很好玩,比起其他寫作平臺而言,要自由、簡單,並舒服得多,可以用Vim編輯,支援Markdown語法,用git管理,關聯GitHub後每次push後還能自動編譯,生成多種電子書格式。如果你的書極為暢銷的話,還能獲取到捐贈或購買,沒有理由不嘗試的呀。

相關文章