建立屬於自己的gitbook

2021-09-28 14:58:13 字數 3033 閱讀 2011

目錄

一、gitbook簡介

二、gitbook安裝部署

1、安裝nodejs

2、安裝gitbook

3、gitbook使用

gitbook是乙個基於 node.js 的命令列工具,可使用 github/git 和 markdown 來製作精美的電子書,gitbook 並非關於 git 的教程。

gitbook支援輸出多種文件格式:

靜態站點:gitbook預設輸出該種格式,生成的靜態站點可直接託管搭載github pages服務上;

1·pdf:需要安裝gitbook-pdf依賴;

2·ebook:需要安裝ebook-convert;

3· 單html網頁:支援將內容輸出為單頁的html,不過一般用在將電子書格式轉換為pdf或ebook的中間過程;

4·json:一般用於電子書的除錯或元資料提取。

使用gitbook製作電子書,必備兩個檔案:readme.md和summary.md。

由於gitbook是基於nodejs的工具,所以安裝gitbook前需先安裝nodejs。

# tar xf node-v10.9.0-linux-x64.tar.xz // 解壓

# cd node-v10.9.0-linux-x64/ // 進入解壓目錄

# ./bin/node -v // 執行node命令 檢視版本

v10.9.0

解壓檔案的 bin 目錄底下包含了 node、npm 等命令,我們可以使用 ln 命令來設定軟連線:

ln -s /usr/software/node-v10.9.0-linux-x64/bin/npm   /usr/local/bin/ 

ln -s /usr/software/node-v10.9.0-linux-x64/bin/node /usr/local/bin/

利用npm安裝gitbook,安裝步驟可見 install gitbook。

npm install gitbook -g

npm install gitbook-cli -g

gitbook-cli 是構建book的工具,gitbook init時需要。

安裝後的gitbook會在node安裝bin目錄下,所以要使用gitbook目錄可以使用ln -s命令做好軟連線。

gitbook 的基本用法非常簡單,基本上就只有兩步:

使用 gitbook init 初始化書籍目錄;

使用 gitbook serve 編譯書籍;

mkdir book

cd book

gitbook init

初始化後,book目錄內容如下:

book/

├── readme.md

└── summary.md

readme.md 和 summary.md 是兩個必須檔案,readme.md 是對書籍的簡單介紹:

# cat book/readme.md 

# introduction

this is my first book.

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 serve來編譯和預覽書籍了。

gitbook serve 命令實際上會首先呼叫 gitbook build 編譯書籍,然後啟動web服務,監聽在本地的 4000 埠。

用瀏覽器開啟  ,檢視書籍的效果:

gitbook 為我們建立了書籍目錄結構後,就可以向其中新增內容了,檔案的編寫使用 markdown 語法,在檔案修改過程中,每一次儲存檔案,gitbook serve都會自動重新編譯,所以可以實時通過瀏覽器來檢視最新的書籍效果!

建立屬於自己的部落格

想必有人很想搭建自己的部落格吧,我也是其中一員。我借鑑前人的經驗來搭建自己的部落格 一 首先電腦下需要安裝好 git 和 node.js 針對windows 然後你需要有乙個github的賬號,那麼就可以開始了 二 1.首先開啟 git bash here 然後輸入 npm install g he...

hexo GitHub建立屬於自己的部落格

hexo是乙個開源的靜態部落格生成器,用nodejs開發,作者是台灣大學生tommy351。nodejs 開啟cmd輸入node v,出現版本號說明安裝成功 hexo安裝 開啟git shell 或 git,輸入 d cd blog d blog npm install hexo cli g稍等一會...

建立屬於自己的NPM包

這一步很簡單,只需訪問npm官網建立乙個賬號 在執行這一步前,先給自己的第乙個npm取乙個名字,命名需要注意以下規範 1 不要與已存在的其他npm包重名 2 包名不能出現大寫 3 不能混淆作者身份 4 符合npm標準,不能有冒犯性的命名,或是別人的商標名 5 在package.json檔案的相應行中...