Re:VIEW の環境を Docker on WSL にて構築する

前回構築した Docker on WSL の環境に、 Re:VIEW の環境を構築してみたいと思います。（Re:VIEW とは、書籍執筆支援システムです）。
Windows の環境で、なるべく既存環境を汚さずにこのシステムを使いたいために、 Docker の準備を行ったのでした。

Re:VIEW インストール

Docker on WSL の環境構築が終わっていない場合には、前回までの内容を参照して準備を行います。
ここでは Docker を起動してある状態で以下のコマンドを実行します。

$ sudo docker pull vvakame/review:2.5

2.5: Pulling from vvakame/review
683abbb4ea60: Downloading [=========================>                         ] 11.49 MB/22.5 MB
800dcfa67407: Downloading [===========>                                       ] 7.548 MB/33.73 MB
ca460f9330ef: Download complete
8122d02a6364: Download complete
aa6ad19f8fb9: Downloading [>                                                  ] 5.336 MB/427.5 MB
fb54b0accc3b: Waiting
12a19f400238: Waiting
f95b169116fd: Waiting
554e91cd0732: Waiting
05797b07953b: Waiting
4e25de6a60f2: Waiting
f26311cdcf75: Waiting
48963c5698d6: Waiting

とりあえず C:\myworks というフォルダ以下にサンプルを作成してみることにします。 WSL 環境下では Windows のドライブは /mnt 以下にマウントされているように見えるので、 /mnt/c/myworks というフォルダとなります。
このフォルダを、 docker review の作業ディレクトリにマウントするようにします。

これらを実行するコマンドは以下のようになります。

$ mkdir -p /mnt/c/myworks
$ sudo docker run -v /mnt/c/myworks:/work -it vvakame/review:2.5 /bin/sh
# 

実行すると、 docker review 環境に入ります。プロンプトが “#” に変わっていると思います。
ここで、 Windows の作業フォルダを /work に割り当てているのでここにカレントを切り替えて、以下のコマンドを実行してひな形を作成してみます。

# cd /work
# review-init sample-doc

すると myworks 以下に sample-doc フォルダが作成され、以下のようなディレクトリ構造ができていると思います。

このひな形のファイル群から pdf を作成するために、以下のコマンドを実行します。

# cd sample-doc
# review-pdfmaker config.yml

処理が完了すれば、 book.pdf というファイルが作成されていると思います。

VSCode に Re:VIEW プラグインを入れる

せっかくなので VisualStudio Code に Re:VIEW のプラグインを入れて、作業環境の完成を目指します。

プラグインは、 以下のものを入れました。prh は校正のツールとなっています。おそらく一緒に使うことになるだろうとのことでインストールしてしまいました。

• Re:VIEW (atsushieno 作)
• prh (vvakame 作)

これらのプラグインにより、 VSCode で文章を作成中に Re:VIEW のマークアップがシンタックスハイライトされます。また、プレビュー機能が有効となります。手元で確認している限りではテーブルがうまく表示されないようで、、再現率はまあまあっぽいです。

コンパイル?手順

Re:VIEW の各ファイル群から Docker コンテナを使っての pdf 生成処理（＝コンパイル）について説明します。プラグインで、何らかのショートカットがあるかなと思いましたが、現時点ではそこまでではないようです。とりあえず手動でコマンドを打ち込んで pdf を生成させてみます。

WSL のいいところは PowerShell のコンソールからでも、 bash のシェルを始められることだったりします。そして、 VSCode にはウィンドウの中に、 ターミナルのペインも備えています。

このターミナルで以下のコマンドを実行して Docker コンテナを稼働させます。

bash -c 'sudo docker run -v /mnt/c/myworks:/work -it vvakame/review:2.5 /bin/bash'

これで先ほどの状況と同じく、 review でコンパイルできる状態になります。先ほどと同様のコマンドをここで実行して、 pdf を生成させます。

cd /work/sample-doc && review-pdfmaker config.yml

まとめ

Docker を用いて Re:VIEW の環境を構築しつつ、 VisualStudio Code をエディタとして使う例を取り上げました。