GitBook 入門學習

gitbook 是乙個基於 node.js 的命令列工具，支援 markdown 和 asciidoc 兩種語法格式，可以輸出 html、pdf、ebook 等格式的電子書。

gitbook 使用方案：

安裝命令：

# 開啟命令列（管理員）執行以下命令，安裝 node.js 時已經安裝好 npm 工具包 npm install -g gitbook-cli

安裝好之後，會多了乙個 gitbook 命令，現在來初始化一本書：

cd e: mkdir mybook cd mybook gitbook init # 初始化

執行完畢會發現 mybook 目錄中多了兩個檔案：

# 目錄
* [前言](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 init，gitbook 就會自動建立相應章節，如下圖所示：

還可以生成 html 靜態檔案，在瀏覽器中檢視：

gitbook serve

出現錯誤：

解決：找到c:\users\hj\.gitbook\versions\3.2.3\lib\output\website\copypluginassets.js檔案，注釋掉第 112 行：

return fs.copydir(
assetsfolder,
assetoutputfolder,
);

參考文章：

再次執行gitbook serve：

訪問：

# 構建書籍，預設將生成的靜態**輸出到 _book 目錄 gitbook build # 指定路徑 gitbook build [書籍路徑] [輸出路徑] # 指定埠 gitbook serve --port 2333 # 你還可以生成 pdf 格式的電子書 gitbook pdf ./ ./mybook.pdf gitbook epub ./ ./mybook.epub # epub 格式 gitbook mobi ./ ./mybook.mobi # mobi 格式

其他命令：

gitbook init //初始化目錄檔案 gitbook help //列出gitbook所有的命令 gitbook --help //輸出gitbook-cli的幫助資訊 gitbook build //生成靜態網頁 gitbook serve //生成靜態網頁並執行伺服器 gitbook ls //列出本地所有的gitbook版本 gitbook ls-remote //列出遠端可用的gitbook版本 gitbook fetch 標籤/版本號 //安裝對應的gitbook版本 gitbook update //更新到gitbook的最新版本 gitbook uninstall 2.0.1 //解除安裝對應的gitbook版本 gitbook build --log=debug //指定log的級別 gitbook builid --debug //輸出錯誤資訊

參考文章

GitBook 入門學習

Gitbook 學習鏈結

gitbook 入門教程之外掛程式介紹

gitbook 入門教程之發布電子書

GitBook 入門學習

Gitbook 學習鏈結

gitbook 入門教程之外掛程式介紹

gitbook 入門教程之發布電子書

相關推薦