gitbook 入門教程之使用 gitbook.com 在線開發電子書

gitbook 官網是官方提供的圖書託管的在線平臺,分爲新版官網(須要FQ) www.gitbook.com/ 和舊版官網(無需FQ) legacy.gitbook.com 兩個網站.

目前均正常提供服務,但使人遺憾的是,兩個網站的信息相互獨立,並且如今註冊的帳號默認只能在新版官網中使用,而新版官網的訪問速度簡直比 github 還要慢,因此國內用戶在線訪問你的電子書真的須要點技術手段了!

本文主要介紹 www.gitbook.com 官網的基本使用,而 legacy.gitbook.com 網站我就算是想介紹也沒有帳號測試啊.

"巧婦難爲無米之炊",明明你就在那裏,可我卻什麼也作不了.

先大概說一下 gitbook.com 網站的一些我的總結吧.

gitbook.com 提供收費和免費服務,有點像早期的 github ,免費帳號只能建立一個私有的命名空間,其餘命名空間只能是公開的,這裏的命名空間能夠理解爲一本書.

這一點是否是有點像早期的 github.com?免費帳號沒法建立私有倉庫,只能是公開倉庫. (如今 github.com 已被微軟收購,目前能夠建立無限量的私有倉庫了!)

再說 gitbook 的帳號問題,像 github 同樣提供用戶名和郵箱登陸方式,他們的用戶名均可以做爲二級域名,好比個人用戶名是snowdreams1006,那麼個人 gitbook 第一本電子書網址就是 https://snowdreams1006.gitbook.io/index/ ,再看一下個人 github 我的網址 https://snowdreams1006.github.io/ ,這兩個是否是很相似?!

若是不仔細看的話,八成你會以爲同樣,一個是**gitbook.io,另外一個是github.io**.

因此我嚴重懷疑他倆是否是有着鮮爲人知的私密關係,太多的類似性,鼓勵分享,限制私有等等特色.

無圖無真相,趁着此次教程順便將 github 我的網站項目同步到 gitbook 電子書項目了,這樣的好處是本地只須要推送到 github ,自動更新 github.io 網站(利用的是github 靜態網站託管服務) ,而後再自動同步到 gitbook.io 網站.

是否是很神奇,一份源碼,兩個官網!

gitbook : snowdreams1006.gitbook.io/

github : snowdreams1006.github.io/

註冊並登錄 gitbook.com

註冊信息主要包括用戶名和郵箱,還有一些其餘信息,沒什麼特殊的注意事項.

訪問 www.gitbook.com/ 須要 FQ

新建命名空間(電子書)

註冊帳後後會默認生成一個私有的命名空間,由於並不打算將私有電子書託管到 gitbook,因此接下來直接將其轉變成公開電子書進行演示.

個性性配置

標題和圖片

主題顏色和頁面反饋

觀衆

觀衆指的是當前電子書面向的受衆是誰,公開的和私有的的區別以及設置是否被谷歌搜索收錄.

域名

默認域名是 https://snowdreams1006.gitbook.io/<space>,若是須要自定義域名,請保證 dns 可以正確解析到該網站.

url 設置的命名空間是 index,所以最終訪問路徑是 https://snowdreams1006.gitbook.io/index/

整合

gitbook 默認提供4種整合方式,在下孤陋寡聞只瞭解 github ,其他三種沒接觸過,暫不涉及.

選擇 github 進行整合

登陸 github 並受權

選擇列出公開的倉庫,而後輸入用戶名和密碼進行登陸並受權.

選擇目標倉庫

受權成功後會列出當前 github 帳號下所有的公開倉庫,選擇目標倉庫並點擊下一步.

這裏以 snowdreams1006.github.io 公開倉庫爲例,由於該倉庫是本人官網源碼項目.

同步內容

選擇同步分支

根據實際狀況選擇同步分支,由於我通常是直接推送到 master 分支,因此 master 分支是我的網站的維護分支,所以這一步我選擇的是 master.

選擇同步內容

選擇同步內容的方式,是從 github 同步到 gitbook,仍是從 gitbook 同步到 github,由於個人項目已託管到 github ,因此初次同步內容選擇的是 github --> gitbook.

顯示 github 按鈕

生成的電子書網站是否顯示 github 按鈕,做用是點擊該按鈕會跳轉到關聯的github 倉庫上.

此時內心在想,萬一點進 github ,隨手就是一個 star 呢?哈哈!

等待內容導入

根據目標倉庫的大小不一樣,導入內容是的時長天然也不同,耐心等待...

上線

導入完成,電子書終於正式上線了!

如今趕忙分享一下好消息吧,訪問 .gitbook.io/ 在線閱讀!

小結

本文以如何集成 github 爲例,演示了 gitbook.com 發佈電子書的基本流程,因爲 gitbook 電子書內容來自於 github 項目,所以咱們只要更新 github 倉庫,咱們的 gitbook 電子書網站天然也就相應更新了!

gitbook 是 markdown 和 github 的完美結合體,藉助 gitbook.com 官網咱們很容易發佈並託管電子書.

美中不足的是,國內沒法正常訪問 gitbook.com ,所以並非很推薦將電子書發佈到 gitbook.com 網站.

如今國內也有相似的產品,有一種產品叫作 看雲,還不錯!

後續還會介紹 gitbook 如何結合 github 發佈我的網站,歡迎繼續關注 gitbook 系列教程!

如何打造免費的我的官網,想了解 https://snowdreams1006.github.io/ 背後的故事嗎?