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
を実行して動作確認しておきます。
プラグインの追加
book.json
にプラグインを記述することができます。
gitbook init では作成されませんので、新規に作成します。
プラグインの指定は plugins
で行います。
mathjax を使う場合は以下のようになります。
{
"plugins":["mathjax"]
}
VisualStudio 2015 のインストール
mathjax を使うためにはビルド環境が必要です。 VisualStudio の最新版である 2015 を入れます。
上記のサイトから Community 版をダウンロードしてインストールします。 デフォルトのままでは必要なファイルがインストールされませんので、カスタムインストールします。
インストールの種類を選択するときに カスタム
を選択します。
プログラミング言語 > Visual C++ > Visual C++ 2015 用の共通ツール
にチェックを入れます。
それ以外はチェックをはずしても問題ありません。
インストール先はデフォルトのままで構いません。
インストールには時間がかかりますので、待ちましょう。