Windows で Gitbook + mathjax を使った文書作成
Gitbook は Markdown 形式で書かれた文書から HTML や PDF, EPUB, MOBI 形式の作成が行えるツールです。 ここでは Windows で環境を構築する方法を解説します。
Node.js のインストール
まず、Node.js が必要です。以下のサイトから LTS 版をダウンロードします。
ダウンロードしたファイルを実行してインストールします。 インストール先はデフォルトのままで構いません。
gitbook-cli のインストール
gitbook をコマンドで実行するために gitbook-cli
をインストールします。
コマンドプロンプトを開いて以下のコマンドを実行します。
npm install -g gitbook-cli
gitbook-cli 自体は gitbook を含んでいません。 gitbook の機能を使うときに自動でイン ストールされます。そこで適当なサブコマンドを実行してインストールします。
gitbook help
テストしてみる
サンプルとして以下の文書をビルドしてみます。
適当なフォルダを作成します。 git が使えるなら clone します。
git clone https://github.com/GitbookIO/javascript
git が使えない場合はリンク先から Clone or download > Download Zip
でダウンロードします。
パスを javascript に設定して以下のコマンドを実行します。
gitbook serve
ビルドが開始され Serving book on http://localhost:4000
と出たら成功です。
ブラウザで http://localhost:4000
を開いて確認してみます。
Mathjax を使う
gitbook のプラグインとして mathjax が使用できます。 新規にフォルダを作成して新しい文書を作成しましょう。 適当なフォルダを作成してパスを通し、以下のコマンドを実行します。
gitbook init
実行するといくつかのファイルが生成されます。そのまま gitbook serve
を実行して動作確認しておきます。