目錄
一、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 命令來設定軟連線:
利用npm安裝gitbook,安裝步驟可見 install gitbook。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/
gitbook-cli 是構建book的工具,gitbook init時需要。npm install gitbook -g
npm install gitbook-cli -g
安裝後的gitbook會在node安裝bin目錄下,所以要使用gitbook目錄可以使用ln -s命令做好軟連線。
gitbook 的基本用法非常簡單,基本上就只有兩步:
使用 gitbook init 初始化書籍目錄;
使用 gitbook serve 編譯書籍;
初始化後,book目錄內容如下:mkdir book
cd book
gitbook init
readme.md 和 summary.md 是兩個必須檔案,readme.md 是對書籍的簡單介紹:book/
├── readme.md
└── summary.md
summary.md 是書籍的目錄結構。內容如下:# cat book/readme.md
# introduction
this is my first book.
書籍目錄結構建立完成以後,就可以使用# 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檔案的相應行中...