GitBook 安裝使用,及遇到的坑 Mac下

2021-08-27 23:15:31 字數 3757 閱讀 2440

1、安裝gitbook命令列

[code]

$ npm install -g gitbook-cli

[/code]

2、檢視是否安裝成功

[code]

$ gitbook -v

[/code]

3、開始使用

(1)初始化

[code]

$ mkdir test_gitbook

$ cd test_gitbook

$ touch readme.md

$ touch summary.md

$ vi summary.md

* [簡介](readme.md)

* [第一章](chapter1/readme.md)

- [第一節](chapter1/section1.md)

- [第二節](chapter1/section2.md)

* [第二章](chapter2/readme.md)

- [第一節](chapter2/section1.md)

- [第二節](chapter2/section2.md)

* [結束](end/readme.md)

[/code]

(2)生成目錄結構

[code]

$ gitbook init

[/code]

(3)檢視目錄結構

[code]

$ tree

.├── readme.md

├── summary.md

├── chapter1

│   ├── readme.md

│   ├── section1.md

│   └── section2.md

├── chapter2

│   ├── readme.md

│   ├── section1.md

│   └── section2.md

└── end

└── readme.md

[/code]

(4)本地預覽

[code]

$ gitbook serve .

[/code]

這一步可能會報錯

[code]

(node:12474) fs: re-evaluating native module sources is not supported. if you are using the graceful-fs module, please update it to a more recent version.

(node) v8::objecttemplate::set() with non-primitive values is deprecated

(node) and will stop working in the next major release.

[/code]

檢視node版本

[code]

$ node -v

v6.0.0

[/code]

原因是:graceful-fs 在 node v6 下不支援,需要降級

[code]

$ brew tap homebrew/versions

$ brew unlink node

$ brew install homebrew/versions/node5

$ node -v

v5.11.1

[/code]

ps:如果需要使用node 6.0

[code]

brew unlink homebrew/versions/node5

brew link node

[/code]

切回5.11

[code]

brew unlink node

brew link homebrew/versions/node5

[/code]

好了,繼續執行

瀏覽器開啟 http://localhost:4000

可以看到效果啦

這時可以看到當前目錄下多了個資料夾

_book

這個檔案裡面是靜態**內容

生成靜態**到指定目錄

[code]

gitbook build . ./mysite

[/code]

(5)gitbook 常用命令

[code]

$ gitbook -h

usage: gitbook [options] [command]

commands:

build [options] [source_dir] 編譯指定目錄,輸出web格式(_book資料夾中)

serve [options] [source_dir] 監聽檔案變化並編譯指定目錄,同時會建立乙個伺服器用於預覽web

pdf [options] [source_dir] 編譯指定目錄,輸出pdf

epub [options] [source_dir] 編譯指定目錄,輸出epub

mobi [options] [source_dir] 編譯指定目錄,輸出mobi

init [source_dir] 通過summary.md生成作品目錄

options:

-h, --help output usage information

-v, --version output the version number

[/code]

(6)gitbook 生成pdf

[code]

$ gitbook pdf . mypdf.pdf

error: need to install ebook-convert from calibre

[/code]

安裝完成後

[code]

[/code]

再次執行

[code]

$ gitbook pdf . mypdf.pdf

[/code]

會在當前目錄下生成 mypdf.pdf

(7)使用 gitbook editor 製作電子書

這個就不再贅述了。

Gitbook 安裝遇到的問題

首先確保你的電腦上安裝了nodejs 官網 安裝了nodejs後,開啟dos命令視窗,輸入以下兩條命令 npm install gitbook g npm intsall gitbook cli g 輸入gitbook v,檢視是否安裝成功。1.gitbook 不是內部或外部命令,也不是可執行的程式...

gitbook 安裝使用

gitbook 安裝 1.nodejs安裝,安裝完成之後更改npm源 臨時使用其他源 npm registry taobao org install express 永久使用 npm config set registry taobao org可以參考印象筆記 npm映象 一節 然後npm 安裝gi...

gitbook的安裝使用

安裝gitbook cli工具npm install gitbook cli g 初始化一本書 gitbook init會在空專案中建立readme.md和summary.md兩個檔案 mkdir book cd book 然後使用gitbook init來初始化一本書 gitbook init 本...