原创 關於寫作那些事之github告訴我構建失敗,然後呢?

The page build failed for the master branch with the following error 問題描述 看到這封郵件,一臉懵逼,本地運行 gitbook 服務是正常渲染的,控制檯並沒有任何報錯,

原创 gitbook 入門教程之準備階段

主要包括兩部分: 前置知識和操作工具. 前置知識主要是涉及到 git 以及 markdown 的相關知識,其中 git 是分佈式版本控制系統,方便管理我們的電子書,備份到雲端,方便團隊共享合作,而 markdown 則是一種簡單標記語言,簡

原创 關於寫作那些事之終於還是無法忍受純人工統計數據

背景 作爲正在探索如何寫作並發表到各大博客平臺的新人,目前雖然已基本弄清寫作和發表的基本流程,但是離打造個人知名度還差很大很大一段距離. 尤其處於新手階段,需要的更是自信與外界的積極反饋,看着各平臺日益增長的閱讀量和粉絲量,心中自然不甚欣喜

原创 gitbook 入門教程之主題插件(初稿)

目前 gitbook 提供三類文檔: Book 文檔,API 文檔和 FAQ 文檔. 其中,默認的也是最常使用的就是 Book 文檔,如果想要了解其他兩種文檔模式,需要引入相應的主題插件. 官方主題插件文檔: https://toolch

原创 gitbook 入門教程之發佈電子書

輸出目標文件 語法格式: gitbook build [book] [output] 默認情況下,gitbook 輸出方式是靜態網站,其實 gitbook 的輸出方式有三種: website, json,和 ebook. 只不過另外兩種不是

原创 gitbook 入門教程之導出電子書

gitbook 既可以將源碼文件單獨輸出,也可以僅輸出單個文件,常見的導出電子書格式主要有三種(ePub, Mobi, PDF),而這三種格式都依賴於系統本身提供的 ebook-convert 工具. 安裝依賴 如果直接運行 gitboo

原创 gitbook 入門教程之實用插件(持續更新)

disqus 評論插件 discus 是一款集成評論的插件,可以爲靜態網站添加動態評論,讓你的網站動起來! 遺憾的是,discus 插件只有 FQ 才能正常使用,暫時沒找到其他較好的替代方案. 註冊 disqus.com 賬號 gitb

原创 gitbook 入門教程之插件介紹

插件是 gitbook 的擴展功能,很多炫酷有用的功能都是通過插件完成的,其中插件有官方插件和第三方插件之分. 推薦官方插件市場 https://plugins.gitbook.com/ 尋找或下載相應的插件. 當然也可以去 npm 市場

原创 gitbook 入門教程之使用 gitbook-editor 編輯器開發電子書

親測,目前已不再支持舊版 gitbook-editor 編輯器,而官網也沒有相應的新版編輯器,如果哪位找到了新版編輯器,還望告知! 現在註冊 gitbook 賬號會默認重定向到 新版官網,而 舊版官網 的賬號應該是可以正常使用的,前提是你

原创 gitbook 入門教程之常用命令詳解

不論是 gitbook-cli 命令行還是 gitbook editor 編輯器都離不開 gitbook 命令的操作使用,所以再次瞭解下常用命令. 注意 gitbook-cli 是 gitbook 的腳手架工具,是 gitbook 的擴展功

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

gitbook 官網是官方提供的圖書託管的在線平臺,分爲新版官網(需要FQ) https://www.gitbook.com/ 和舊版官網(無需FQ) https://legacy.gitbook.com 兩個網站. 目前均正常提供服務,但

原创 gitbook 入門教程之使用 gitbook-cli 開發電子書

gitbook 生成電子書主要有三種方式: gitbook-cli 命令行操作,簡潔高效,適合從事軟件開發的相關人員. gitbook-editor 編輯器操作,可視化編輯,適合無編程經驗的文學創作者. gitbook.com 官網

原创 gitbook 入門教程之快速體驗

本文主要介紹三種使用 gitbook 的方式,分別是 gitbook 命令行工具,Gitbook Editor 官方編輯器和 gitbook.com 官網. 總體來說,三種途徑適合各自不同的人羣,找到適合自己的方式就好,基本操作流程都是一樣

原创 gitbook 入門教程之環境要求

gitbook 是基於 node.js 的命令行工具,首先需要安裝並配置好 node.js 環境,然後才能安裝gitbook 相關工具. 由於安裝工具全部都是國外網站,因此速度可能會很慢,也可能需要FQ,請耐心等待或者學會科學上網. 當然如

原创 gitbook 入門教程之前置知識

markdown 基本知識 markdown 是一種簡化的 html 語法,相比於 txt 無格式文本更強大. 你可以用專門的軟件去編輯 markdown 文件,就像需要使用軟件編輯 txt 文件一樣,當然也可以什麼軟件也不用,甚至直接在