GitBook的帳號註冊和安裝使用(一)

1.GitBook帳號註冊

       GitBook原註冊地址  https://legacy.gitbook.com/join 改成: https://www.gitbook.com/html

(1)註冊帳號:https://app.gitbook.com/join,輸入用戶名、郵箱地址、密碼,點擊建立帳號node

image

(2)激活你的帳號,填入國家,真實的手機號碼,點擊send me…git

Snipaste_2019-08-21_17-00-47

(3)在輸入框中輸入發過來 的驗證碼,點擊肯定(圖忘記截圖了)web

(4)進入GitBook後臺管理界面npm

image

2.GitBook安裝

2.1下載和安裝Node.j

GitBook 是一個基於 Node.js 的命令行工具,所以須要下載和安裝Node.jswindows

下載地址:http://nodejs.cn/download/app

點擊windows安裝包工具

image

彈出另存爲,自定義下載路徑,這裏是安裝包,非壓縮包,放到桌面便可學習

image

去到桌面雙擊安裝,下一步,贊成協議,自定義安裝路徑,一直下一步,點擊完成,安裝完成後,去到你安裝的路徑下,如測試

image

檢測是否輸出hello node文件,以管理員的身份打開cmd,輸入如下語句測試,下圖表示編譯成功

image

那測試test.js,可否運行,先在桌面建立node_test文件夾,裏面放test.js文件

image

其內容:

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.");

以普通的cmd進入desktop/node_test/,輸入node test.js編譯

image

訪問網址http://127.0.0.1:3000。若是正常訪問了,則安裝成功

image

最簡單是否安裝成功的方法,查看版本號,在cmd,輸入

node -v

image

1.2.2安裝GitBook

輸入命令,全局安裝gitbook

npm install gitbook-cli -g

image

image

image

安裝完成以後,使用下面的命令來檢驗是否安裝成功

gitbook -V


image

3.GitBook的簡單使用

(1)初始化gitbook

$ mkdir /d/mygitbook          #建立文件夾
$ cd /d/mygitbook             #進入所建立的文件夾
$ gitbook init                #初始化gitbook
warn: no summary file in this book
info: create README.md  
info: create SUMMARY.md
info: initialization is finished  #初始化成功

image

  初始化 GitBook 目錄,建立兩個 md 格式的文件 README.md 和 SUMMARY.md

  • README.md - 項目的介紹
  • SUMMARY.md - GitBook 的目錄結構

image

(2)定義目錄結構

   在 SUMMARY.md 文件中定義目錄結構有兩種方法。

  • 方法 1: 先定義好目錄結構,經過 gitbook init 自動生成目錄結構對應的文件夾和 Markdown 文件。

  • 方法 2: 先建立好文件夾和 Markdown 文件再來編輯目錄結構。

   我的定義SUMMARY.md 的目錄結構:

# Summary
*[簡介](README.md)
*[安裝和下載](docs/安裝和下載.md)
*[簡單使用](docs/簡單使用.md)
*[深刻學習](docs/深刻學習.md)
*[總結](docs/總結.md)

  在跟目錄下執行命令:

$ gitbook init

image

gitbook init 只支持生成兩級目錄,

image

在根目錄下執行啓動服務命令,

gitbook serve


出現出錯:

image

Error: ENOENT: no such file or directory, stat 
'D:\mygitbook\_book\gitbook\gitbook-plugin-fontsettings\fontsettings.js'

解決方法:

修改 
<CODE>C:\Users\Administrator\.gitbook\versions\3.2.3\lib\output\website\copyPluginAssets.js</CODE> 
文件中的 112 行

image

將 confirm: true</CODE> 改成 <CODE>confirm: false</CODE>


參考:http://www.javashuo.com/article/p-ujkgdbzv-dp.html

從新輸入

gitbook serve

image

訪問:http://127.0.0.1:4000/

image


參考:

http://www.javashuo.com/article/p-hluwmccr-cv.html

http://www.javashuo.com/article/p-ujkgdbzv-dp.html

https://blog.qianchia.com/articles/6099a7cb.html

相關文章
相關標籤/搜索