Re:VIEW image for Docker
このリポジトリはDocker上でRe:VIEWを動かすためのものです。
Docker Hubに置いてあるのでご活用ください。 試験的にGitHub Container Registryにも置いてあります。
Windows用の手引はこちらを参考にしてください。 docker-composeを使った時の手引としても使えます。
仕様
サポートしているタグ
Re:VIEWのバージョン毎にイメージを作成しています。
現在存在しているタグは latest, 5.3, 5.4, 5.5, 5.6, 5.7, 5.8 です。
2.3, 2.4 , 2.5, 3.2, 4.2, 5.0, 5.1, 5.2 もDocker Hub上に存在していますが、サポートは終了しています。
$ docker pull vvakame/review:5.8
$ docker pull vvakame/review:5.7
$ docker pull vvakame/review:5.6
$ docker pull vvakame/review:5.5
$ docker pull vvakame/review:5.4
$ docker pull vvakame/review:5.3
$ docker pull ghcr.io/vvakame/review:5.8
$ docker pull ghcr.io/vvakame/review:5.7
$ docker pull ghcr.io/vvakame/review:5.6
$ docker pull ghcr.io/vvakame/review:5.5
$ docker pull ghcr.io/vvakame/review:5.4
$ docker pull ghcr.io/vvakame/review:5.3
インストールされているコマンド
- git
- curl
- TeXLive & 日本語環境
- MeCab （Re:VIEW 索引作成時に利用される）
- Ruby （Re:VIEW 実行環境）
- Node.js & npm （ReVIEW-Template用環境）
- Re:VIEW & rake & bundler
- pandoc
- pandoc2review
他。詳細はDockerfileを参照してください。
TeX周りの初期設定
PDF作成時、原の味フォントをデフォルトで利用し、フォントの埋め込みも行うようになっています。
- IPAフォントを使いたいとき
kanji-config-updmap ipaexを実行する
- Notoフォントを使いたいとき
apt-get install fonts-not-cjk-extraおよびkanji-config-updmap noto-otcを実行する
使い方
次のようなディレクトリ構成を例にします。
├── README.md
└── src
├── catalog.yml
├── config.yml
├── ch01.re
├── ch02.re
├── ch03.re
├── index.re
└── layouts
config.ymlが存在するディレクトリをコンテナ上にマウントする
srcディレクトリにconfig.ymlがある場合
-v `pwd`/src:/work
workディレクトリは任意の名前でよいです。後述のコマンドでcdをする先になります。
-
vvakame/reviewイメージを使用する -
マウントしたディレクトリ内で任意のビルドコマンドを実行する
pdf出力する場合
/bin/sh -c "cd /work && rake pdf"
この例では実行するコマンドは次のようになります。
$ docker run --rm -v `pwd`/src:/work vvakame/review /bin/sh -c "cd /work && rake pdf"
ビルドが終了すると、srcディレクトリ内にpdfファイルが出力されます。