review 3.0.0.preview2 → 3.0.0.preview3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0e6427ee4da1631d65d87c3dbed0f7baa22c0b5fe87567db48dcc7f8634d8dba
-  data.tar.gz: f841605f6d137462bc72a8693c28bd29dbb466b3e17209384d2316f337ab8391
+  metadata.gz: 066e6b67087079a39e24dc5a730b18bb090c1fa92e6d2e5a125ec1c8fc58694a
+  data.tar.gz: 5043bb66d9a605c1edd817f6babff7121de11dd6c1e68d8ab102be77a72a361e
 SHA512:
-  metadata.gz: 1dce795a98d0049b5453ca396428012366d72b69e8a3eb81f0cd71607d0fce535a118b613bdf27060049c3b5a2e9005f6d31bed634c5a0a0a662a45d018045cb
-  data.tar.gz: 4f3afb3e2acf13cd6549044a01aabda05271b35ad8c704333942dfc97661ec03b8e6109e6cd18854b61ffd30c8ec9ce01c56ee827cfb0bb012d79552c4691f79
+  metadata.gz: dc585bb29ed7a24ebc02083d3fb98c2e62dd1c13774a41217ed155aa132c551940b583fddccf0f2c5d8619e9d6fffa667e79239df0eeed15f9a871c8a388408c
+  data.tar.gz: 426205db45b5dbbc557c4c54a1f3b54fda75da331ffb12b7566cdd17a4ef66feb69857c8f0841839743a24f8df89b7ba15a1e9a5d2d46fa3b1931a88c2fd0a38

data/.rubocop.yml

@@ -304,6 +304,9 @@ Layout/DotPosition:
 Layout/EmptyLines:
   Enabled: true
 
+Layout/EmptyLineAfterGuardClause:
+  Enabled: false
+
 Layout/EmptyLinesAroundAccessModifier:
   Enabled: true
 
@@ -427,7 +430,7 @@ Metrics/AbcSize:
 ### shoud be < 25
 Metrics/BlockLength:
   CountComments: false  # count full line comments?
-  Max: 50
+  Max: 62
   Exclude:
     - 'Rakefile'
     - '**/*.rake'
@@ -442,6 +445,9 @@ Naming/AccessorMethodName:
 #Style/BinaryOperatorParameterName:
 #  Enabled: true
 
+Naming/FileName:
+  Enabled: false
+
 Naming/HeredocDelimiterNaming:
   Enabled: false
 

data/NEWS.ja.md

