【技術書作成の強い味方！】「Re:VIEW starter」に辿り着くまで：息子と一緒に Makers：So-netブログ

	ブログをはじめるログイン

【コロナ禍】まだまだ続くよ在宅勤務｜【悲報】新型コロナの抗体は長続きしない可.. ブログトップ

【技術書作成の強い味方！】「Re:VIEW starter」に辿り着くまで　[徒然日記] [編集]

仕事でちょっとした技術書を作らねばならず、”github でコンテンツを管理できて、印刷用に出力できる超見栄えのいいドキュメントツールはないかな” と探していたところ、「Re:VIEW」というツールを見つけました。

2020-06-19 (13).png

https://github.com/kmuto/review

早速、Rubyをインストールして Re:VIEW を入れてみました。確かに見栄えはいい。しかし、自分好みにレイアウトに少しだけ変更したいなと思っても、サンプルもほとんどなく手も足も出ません。

それならばと、「vivlostyle」という HTML+CSS で組版ができるツールを見つけたました。ブラウザベースで編集できて印刷レベルにも耐えられるということで、なんか良さそうです。

2020-06-19 (14).png

https://vivliostyle.org/ja/

が、実際に使ってみると、ソースがHTMLなので、変更管理が簡単ではありません。しかも、私がやりたいのは章の見出しにちょっとした飾りをつけるとかその程度。それでHTML+CSSは大げさです。

TeXをベースとしたRe:VIEWはコンテンツの管理には最適なので、Re:VIEW+CSS組版のものも試してみましたが、思うようなアウトプットができず…（私の使い方が悪いのだと思いますが）

で、途方に暮れWORDで作るか？と諦めかけていたところに、私のRe:VIEWに対するぼやきのツイートに @_kauplan さんから返信がありました。（なぜか返信が通知されず、気付くのが遅れました。失礼しました…）

Re:VIEWよりもわかりやすいもの、あります。https://t.co/4QnW80nXuR
まあ、これでも初見の人には厳しいことありますが。
— カウプラン機関極東支部@新刊執筆開始 (@_kauplan) June 17, 2020

それでは使ってみようということで早速試してみました。最初に次のサイトにアクセスしウィザード形式で質問に答えていきます。

https://kauplan.org/reviewstarter/

このウィザードの中で所望していた簡単なレイアウトの変更もできます。

2020-06-19 (6).png

最後のページにReVIEWのファイルをコンパイルする方法が記述されています。

2020-06-19 (11).png

早速ドキュメントのプロジェクトをダウンロードし、ReVIEW文書を作ってみました。私のマシンには、Dockerがインストールされていますので、Dockerを使ってコンパイルしてみました。

$ cd taro-meets-review
$ docker run --rm -v $PWD:/work kauplan/review2.5 /bin/bash -c "cd /work; rake pdf"
rake aborted!
No Rakefile found (looking for: rakefile, Rakefile, rakefile.rb, Rakefile.rb)
/var/lib/gems/2.5.0/gems/rake-13.0.1/exe/rake:27:in `'
(See full trace by running task with --trace)

が、”Rakefileがねぇ！”と言われて弾かれてしまいます。

そこで、docker ではなく、docker-compose を使ってみたらどうかなと思い、"taro-meets-review"ディレクトリに次の２つのファイルを追加しました。

■ Dockerfile

FROM kauplan/review2.5

■ docker-compose.yml

version: '3'
services:
  review:
    volumes:
      - .:/work
    build: .
    working_dir: /work
    ports:
      - "127.0.0.1:18000:18000"

上記の２つのファイルを保存し、docker-compose でコンパイルしてみました。メッセージが沢山出てくるので、うまく動いたようです。

$ cd taro-meets-review
$ docker-compose run --rm review rake pdf
compiling chap00-preface.tex
compiling chap01-starter.tex
WARN: warning: duplicate ID: tw-icon (#)
compiling chap02-faq.tex
compiling chap99-postscript.tex
... snip ...
[pdfmaker]$ /usr/bin/ruby2.5 /work/lib/hooks/beforetexcompile.rb /work/taro-meet
s-review-pdf /work

mktexpk: /root/.texlive2017/texmf-var/fonts/pk/ljfour/public/boisik/bskarr10.480
pk already exists.

1420345 bytes written

ディレクトリを見ると、”taro-meets-review.pdf” が出来上がっています。中身を見ると指定したデザインのドキュメントが出来ていました！ラクチンだぁ…

2020-06-19 (12).png