gitbook的學習

gitbook安裝與使用之windows下搭建gitbook平臺

最近須要在GitBook中去閱讀電子書

• 安裝nodejs
• cnpm安裝gitbook
• 解壓書籍文件，並cd到書籍文件目錄
• gitbook serve
• 瀏覽器訪問localhost:4000

先在windows 下安裝nodejs

官網：https://nodejs.org/en/

下載後直接安裝便可

而後經過cmd調出DOS命令窗口測試下是否安裝完成

輸入命令：node

輸入：
console.log("Hello,World!");
測試一下

在D盤下創建一個app文件夾，app文件夾裏面寫一個test.js。

代碼以下：

 

var http = require("http");

   

http.createServer(function(req, res) {

  res.writeHead( 200 , {"Content-Type":"text/html"});

  res.write("<h1>Node.js</h1>");

  res.write("<p>Hello World</p>");

  res.end("<p>beyondweb.cn</p>");

}).listen(3000);

console.log("HTTP server is listening at port 3000.");

編輯好文件後

再從DOS窗口進入你的app的文件夾，在命令窗口執行【node test.js】。這樣就能夠在網頁上訪問你的js了。訪問網址http://127.0.0.1:3000。若是你正常訪問了，那麼就安裝成功了。

Nodejs安裝成功。

 

接下來

搭建gitbook平臺

GitBook

GitBook 是一個基於 Node.js 的命令行工具，可以使用 Github/Git 和 Markdown 來製做精美的電子書。經過Node.js命令安裝GitBook

一、NMP安裝Gitbook

npm install gitbook -g

二、安裝gitbook CLI

想在系統上的任何地方的gitbook命令，須要安裝「gitbook CLI」，執行如下命令

//安裝命令
npm install -g gitbook-cli
//卸載命令
npm uninstall -g gitbook

三、檢驗下是否安裝成功

gitbook -V //顯示0.4.2

 

基本使用

gitbook 的基本用法很是簡單，基本上就只有兩步：

1. 使用 gitbook init 初始化書籍目錄
2. 使用 gitbook serve 編譯書籍

下面將結合一個很是簡單的實例，來介紹 gitbook 的基本用法。

gitbook init

首先，建立以下目錄結構：

$ tree book/
book/
├── README.md
└── SUMMARY.md

0 directories, 2 files 

README.md 和 SUMMARY.md 是兩個必須文件，README.md 是對書籍的簡單介紹：

$ cat book/README.md 
# README This is a book powered by [GitBook](https://github.com/GitbookIO/gitbook). 

SUMMARY.md 是書籍的目錄結構。內容以下：

$ cat book/SUMMARY.md 
# SUMMARY * [Chapter1](chapter1/README.md) * [Section1.1](chapter1/section1.1.md) * [Section1.2](chapter1/section1.2.md) * [Chapter2](chapter2/README.md) 

建立了這兩個文件後，使用 gitbook init，它會爲咱們建立 SUMMARY.md 中的目錄結構。

$ cd book $ gitbook init $ tree . ├── README.md ├── SUMMARY.md ├── chapter1 │ ├── README.md │ ├── section1.1.md │ └── section1.2.md └── chapter2 └── README.md 2 directories, 6 files 

注意：在個人實驗中，gitbook init 只支持兩級目錄！

gitbook serve

書籍目錄結構建立完成之後，就可使用 gitbook serve 來編譯和預覽書籍了：

$ gitbook serve
Press CTRL+C to quit ...

Live reload server started on port: 35729 Starting build ... Successfully built! Starting server ... Serving book on http://localhost:4000 

gitbook serve 命令實際上會首先調用 gitbook build 編譯書籍，完成之後會打開一個 web 服務器，監聽在本地的 4000 端口。

如今，能夠用瀏覽器打開 http://127.0.0.1:4000 查看書籍的效果，以下圖：

如今，gitbook 爲咱們建立了書籍目錄結構後，就能夠向其中添加真正的內容了，文件的編寫使用 markdown 語法，在文件修改過程當中，每一次保存文件，gitbook serve 都會自動從新編譯，因此能夠持續經過瀏覽器來查看最新的書籍效果！

另外，用戶還能夠下載 gitbook 編輯器，作到所見即所得的編輯，以下圖所示：

gitbook editor 的使用很是簡單，這裏再也不介紹！