GitBook

提供:yonewiki
2022年11月11日 (金) 18:47時点におけるYo-net (トーク | 投稿記録)による版 (ページの作成:「== '''概要''' ==  GitBookはマークダウン言語を取り扱うモジュールだそうです。最近よく見かけるReadme.mdとかっていうテキストはコレです。マークダウンね。MarkDownでmd。   == '''導入''' == npm install -g gitbook-cli Node.jsをインストールして、上記コマンドでいける。Node.jsとnpmのバージョンが一致してないとダメなので、以下の手順を踏むと確実にNode.jsと…」)
(差分) ← 古い版 | 最新版 (差分) | 新しい版 → (差分)

概要

 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

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