gitbook 官網是官方提供的圖書託管的在線平臺,分爲新版官網(需要FQ) https://www.gitbook.com/ 和舊版官網(無需FQ) https://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 : https://snowdreams1006.gitbook.io/
github : https://snowdreams1006.github.io/
註冊並登陸 gitbook.com
註冊信息主要包括用戶名和郵箱,還有一些其他信息,沒什麼特殊的注意事項.
訪問 https://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 呢?哈哈!
等待內容導入
根據目標倉庫的大小不同,導入內容是的時長自然也不一樣,耐心等待...
上線
導入完成,電子書終於正式上線了!
現在趕緊分享一下好消息吧,訪問 https://<username>.gitbook.io/<space> 在線閱讀!
小結
本文以如何集成 github 爲例,演示了 gitbook.com 發佈電子書的基本流程,由於 gitbook 電子書內容來自於 github 項目,因此我們只要更新 github 倉庫,我們的 gitbook 電子書網站自然也就相應更新了!
gitbook 是 markdown 和 github 的完美結合體,藉助 gitbook.com 官網我們很容易發佈並託管電子書.
美中不足的是,國內無法正常訪問 gitbook.com ,因此並不是很推薦將電子書發佈到 gitbook.com 網站.
現在國內也有類似的產品,有一種產品叫做 看雲,還不錯!
後續還會介紹 gitbook 如何結合 github 發佈個人網站,歡迎繼續關注 gitbook 系列教程!
如何打造免費的個人官網,想了解 https://snowdreams1006.github.io/ 背後的故事嗎?