@@ -1,3 +1,52 @@
+# Version 3.0.0 preview 3
+## 新機能
+* PDFMaker: これまでの jsbook.cls クラスファイルをそのまま使用する方法に代わり、紙・電子双方の書籍制作に適するよう拡張した review-jsbook.cls (jsbook.cls 基盤、デフォルト)、および review-jlreq.cls (jlreq.cls 基盤) を導入しました ([#1032],[#1117])
+* EPUBMaker/WEBMaker: `@<m>` や `//texequation` で入れた数式を画像化する imgmath 機能を追加しました ([#868],[#1138])
+
+## 非互換の変更
+* PDFMaker: 前付の開始を宣言する LaTeX 命令 `\frontmatter` を、大扉（titlepage）の後ろから大扉の前に移動しました ([#1128])
+* PDFMaker: coverimage の表紙の貼り付けは、実寸で中央に配置されるようになりました ([#1064],[#1117])
+
+## バグ修正
+* PDFMaker: cover パラメータの扱いの誤りを修正しました ([#1116])
+* PDFMaker: 新しいクラスファイルで、preview 2 で発生していた紙面の偏りを修正しました ([#1090],[#1117])
+
+## 機能強化
+* PDFMaker: LaTeX に渡す `config.yml` の設定パラメータを増やしました ([#1121])
+* PDFMaker: LaTeX 命令 `\begin{document}` の直後に実行されるフックマクロ `\reviewbegindocumenthook`、`\end{document}` の直前に実行されるフックマクロ `\reviewenddocumenthook` を追加しました ([#1111])
+* PDFMaker: 新しいクラスファイルでは版面設計をドキュメントオプションで指定するようになったため、geometry.sty は不要になりました ([#912])
+* PDFMaker: 新しいクラスファイルで、大扉からの通しノンブルをサポートしました ([#1129])
+* `review-init` コマンドにネットワークダウンロードの機能を追加しました。`-p` オプションで zip ファイルの URL を指定すると、生成したプロジェクトフォルダに zip ファイルを展開して上書きします ([#812])
+* PDFMaker: デジタルトンボや隠しノンブルを表現するために外部 TeX パッケージの gentombow パッケージを取り込み、プロジェクトフォルダの sty フォルダにコピーするようにしました ([#1136])
+
+## ドキュメント
+* Kindle 用の電子書籍ファイルを作る方法を doc/customize_epub.ja.md に追記しました ([#1114])
+* サンプルファイルなどにある PDFMaker のデフォルトのドキュメントオプションの例示を新しいクラスファイルに合わせました ([#1115])
+* `review-init` コマンドで展開されるファイルなど、扱いが明示されていなかったファイルについてライセンスを明記しました ([#1093],[#1112])
+* 数式を画像化する `imgmath` について、doc/format.ja.md に追記しました ([#868])
+
+## コントリビューターのみなさん
+* [@munepi](https://github.com/munepi)
+
+[#812]: https://github.com/kmuto/review/issues/812
+[#868]: https://github.com/kmuto/review/issues/868
+[#912]: https://github.com/kmuto/review/issues/912
+[#1032]: https://github.com/kmuto/review/issues/1032
+[#1064]: https://github.com/kmuto/review/issues/1064
+[#1090]: https://github.com/kmuto/review/issues/1090
+[#1093]: https://github.com/kmuto/review/issues/1093
+[#1111]: https://github.com/kmuto/review/pull/1111
+[#1112]: https://github.com/kmuto/review/pull/1112
+[#1114]: https://github.com/kmuto/review/pull/1114
+[#1115]: https://github.com/kmuto/review/issues/1115
+[#1116]: https://github.com/kmuto/review/pull/1116
+[#1117]: https://github.com/kmuto/review/pull/1117
+[#1121]: https://github.com/kmuto/review/pull/1121
+[#1128]: https://github.com/kmuto/review/issues/1128
+[#1129]: https://github.com/kmuto/review/pull/1129
+[#1136]: https://github.com/kmuto/review/issues/1136
+[#1138]: https://github.com/kmuto/review/issues/1138
+
 # Version 3.0.0 preview 2
 
 ## 新機能

data/NEWS.md

@@ -1,3 +1,52 @@
+# Version 3.0.0 preview 3
+## New Features
+* PDFMaker: instead of using jsbook.cls as it is, review-jsbook.cls (based on jsbook.cls, default) and review-jlreq.cls (based on jlreq.cls) are introduced. These supports the creation both paper and electronic PDF books. ([#1032],[#1117])
+* EPUBMaker/WEBMaker: add imgmath function to image mathematical expressions ([#868],[#1138])
+
+## Breaking Changes
+* PDFMaker: the location of `\frontmatter` is moved from the back of the titlepage to the front ([#1128])
+* PDFMaker: the cover image specified by `coverimage` is placed in the actual size and in the center ([#1064],[#1117])
+
+## Bug Fixes
+* PDFMaker: fix an errror handling of `cover` parameter ([#1116])
+* PDFMaker: fix position misalignment in preview 2 ([#1090],[#1117])
+
+## Enhancements
+* PDFMaker: increase the number of `config.yml` configuration parameters to LaTeX macros ([#1121])
+* PDFMaker: add hook `\reviewbegindocumenthook` just after `\begin{document}`, and add hook `\reviewenddocumenthook` just before `\end{document}` ([#1111])
+* PDFMaker: geometry.sty is no longer used, because the new class file can specify the paper design by document option ([#912])
+* PDFMaker: serial-pagination feature is supported in new class files ([#1129])
+* add network download function to `review-init` command. Specifying the URL of the zip file with `-p` option expands the zip file to the project folder ([#812])
+* PDFMaker: For expressing digital trim-marks and hidden page numbers (kakushi-nombre), the gentombow package (the external TeX package) has been included in vendor folder. It will be copied to the sty folder of the project folder ([#1136])
+
+## Docs
+* add a method of making Kindle e-book file to doc/customize_epub.ja.md ([#1114])
+* update examples of PDFMaker's default document options ([#1115])
+* clarify license of each file ([#1093],[#1112])
+* add note about `imgmath` feature to doc/format.ja.md ([#868])
+
+## Contributors
+* [@munepi](https://github.com/munepi)
+
+[#812]: https://github.com/kmuto/review/issues/812
+[#868]: https://github.com/kmuto/review/issues/868
+[#912]: https://github.com/kmuto/review/issues/912
+[#1032]: https://github.com/kmuto/review/issues/1032
+[#1064]: https://github.com/kmuto/review/issues/1064
+[#1090]: https://github.com/kmuto/review/issues/1090
+[#1093]: https://github.com/kmuto/review/issues/1093
+[#1111]: https://github.com/kmuto/review/pull/1111
+[#1112]: https://github.com/kmuto/review/pull/1112
+[#1114]: https://github.com/kmuto/review/pull/1114
+[#1115]: https://github.com/kmuto/review/issues/1115
+[#1116]: https://github.com/kmuto/review/pull/1116
+[#1117]: https://github.com/kmuto/review/pull/1117
+[#1121]: https://github.com/kmuto/review/pull/1121
+[#1128]: https://github.com/kmuto/review/issues/1128
+[#1129]: https://github.com/kmuto/review/pull/1129
+[#1136]: https://github.com/kmuto/review/issues/1136
+[#1138]: https://github.com/kmuto/review/issues/1138
+
 # Version 3.0.0 preview 2
 
 ## New Features

data/README.md

@@ -93,9 +93,15 @@ For further information, see [doc/quickstart.md](https://github.com/kmuto/review
 
 ## License
 
-LGPL. See [COPYING](https://github.com/kmuto/review/blob/master/COPYING) file.
+Main part of Re:VIEW is applied GNU Lesser General Public License (LGPL).
+See [COPYING](https://github.com/kmuto/review/blob/master/COPYING) file.
 
-* jumoline.sty (test/sample-book/src/vendor/jumoline): The LaTeX Project Public License. See [LPPL](https://github.com/kmuto/review/blob/master/test/sample-book/src/vendor/jumoline/lppl.txt) file.
+Exception:
+
+* doc/*, samples/*: MIT License. See [LICENSE](https://github.com/kmuto/review/blob/master/doc/LICENSE) file.
+* jumoline.sty, vendor/jumoline: The LaTeX Project Public License. See [LPPL](https://github.com/kmuto/review/blob/master/vendor/jumoline/lppl.txt) file.
+* plistings.sty, vendor/plistings: MIT License. See [LICENSE](https://github.com/kmuto/review/blob/master/vendor/plistings/LICENSE) file.
+* gentombow09j.sty, vendor/gentombow: BSD License. See [LICENSE](https://github.com/kmuto/review/blob/master/vendor/gentombow/LICENSE) file.
 
 ## Copyright
 

data/doc/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2006-2018 Minero Aoki, Kenshi Muto, Masayoshi Takahashi, Masanori Kado.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+

data/doc/config.yml.sample

@@ -131,6 +131,7 @@ secnolevel: 2
 # cover: null
 #
 # 表紙に配置し、書籍の影絵にも利用する画像ファイル。省略した場合はnull (画像を使わない)。画像ディレクトリ内に置いてもディレクトリ名は不要(例: cover.jpg)
+# PDFMaker 固有の表紙設定は pdfmaker セクション内で上書き可能
 # coverimage: null
 #
 # 表紙の後に大扉ページを作成するか。省略した場合はtrue (作成する)
@@ -281,10 +282,11 @@ epubmaker:
   # epubmaker:階層を使うものはここまで
 
 # LaTeX用のスタイルファイル(styディレクトリ以下に置くこと)
-# texstyle: samplemacro
+# texstyle: ["reviewmacro"]
 #
 # LaTeX用のdocumentclassを指定する
-# texdocumentclass: ["jsbook", "uplatex,oneside"]
+# review-jsbook.clsのオプションについてはsty/README.mdを参照
+# texdocumentclass: ["review-jsbook", "cameraready=print,paper=a5"]
 #
 # LaTeX用のコマンドを指定する
 # texcommand: "uplatex"
@@ -306,6 +308,11 @@ epubmaker:
 # という構成にする必要がある(インデントさせる)
 #
 pdfmaker:
+  #
+  # TeX版で利用する表紙画像。
+  # 仕上がりサイズ+塗り足し3mmありのPDFまたはIllustratorファイル（PDF互換オプション付き）を推奨。
+  # 拡縮はされず「そのまま」貼り付けられる
+  # coverimage: cover-a5.ai
   #
   # TeXコンパイル前に実行するプログラム。変換後のTeXソースを調整したいときに使用する。
   # 渡される引数1=作業用展開ディレクトリ、引数2=呼び出しを実行したディレクトリ

data/doc/customize_epub.ja.md

@@ -40,3 +40,26 @@ opf_meta: {"ibooks:binding": "false"}
 opf_prefix: {ebpaj: "http://www.ebpaj.jp/", ibooks: "http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/"}
 opf_meta: {"ebpaj:guide-version": "1.1.3", "ibooks:binding": "false"}
 ```
+
+## Amazon Kindle
+
+EPUB を作成したあと、mobi ファイルにする必要があります。これには Amazon が無料で配布している KindleGen を使用します。
+
+- https://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000765211
+
+OS に合わせたインストーラでインストールした後、`kindlegen EPUBファイル` で mobi ファイルに変換できます。
+
+Kindle Previewer にも内包されています。
+
+- https://kdp.amazon.co.jp/ja_JP/help/topic/G202131170
+
+注意点として、KindleGen は論理目次だけだとエラーを報告します。物理目次ページを付けるために、次のように config.yml に設定します。
+
+```yaml
+epubmaker:
+  toc: true
+```
+
+CSS によっては、Kindle では表現できないことについての警告が表示されることがあります。「Amazon Kindle パブリッシング・ガイドライン」では、使用可能な文字・外部ハイパーリンクの制約・色の使い方・画像サイズなどが詳細に説明されています。
+
+- http://kindlegen.s3.amazonaws.com/AmazonKindlePublishingGuidelines_JP.pdf

data/doc/customize_epub.md

@@ -45,3 +45,26 @@ If you have already some settings, merge them:
 opf_prefix: {ebpaj: "http://www.ebpaj.jp/", ibooks: "http://vocabulary.itunes.apple.com/rdf/ibooks/vocabulary-extensions-1.0/"}
 opf_meta: {"ebpaj:guide-version": "1.1.3", "ibooks:binding": "false"}
 ```
+
+## Amazon Kindle
+
+For Kindle, you need to convert EPUB to mobi format using KindleGen, which Amazon distributes.
+
+- https://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000765211
+
+After installation, you can convert EPUB with `kindlegen EPUB file`.
+
+KindleGen is also included in Kindle Previewer.
+
+- https://kdp.amazon.co.jp/ja_JP/help/topic/G202131170
+
+Note: if there is only a "logical" table of contents, KindleGen reports a strange error.  To include "physical" table of contents, set config.yml as follows.
+
+```yaml
+epubmaker:
+  toc: true
+```
+
+You may be warned about some CSS can't be handled in Kindle. "Amazon Kindle Publishing Guidelines" describes in detail the usable characters, restrictions on hyperlinks to the outside, usage of colors, image size, and so on.
+
+- http://kindlegen.s3.amazonaws.com/AmazonKindlePublishingGuidelines_JP.pdf

data/doc/format.ja.md

@@ -573,9 +573,103 @@ LaTeX の式を挿入するには、`//texequation{ 〜 //}` を使います。
 //}
 ```
 
-インライン命令では `@<m>{〜}` を使います。インライン命令の式中に「}」を含む場合、`\}` とエスケープする必要があることに注意してください（`{` はエスケープ不要）。
+インライン命令では `@<m>{〜}` を使います。インライン命令の式中に「}」を含む場合、`\}` とエスケープする必要があることに注意してください（`{` はエスケープ不要）。「インライン命令のフェンス記法」も参照してください。
 
-LaTeX の数式が正常に整形されるかどうかは処理系に依存します。たとえば TeX PDF であれば問題なく利用できるでしょうが、EPUB では MathML 変換を有効にしても妥当な結果にならないことがあります。確実を期すならば、画像で表現するほうが適切です。
+LaTeX の数式が正常に整形されるかどうかは処理系に依存します。LaTeX を利用する PDFMaker では問題なく利用できます。
+
+EPUBMaker および WEBMaker では、MathML に変換する方法と、画像化する方法のどちらかを選べます。
+
+### MathML の場合
+MathML ライブラリをインストールしておきます（`gem install math_ml`）。
+
+さらに config.yml に以下のように指定します。
+
+```
+mathml: true
+```
+
+なお、MathML で正常に表現されるかどうかは、ビューアやブラウザに依存します。
+
+### 画像化の場合
+
+LaTeX を内部で呼び出し、外部ツールを使って画像化する方法です。画像化された数式は、`images/_review_math` フォルダに配置されます。
+
+TeXLive などの LaTeX 環境が必要です。必要に応じて config.yml の `texcommand`、`texoptions`、`dvicommand`、`dvioptions` のパラメータを調整します。
+
+さらに、画像化するための外部ツールも用意します。現在、以下の2つのやり方をサポートしています。
+
+- `pdfcrop`：TeXLive に収録されている `pdfcrop` コマンドを使用して数式部分を切り出し、さらに PDF から画像化します。デフォルトでは画像化には Poppler ライブラリに収録されている `pdftocairo` コマンドを使用します（コマンドラインで利用可能であれば、別のツールに変更することもできます）。
+- `dvipng`：[dvipng](https://ctan.org/pkg/dvipng) を使用します。OS のパッケージまたは `tlmgr install dvipng` でインストールできます。数式中に日本語は使えません。
+
+config.yml で以下のように設定すると、
+
+```
+imgmath: true
+```
+
+デフォルト値として以下が使われます。
+
+```
+imgmath_options:
+  # 使用する画像拡張子。通常は「png」か「svg」（svgの場合は、pdfcrop_pixelize_cmdの-pngも-svgにする）
+  format: png
+  # 変換手法。pdfcrop または dvipng
+  converter: pdfcrop
+  # プリアンブルの内容を上書きするファイルを指定する（デフォルトはupLaTeX+jsarticle.clsを前提とした、lib/review/makerhelper.rbのdefault_imgmath_preambleメソッドの内容）
+  preamble_file: null
+  # 基準のフォントサイズ
+  fontsize: 10
+  # 基準の行間
+  lineheight: 12
+  # pdfcropコマンドのコマンドライン。プレースホルダは
+  # %i: 入力ファイル、%o: 出力ファイル
+  pdfcrop_cmd: "pdfcrop --hires %i %o"
+  # PDFから画像化するコマンドのコマンドライン。プレースホルダは
+  # %i: 入力ファイル、%o: 出力ファイル、%O: 出力ファイルから拡張子を除いたもの
+  # %p: 対象ページ番号
+  pdfcrop_pixelize_cmd: "pdftocairo -png -r 90 -f %p -l %p -singlefile %i %O"
+  # pdfcrop_pixelize_cmdが複数ページの処理に対応していない場合に単ページ化するか
+  extract_singlepage: null
+  # 単ページ化するコマンドのコマンドライン
+  pdfextract_cmd: "pdfjam -q --outfile %o %i %p"
+  # dvipngコマンドのコマンドライン
+  dvipng_cmd: "dvipng -T tight -z 9 -p %p -l %p -o %o %i"
+```
+
+たとえば SVG を利用するには、次のようにします。
+
+```
+imgmath: true
+imgmath_options:
+  format: svg
+  pdfcrop_pixelize_cmd: "pdftocairo -svg -r 90 -f %p -l %p -singlefile %i %o"
+```
+
+デフォルトでは、pdfcrop_pixelize_cmd に指定するコマンドは、1ページあたり1数式からなる複数ページの PDF のファイル名を `%i` プレースホルダで受け取り、`%p` プレースホルダのページ数に基づいて `%o`（拡張子あり）または `%O`（拡張子なし）の画像ファイルに書き出す、という仕組みになっています。
+
+単一のページの処理を前提とする `sips` コマンドや `magick` コマンドを使う場合、入力 PDF から指定のページを抽出するように `extract_singlepage: true` として挙動を変更します。単一ページの抽出はデフォルトで TeXLive の `pdfjam` コマンドが使われます。
+
+```
+imgmath: true
+imgmath_options:
+  extract_singlepage: true
+  # pdfjamの代わりに外部ツールのpdftkを使う場合（Windowsなど）
+  pdfextract_cmd: "pdftk A=%i cat A%p output %o"
+  # ImageMagickを利用する例
+  pdfcrop_pixelize_cmd: "magick -density 200x200 %i %o"
+  # sipsを利用する例
+  pdfcrop_pixelize_cmd: "sips -s format png --out %o %i"
+```
+
+Re:VIEW 2 以前の dvipng の設定に合わせるには、次のようにします。
+
+```
+imgmath: true
+imgmath_options:
+  converter: dvipng
+  fontsize: 12
+  lineheight: 14.3
+```
 
 ## 字下げの制御
 
@@ -878,8 +972,8 @@ list: 実行例
 * `%pr` : ローマ数字（小文字）i, ii, iii, ...
 * `%pRW` : ローマ数字（大文字・単一文字表記）Ⅰ, Ⅱ, Ⅲ, ...
 * `%pJ` : 漢数字 一, 二, 三, ...
-* `%pdW' : アラビア数字（0〜9まではいわゆる全角、10以降半角）１, ２, ... 10, ...
-* `%pDW' : アラビア数字（すべて全角）１, ２, ... １０, ...
+* `%pdW` : アラビア数字（0〜9まではいわゆる全角、10以降半角）１, ２, ... 10, ...
+* `%pDW` : アラビア数字（すべて全角）１, ２, ... １０, ...
 
 例:
 

data/doc/format.md

@@ -498,7 +498,6 @@ The rule of finding images is same as image command.
 //}
 ```
 
-
 ## Quoting Text
 
 You can use `//quote{ ... //}` as quotations.
@@ -618,6 +617,104 @@ Usage:
 //}
 ```
 
+There is `@<m>{ ... }` for inline (see "Fence notation for inline commands" section also).
+
+Whether LaTeX formula is correctly displayed or not depends on the processing system. PDFMaker uses LaTeX internally, so there is no problem.
+
+EPUBMaker and WEBMaker use either MathML transformation or imaging.
+
+### MathML case
+Install MathML library (`gem install math_ml`).
+
+Specify in config.yml as follows:
+
+```
+mathml: true
+```
+
+Whether it is displayed properly in MathML depends on your viewer or browser.
+
+### imaging case
+
+This way calls LaTeX internally and images it with an external tool. Image files will be placed in `images/_review_math` folder.
+
+You need TeXLive or other LaTeX environment. Modify the parameters of `texcommand`,` texoptions`, `dvicommand`,` dvioptions` in config.yml as necessary.
+
+In addition, external tools for image conversion are also needed. Currently, it supports the following two methods.
+
+- `pdfcrop`: cut out  the formula using `pdfcrop` command (included in TeXLive) and image it. By default, `pdftocairo` command is used (included in Poppler library). You can change it to another tool if available on the command line.
+- `dvipng`: it uses [dvipng](https://ctan.org/pkg/dvipng) to cut out and to image. You can install with OS package or `tlmgr install dvipng`.
+
+By setting in config.yml,
+
+```
+imgmath: true
+```
+
+it is set as follows:
+
+```
+imgmath_options:
+  # format. png|svg
+  format: png
+  # conversion method. pdfcrop|dvipng
+  converter: pdfcrop
+  # custom preamble file (default: for upLaTeX+jsarticle.cls, see lib/review/makerhelper.rb#default_imgmath_preamble）
+  preamble_file: null
+  # default font size
+  fontsize: 10
+  # default line height
+  lineheight: 12
+  # pdfcrop command.
+  # %i: filename for input %o: filename for output
+  pdfcrop_cmd: "pdfcrop --hires %i %o"
+  # imaging command.
+  # %i: filename for input %o: filename for output %O: filename for output without the extension
+  # %p: page number
+  pdfcrop_pixelize_cmd: "pdftocairo -png -r 90 -f %p -l %p -singlefile %i %O"
+  # whether to generate a single PDF page for pdfcrop_pixelize_cmd.
+  extract_singlepage: null
+  # command line to generate a single PDF page file.
+  pdfextract_cmd: "pdfjam -q --outfile %o %i %p"
+  # dvipng command.
+  dvipng_cmd: "dvipng -T tight -z 9 -p %p -l %p -o %o %i"
+```
+
+For example, to make SVG:
+
+```
+imgmath: true
+imgmath_options:
+  format: svg
+  pdfcrop_pixelize_cmd: "pdftocairo -svg -r 90 -f %p -l %p -singlefile %i %o"
+```
+
+By default, the command specified in `pdfcrop_pixelize_cmd` takes the filename of multi-page PDF consisting of one formula per page.
+
+If you want to use the `sips` command or the` magick` command, they can only process a single page, so you need to set `extract_singlepage: true` to extract the specified page from the input PDF. `pdfjam` command (in TeXLive) is used to extract pages.
+
+```
+imgmath: true
+imgmath_options:
+  extract_singlepage: true
+  # use pdftk instead of default pdfjam (for Windows)
+  pdfextract_cmd: "pdftk A=%i cat A%p output %o"
+  # use ImageMagick
+  pdfcrop_pixelize_cmd: "magick -density 200x200 %i %o"
+  # use sips
+  pdfcrop_pixelize_cmd: "sips -s format png --out %o %i"
+```
+
+To set the same setting as Re:VIEW 2:
+
+```
+imgmath: true
+imgmath_options:
+  converter: dvipng
+  fontsize: 12
+  lineheight: 14.3
+```
+
 ## Spacing
 
 `//noindent` is a tag for spacing.