GitBook文本管理工具的使用

GitBook簡介

一、Git和GitBook

​ 相信在認識GitBook之前,你或多或少對Git是有了解的。可能你覺得Git只是作爲協同開發使用,其實不然。GitHub依賴其良好的開源性,完全可以作爲一個良好的分享平臺。而且在這裏你不只是能分享你的代碼,包括你的任何文章、心得、著作,everything is ok!

​ 那麼Git和GitBook有聯繫嗎?答案是 :

​ 沒聯繫!

​ 就像雷鋒和雷峯塔!

​ 但是他們可以聯合使用,GitBook只是一個文本編輯器(當然是高級的文本編輯器),類似MarkDown(當你在CSDN寫博客時用到的那樣)。我們可以用GitBook創建來管理,使用typora來進行線下編輯,最後,使用GitBook和GitHub/GitLab協作實現共享或協同開發。

​ 類似的MarkDown編輯器其實有很多種,Typora、MacDown、Bear、MarkdownPad、MarkdownX、JetBrains’s IDE(需要安裝插件)、Atom、簡書、CSDN 以及 GitBook 自家的 GitBook Editor 等等。

各類MarkDown編輯器比較

二、GitBook與Word

​ 同樣的,也沒什麼關係。他們雖說都是文本編輯軟件,但GitBook特點是功能簡單,更注重協同開發和共享,還能完成版本控制。而Word可以做出許多炫酷的效果以及更爲精準的格式樣式等。

GitBook安裝

一、安裝Node.js

​ GitBook基於Node.js,需要先安裝Node.js。進入官網即可下載: https://nodejs.org/en/download/

二、安裝GitBook

​ 安裝好的Node.js自帶了npm(node包管理工具),所以安裝後即可在命令行執行以下命令安裝GitBook:

npm install -g gitbook-cli

​ 安裝好之後就可以使用 gitbook 命令了

三、安裝Typora

​ 去官網下載: https://typora.io/(需翻牆)

​ Git下載地址: https://git-scm.com/downloads

使用GitBook

​ 想象一下,現在你準備構建一本書籍,你在硬盤上新建了一個叫 mybook 的文件夾,按照以前的做法,你會新建一個 Word 文檔,寫上標題,然後開始巴滋巴滋地筆耕。但是現在有了 GitBook,你首先要做的是在 mybook 文件夾下使用cmd命令行執行以下命令:

gitbook init

​ 執行完後,你會看到多了兩個文件 —— README.mdSUMMARY.md,它們的作用如下:

README.md  —— 書籍的介紹寫在這個文件裏
SUMMARY.md —— 書籍的目錄結構在這裏配置

​ 這時候,我們啓動恭候多時的 Typora 來編輯這兩個文件了

​ 編輯 SUMMARY.md文件,內容修改爲:

# 目錄

* [前言](README.md)
* [第一章](Chapter1/README.md)
  * [第1節:衣](Chapter1/衣.md)
  * [第2節:食](Chapter1/食.md)
  * [第3節:住](Chapter1/住.md)
  * [第4節:行](Chapter1/行.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)

​ 接着我們執行 gitbook serve 來預覽這本書籍,執行後GitBook會將這本書轉化爲Html格式,並提供一個http網址,可以訪問了。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章