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/背後的故事嗎?