前言
一些自己實(shí)際操作的記錄。
一、安裝準(zhǔn)備
- Node.js
gitbook基于Node.js，所以需要提前安裝。
下載地址：https://nodejs.org/en/，可以下載比較新的版本。(但我的建議是不要安裝太高的版本，容易走很多彎路，筆者使用的是10.16.3，后文中提供網(wǎng)盤下載)
建議下載LTS版本（Long Term Support)。
同時(shí)也可以網(wǎng)盤下載（這里的版本為10.16.3 LTS）：
鏈接: https://pan.baidu.com/s/1JZLRn5EhICmsn-pLm-6Z_g 提取碼: 4grf
雙擊打開后，一直點(diǎn)「繼續(xù)」即可。
安裝完成后：使用node -v可以查看版本號。
二、GitBook安裝
運(yùn)行命令：
sudo npm install -g gitbook-cli
建議科學(xué)上網(wǎng)，速度比較快，不懂怎么科學(xué)上網(wǎng)的朋友們可以私聊我，我可以教學(xué)。
運(yùn)行命令查看是否安裝成功：sudo gitbook -V
但出現(xiàn)報(bào)錯(cuò)：（主要是因?yàn)镹ode.js版本較高，可以嘗試降低版本，推薦10.x.x）
但無需擔(dān)心，只需要修改對應(yīng)的內(nèi)容就好：
首先進(jìn)入到報(bào)錯(cuò)的文件中：
sudo vi /usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js
找到下面這三行，注釋掉。具體可以參考：https://flaviocopes.com/cb-apply-not-a-function/
重新運(yùn)行sudo gitbook -V，低版本應(yīng)該會比較順利，控制臺輸出以下內(nèi)容：
CLI version: 2.3.2
Installing GitBook 3.2.3
gitbook@3.2.3 ../../../../../../../../../var/folders/kj/qbpckysx1_924y0nhd59nd5r0000gn/T/tmp-16645XKlrWUKvHqkG/node_modules/gitbook
├── escape-html@1.0.3
├── escape-string-regexp@1.0.5
├── ignore@3.1.2
├── destroy@1.0.4
├── bash-color@0.0.4
├── gitbook-plugin-livereload@0.0.1
├── cp@0.2.0
├── graceful-fs@4.1.4
├── nunjucks-do@1.0.0
├── github-slugid@1.0.1
├── direction@0.1.5
├── q@1.4.1
├── spawn-cmd@0.0.2
├── gitbook-plugin-fontsettings@2.0.0
├── open@0.0.5
├── is@3.3.0
├── object-path@0.9.2
├── extend@3.0.2
├── json-schema-defaults@0.1.1
├── gitbook-plugin-search@2.2.1
├── jsonschema@1.1.0
├── crc@3.4.0
├── urijs@1.18.0
├── semver@5.1.0
├── immutable@3.8.2
├── front-matter@2.3.0
├── npmi@2.0.1 (semver@4.3.6)
├── resolve@1.1.7
├── gitbook-plugin-theme-default@1.0.7
├── tmp@0.0.28 (os-tmpdir@1.0.2)
├── dom-serializer@0.1.0 (domelementtype@1.1.3, entities@1.1.2)
├── moment@2.13.0
├── gitbook-plugin-sharing@1.0.2 (lodash@3.10.1)
├── error@7.0.2 (string-template@0.2.1, xtend@4.0.2)
├── mkdirp@0.5.1 (minimist@0.0.8)
├── i18n-t@1.0.1 (lodash@4.17.21)
├── omit-keys@0.1.0 (isobject@0.2.0, array-difference@0.0.1)
├── send@0.13.2 (range-parser@1.0.3, statuses@1.2.1, fresh@0.3.0, etag@1.7.0, ms@0.7.1, depd@1.1.2, mime@1.3.4, debug@2.2.0, http-errors@1.3.1, on-finished@2.3.0)
├── js-yaml@3.14.1 (esprima@4.0.1, argparse@1.0.10)
├── rmdir@1.2.0 (node.flow@1.2.3)
├── fresh-require@1.0.3 (is-require@0.0.1, shallow-copy@0.0.1, astw@1.3.0, sleuth@0.1.1, acorn@0.9.0, through2@0.6.5, escodegen@1.14.3)
├── gitbook-plugin-lunr@1.2.0 (html-entities@1.2.0, lunr@0.5.12)
├── gitbook-plugin-highlight@2.0.2 (highlight.js@9.2.0)
├── cheerio@0.20.0 (entities@1.1.2, css-select@1.2.0, htmlparser2@3.8.3, jsdom@7.2.2, lodash@4.17.21)
├── cpr@1.1.1 (rimraf@2.4.5)
├── tiny-lr@0.2.1 (parseurl@1.3.3, livereload-js@2.4.0, qs@5.1.0, debug@2.2.0, faye-websocket@0.10.0, body-parser@1.14.2)
├── gitbook-markdown@1.3.2 (kramed-text-renderer@0.2.1, gitbook-html@1.3.3, kramed@0.5.6, lodash@4.17.21)
├── gitbook-asciidoc@1.2.2 (gitbook-html@1.3.3, lodash@4.17.21, asciidoctor.js@1.5.5-1)
├── request@2.72.0 (tunnel-agent@0.4.3, aws-sign2@0.6.0, oauth-sign@0.8.2, forever-agent@0.6.1, caseless@0.11.0, is-typedarray@1.0.0, stringstream@0.0.6, aws4@1.12.0, isstream@0.1.2, json-stringify-safe@5.0.1, tough-cookie@2.2.2, node-uuid@1.4.8, qs@6.1.2, combined-stream@1.0.8, mime-types@2.1.35, bl@1.1.2, hawk@3.1.3, form-data@1.0.1, http-signature@1.1.1, har-validator@2.0.6)
├── read-installed@4.0.3 (debuglog@1.0.1, util-extend@1.0.3, slide@1.1.6, readdir-scoped-modules@1.1.0, read-package-json@2.1.2)
├── npm@3.9.2
├── juice@2.0.0 (deep-extend@0.4.2, slick@1.12.2, batch@0.5.3, cssom@0.3.1, commander@2.9.0, cross-spawn-async@2.2.5, web-resource-inliner@2.0.0)
├── chokidar@1.5.0 (path-is-absolute@1.0.1, async-each@1.0.6, inherits@2.0.4, glob-parent@2.0.0, is-binary-path@1.0.1, is-glob@2.0.1, fsevents@1.2.13, anymatch@1.3.2, readdirp@2.2.1)
└── nunjucks@2.5.2 (asap@2.0.6, yargs@3.32.0, chokidar@1.7.0)
GitBook version: 3.2.3
再運(yùn)行：sudo gitbook -V，應(yīng)該就顯示正常的版本號了：
LI version: 2.3.2
GitBook version: 3.2.3
現(xiàn)在開始可以使用GitBook了。
三、項(xiàng)目初始化
可以自己新建一個(gè)目錄，進(jìn)入到該目錄下，執(zhí)行命令：文章來源：http://www.zghlxwxcb.cn/news/detail-824662.html
~ mkdir myGitBook && cd myGitBook ? │ base Py │ at 22:54:27
~/myGitBook gitbook init ? │ base Py │ at 22:54:46
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished
會生成兩個(gè)md文檔，README.md 是對書籍的簡單介紹， SUMMARY.md 是書籍的目錄結(jié)構(gòu)。
然后可以通過gitbook serve編譯成html格式，完成以后會打開一個(gè) web 服務(wù)器，監(jiān)聽在本地的 4000 端口。
這樣gitbook就初步搭建完成了。文章來源地址http://www.zghlxwxcb.cn/news/detail-824662.html
到了這里，關(guān)于mac安裝部署gitbook教程的文章就介紹完了。如果您還想了解更多內(nèi)容，請?jiān)谟疑辖撬阉鱐OY模板網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持TOY模板網(wǎng)！
