ch01.md

Re:VIEW プロジェクト内でシームレスに Markdown ファイルを使う

pandoc2review を使って Re:VIEW プロジェクト内でシームレスに Markdown ファイルを原稿データとして使うことに挑戦してみます。

といっても、やり方はとても簡単です。

このプロジェクトフォルダ (https://github.com/kmuto/pandoc2review/tree/main/samples/reviewsample) をコピーして中身を加工するか、review-init 等で作成した適当なプロジェクトフォルダに少し手を加えるだけで実現できます。

セットアップ

1. pandoc2review の実行セットである pandoc2review フォルダにパスを通しておきます。
2. lib/tasks/z01_pandoc2review.rake をプロジェクトフォルダの lib/tasks にコピーします。
3. 章単位で Markdown ファイルを作ります (たとえば ch01.md)。プロジェクト内では ch02.re など普通の Re:VIEW ファイルと混ぜることもできます。
4. catalog.yml に .md → .re に名前を変えた形で登録します。
5. rake pdf、rake epub などを実行します。

画像は images フォルダに以下のどちらかで配置しておいてください。

• images/〜 と直下に置く
• images/ch01/〜 とサブフォルダを作る

仕組み

rake コマンドを呼び出したとき、lib/tasks/z01_pandoc2review.rake が手順に追加されます。この中で catalog.yml を解析し、re ファイルがあればそれを _refiles フォルダにコピーし、拡張子違いの md ファイルがあれば pandoc2review コマンドで変換して _refiles フォルダに *.re ファイルとして書き出します。簡単！

Re:VIEW 的なものを入れる例

• span で章参照: ch02

変換の例

• Re:VIEW の PDFMaker で TeX を使った印刷版 PDF 化 (rake pdf)
• Re:VIEW の PDFMaker で TeX を使った電子版 PDF 化 (REVIEW_CONFIG_FILE=config-ebook.yml rake pdf)
• Re:VIEW の WebMaker で Web ページ化 (rake web)
• Re:VIEW の EPUBMaker で EPUB 化 (rake epub)
• Re:VIEW の EPUB を単一 HTML ファイルに変換し、CSS 組版 Vivliostyle CLI で PDF 化 (rake epub; review-epub2html book.epub > book.html; vivliostyle --no-sandbox --press-ready -o book.pdf book.html)