GitBook

概要

　GitBookはマークダウン言語を取り扱うモジュールだそうです。最近よく見かけるReadme.mdとかっていうテキストはコレです。マークダウンね。MarkDownでmd。

　

導入

npm install -g gitbook-cli

Node.jsをインストールして、上記コマンドでいける。Node.jsとnpmのバージョンが一致してないとダメなので、以下の手順を踏むと確実にNode.jsとnpmを一致させれるらしいです。

まず。Nodistをインストールする。パスは自動で設定されるとの噂だったが、自分は手動で実施しました。[スタート]-[⚙(はぐるま)]。表示されたウィンドウの左側のビューの一番下[詳細情報]。表示された右側コンテンツの一番下あたり[システムの詳細設定]。表示されたダイアログの[環境変数]。さらに表示されるウィンドウの下側のシステムの環境変数領域にあるpathという既存項目の行を選択した状態から[編集]ボタンをおして、[追加]で

C:\Program Files (x86)\Nodist\bin

　のようなインストールパスを入力して[OK]ボタンとかで適用させながらウィンドウを閉じまくります。その後、いかのような合わせこみコマンドが使えるようになっていますので、やっておきましょう。通常はこの操作はしなくても、マッチしている状態の人が多いので、いらないかもしれないです。したらばNodistいらんやん。容量食うし。あとあと不具合がおこったときだけでええやん。ええやん。そうです。無駄にインストールしたかもしれないNodistによる合わせこみは以下のコマンドです。

nodist npm match

　そして、コマンドプロンプトでカレントディレクトリを作業用のディレクトリとかに移動させるべく、以下のコマンドを使います。

cd C:\
mkdir GitBook
cd GitBook

　とします。そして、

gitbook init

　とするそうな。

ここで人によっては不具合がでるらしい。こんなエラー。

>gitbook init
Installing GitBook 3.2.3
C:\Users\ユーザ名\AppData\Roaming\npm\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 C:\Users\ユーザ名\AppData\Roaming\npm\node_modules\gitbook-cli\node_modules\npm\node_modules\graceful-fs\polyfills.js:287:18
    at FSReqCallback.oncomplete (node:fs:208:5)

Node.js v18.12.0

　これは、graceful-fsのバージョンがあやしいことが原因だそうで、まずはディレクトリ移動しておいて、

cd C:\Users\ユーザ名\AppData\Roaming\npm\node_modules\gitbook-cli\node_modules\npm\node_modules\

　こうらしいです。

npm install graceful-fs@4.2.0 --save

　したらば、

cd c:\GitBook
gitbook init

　で初期化。してみる。うまくいくかな。

TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of Promise

　はい。だめでした～。バージョン的に無理みたいな議論が巻き起こっているようです。12.18(LTS)を使ったらええやんみたいなことでした。やってみます。おらおらおらー！