macOS で Gitbook を利用する

macOS で Gitbook が使えるようにする方法を記述します。

環境

• macOS Big Sur バージョン 11.2.3

準備

• 以下の投稿を参考に Node.js を事前にインストールします。

macOS に Homebrew、nodebrew、Node.js をインストール

gitbook-cliのインストール

• インストールするには、以下のコマンドをターミナルで実行します。

npm install --global gitbook-cli

gitbook-plugin-umlのインストール

• インストールするには、以下のコマンドをターミナルで実行します。

npm install gitbook-plugin-uml

graphvizのインストール

• インストールするには、以下のコマンドをターミナルで実行します。

brew install graphviz

不具合対応

• このままだとGitbookを利用すると以下のエラーが発生します。

/Users/ユーザ名/.nodebrew/node/v14.16.1/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287
      if (cb) cb.apply(this, arguments)
                 ^

TypeError: cb.apply is not a function
    at /Users/ユーザ名/.nodebrew/node/v14.16.1/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js:287:18
    at FSReqCallback.oncomplete (fs.js:184:5)

• これを解決するには、次のティレクトリに移動します。

cd ~/.nodebrew/current/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/

• そして、graceful-fsをv4.2.0にダウングレードします。

npm install graceful-fs@4.2.0 --save

Gitbookの利用

• これで、Gitbookが利用できるようになりました。
• gitbook-cli の使い方はオフィシャルサイトの How to use it? で確認できます。
• 以下に主要な gitbook コマンドを記載します。

gitbook init
gitbook install
gitbook serve
gitbook build