本ドキュメントでは、Windows上で「Re:VIEW image for Docker」を利用し、Re:VIEWドキュメントからPDFおよびEPUBを生成する方法を紹介します。
- Microsoft Windows。本ドキュメントはWindows 10 Homeエディションに基づいています。
- ストレージ内に最低でも2GB以上の空き領域。Re:VIEW image for Dockerをインストールすると1.98GBを使用します。このほかにDockerToolboxなどのツール、ドキュメント自体などを収納するための空き領域も必要です。
- UTF-8を扱うことのできるテキストエディタ。「メモ帳」アプリでもUTF-8形式での保存は可能ですが、実際にドキュメントを執筆・編集するにあたってはより適切で高機能なテキストエディタが必要になるでしょう。Atom、Emacs、秀丸など向けにRe:VIEWをサポートする外部拡張が公開されています（https://github.com/kmuto/review/wiki）。
Dockerは、OSと特定用途のアプリケーションをまとめて「コンテナ」という形にし、それを必要に応じて簡単に呼び出すことができるサービスです。たとえば、Re:VIEW image for DockerはLinux（Ubuntu Linux）とRe:VIEWの動作環境をコンテナ化したものです。Re:VIEWやそれを取り巻くRubyやTeXLiveといった個々のソフトウェアをWindowsにセットアップしようとするとそれだけでもとても面倒な作業ですが、Dockerを使えばそのようなことにわずらわされることなく、すべて揃った状態からRe:VIEWのドキュメント制作を始めることができます。
Windows向けのDockerには、Docker for WindowsとDocker Toolboxという2種類の実装があります。どちらもDockerの開発元であるDocker, Inc.社公式のものですが、前者はWindowsの仮想化支援技術Hyper-Vを利用していて動作も高速なのに対し、後者はVirtualBoxというDockerを動かすためにはオーバーヘッドの大きい仮想化ソフトウェアの上に乗っています。
本来は前者をお勧めしたいところですが、Docker for WindowsにはProfessional以上のWindowsエディションでなければ動作しないという制約があります。一般的な家庭用PCではHomeエディションが使われていると思いますので、本ドキュメントでは後者のDocker Toolboxに基づいて説明します（Docker for Windowsを使える環境にある方は、ぜひそちらを試してみてください）。
まず、https://docker.com/products/docker-toolboxからDocker Toolboxをダウンロードします。macOS版とWindows版がありますが、Windowsマークのあるほうをダウンロードしましょう。
ダウンロードした「DockerToolbox.exe」を実行します。Windowsインストール向けの署名がないようで「この不明な発行元からのアプリがデバイスに変更を加えることを許可しますか?」というダイアログが出るかもしれません。［はい］を押して先に進みます。
セットアップウィザードのダイアログが表示されます。
基本的にそのまま［Next>］をクリックしていくだけでよいでしょう。
- 「Help Docker improve Toolbox.」: Docker社がインストール障害などの情報を収集することの可否。絶対に嫌であればチェックを外す。
- 「Setup will install Docker Toolbox into the following folder.」： Dockerプログラムのインストール先フォルダ。
- 「Select Components」: インストールするDockerコンポーネントの選択。下手にいじるとDockerが正常に動かなくなる可能性のほうが高い。
- 「Select Additional Tasks」: デスクトップショートカットやパスの追加など。あえて変える必要はないはず。「Install VirtualBox with NDIS5 driver」もチェックを外したままでよい。
［Install］を選び、インストールを実行します。
途中、VirtualBoxのハードウェアドライバのインストールを要求されるので、ダイアログに従って「インストール」をクリックして進めていきます。
セットアップが終わったら［Finish］ボタンを押して閉じます。
エクスプローラでDockerプログラムのウィンドウが開かれている（スタートメニューにも登録されています）ので、「Docker Quickstart Terminal」を実行します。Dockerサービスが起動し、Dockerのイメージキャラクタであるクジラと、シンプルなコマンドプロンプトが提示されます。以降、このコマンドプロンプトの画面を便宜上「Dockerターミナル」と呼ぶことにします。最初の起動では、途中でVirtualBox Interfaceのデバイス変更許可を求められるかもしれません。その場合は［はい］を押して許可してください。
これでDocker自体のセットアップは完了です。
続いて、Re:VIEW image for Dockerを利用するための設定に進みます。
ここでは「ドキュメント」フォルダに「work」というサブフォルダを用意して、その中で各Re:VIEWドキュメントフォルダを管理するという想定で進めます。
PC
└─ドキュメント（Documents）
└─work
├─Dockerfile
├─docker-compose.yml
├─sampledoc
│ ├─Dockerfile
│ ├─docker-compose.yml
│ ├─sampledoc.re
│ └……
└……
docker-composeの制約と思われますが、途中に空白のあるパスだとこのあとの実行に失敗します。「ドキュメント」フォルダはいわゆる「My Documents」（これは空白を含むので失敗します）のほか、「Documents」という名前でも参照できるので、その名前をここでは使います。
エクスプローラでドキュメントフォルダ内にworkフォルダを作ったら、次の2つのファイル「Dockerfile」「docker-compose.yml」をテキストエディタを使って作成し、workフォルダ内に配置します（メモ帳で作成した場合は拡張子.txtとなっているのをエクスプローラで修正してください）。
Dockerfile
FROM vvakame/review
docker-compose.yml
version: '3'
services:
review:
volumes:
- .:/work
build: .
working_dir: /work
ports:
- "127.0.0.1:18000:18000"
docker-compose.ymlの行頭インデントの違いは重要です。本ドキュメントからコピーペーストして使ってもよいでしょう。
次にDockerターミナルで操作します。WindowsのGUIに慣れているとおどろおどろしいDockerターミナルですが、実際利用するコマンドの数はさほど多くはありません。このDockerターミナルはMinGWという小さなUnix互換環境になっており、Unixの一般的なコマンドを利用できます。
まず、作成したworkフォルダに移動します。次のように入力し、Enterを押します。
cd ~/Documents/work
次に、Dockerコンテナの元となる「Dockerイメージ」をダウンロードします。同様に次のように入力してEnterを押してください。
docker pull vvakame/review
このダウンロードと展開にはかなり時間がかかりますが、安定したネットワーク環境であれば特に問題なく終了するでしょう。
これでWindowsでRe:VIEWを利用する準備は完了です！
workフォルダ内（cd ~/Documents/workをした状態）で、docker-composeコマンドを使ってRe:VIEWの各コマンドを呼び出せます。
review-initコマンドはRe:VIEWドキュメントの雛型を作るコマンドです。新規に「sampledoc」を作ってみましょう。Docker経由で呼び出すには、Dockerターミナルで次のように実行します。
docker-compose run --rm review review-init sampledoc
- 「docker-compose」は「docker-compose.exe」としても構いません。「docker-」と入力してTabキーを押せば補完されるでしょう。
- 「run」はDockerコンテナで指定のコマンドを実行して終了する、という指令です。
- 「--rm」は終了後にコンテナを削除するオプションです。
- 「review」が使用するDockerイメージとなります。
- 「review-init sampledoc」がDockerコンテナの上で実行されるRe:VIEWコマンドです。sampledocという名前の新規フォルダを作業フォルダ（work）内に作り、Re:VIEWドキュメントに必要な初期ファイル群を展開します。
展開されたsampledocフォルダ内は次のようになっています。
この中の各ファイルについての詳細は、Re:VIEW Quick Start GuideやRe:VIEW Format Guide、その他https://github.com/kmuto/review/wikiにある各ドキュメントを参照してください。
次に、エクスプローラなどでworkフォルダにあるDockerfileファイルとdocker-compose.ymlファイルをこのsampledocフォルダにコピーしてください。エクスプローラの代わりにDockerターミナル上で次のように実行することでもコピーできます。
cp docker-compose.yml Dockerfile sampledoc
コンテンツを書き込むsampledoc.reファイルに、テキストエディタを利用して適当なテキストを書き込んでみることにします。
ここではメモ帳を使っていますが、冒頭で述べたとおり、より適切なテキストエディタを使ったほうがよいでしょう。また、保存時には文字エンコーディングを「UTF-8」にしておく必要があります。
では、PDFを生成してみましょう。まず、sampledocフォルダに移動する必要があるので、次のようにDockerターミナルで実行して移動します。
cd ~/Documents/work/sampledoc
PDFを生成するためには次のようにDockerターミナルで実行します。
docker-compose run --rm review rake pdf
「rake pdf」がPDFを生成するコマンドです（内部ではreview-pdfmaker config.ymlというRe:VIEWコマンドが呼び出されています）。
sampledoc.reにエラーがなければ、sampledocフォルダにbook.pdfというPDFファイルが生成されます。
Acrobat ReaderでPDFを開いてみます。
EPUBを生成するのもほぼ同じで、次のようにDockerターミナルで実行します。「rake epub」がEPUBを生成するコマンドです（内部ではreview-epubmaker config.ymlが呼び出されます）。
docker-compose run --rm review rake epub
book.epubというEPUBファイルが生成されるので、Google Chromeブラウザの拡張機能であるReadiumでこのファイルを開いてみます。
このように、同じコンテンツからPDFとEPUBという2つの形式のファイルを作成できました！
Re:VIEWイメージの特定バージョンを使用するには、Dockerfileをたとえば以下のようにします（ここではタグ名「4.0」が打たれているイメージを使うことになります）。
FROM vvakame/review:4.0
ただ、Dockerfileの指定でうまくいかなかったというケースもあるようです。そのようなときは、docker-compose.ymlのimageパラメータにイメージ名を明示指定してみてください。
version: '3'
services:
review:
image: vvakame/review:4.0
volumes:
- .:/work
build: .
working_dir: /work
docker-composeコマンドの詳細については、https://docs.docker.com/compose/などを参照してください。
- docker-compose ps: 実行/停止中のDockerコンテナを一覧する
- docker-compose rm コンテナID: Dockerコンテナを削除する
- docker-compose images: Dockerイメージを一覧する
- docker-compose pull: Dockerイメージを更新する
コンテンツ内に動的生成をしているものがあるなどの理由でネットワークを使う必要がある場合は、次の指定をdocker-compose.yml末尾に加えます。
networks:
default:
external:
name: bridge
Re:VIEW 4.0以降では、Re:VIEWドキュメントの雛型作成時に、WebインターフェイスでTeXの紙面レイアウトが可能です。これにはreview-initコマンドの実行時に-wオプションを付けます。また、Dockerコンテナ内とホストとのポートの結び付けをdocker-compose runの実行でも有効にするために--service-portsオプションも指定します。
docker-compose run --rm --service-ports review review-init -w sampledoc
Webブラウザでhttp://localhost:18000を開くと、紙面レイアウトを設定できます。