review 5.6.0 → 5.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 644d242fdcddb452c2cfd780a13a165ee89f49b11f349b682ad87c47255f8758
-  data.tar.gz: 77636486441ca626f068bec8f1cabae980bb4832946d98ef6c5bc329bee30b56
+  metadata.gz: 368cf93a0b3ae0f5aaecebdef459f759ab45998b9236cfa983294711a4f135b6
+  data.tar.gz: 9990d2ed06a889cc951c3db58b47431e8ad414842fb4e6868082e2c33dd73139
 SHA512:
-  metadata.gz: 96d2d70825a306d384e832312527e956f23b81832a71fe766b102e6705b5b3dfad50c3cde19b767eaa124e79a6d5096a5cf9ee882ef1335cb96864d3dd4de992
-  data.tar.gz: 06336e0ca7578002aa195d1a08d4f354da2842fe0eb0812d38825be48c68130d6a78da8df9ae064ba24d138f6f5bb11c9383bf8a3eb9d4ea06f8458c8813be44
+  metadata.gz: a78a8e4f75a856c15c492a9ef466efd72cad538a6c3378023b6c0dd83ec268e7a99126b16cb3d2ec158035b9f620380a50b759319131227c403b09b27bd8e8b6
+  data.tar.gz: 7f14b429a757435416de52eb8bed9d05925c1694e647c2165b68c46c835fcea9f0f1e4ea7d908219ceceb3edb179bf130ffe2ef811fe58416d00aba6f0d4e068

data/.github/workflows/rubocop.yml

@@ -0,0 +1,31 @@
+name: Lint by RuboCop
+
+on:
+  push:
+    branches:
+    - master
+  pull_request:
+
+jobs:
+  build:
+
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['2.7', '3.0', '3.1', '3.2']
+        os: [ubuntu-latest]
+    steps:
+    - uses: actions/checkout@v2
+    - name: Set up Ruby
+      uses: ruby/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - name: fix ImageMagick policy.xml on Linux
+      if: runner.os == 'Linux'
+      run: sudo sed -i 's/none/read|write/g' /etc/ImageMagick-6/policy.xml
+    - name: Build and test with Rake
+      run: |
+        gem install bundler --no-document
+        bundle install --retry 3
+        bundle exec rubocop -P

data/.github/workflows/ruby-tex.yml

@@ -13,7 +13,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: ['2.5', '3.0', '3.1']
+        ruby: ['2.7', '3.2']
         os: [ubuntu-20.04]
     steps:
     - uses: actions/checkout@v2
@@ -28,6 +28,10 @@ jobs:
     - name: fix ImageMagick policy.xml on Linux
       if: runner.os == 'Linux'
       run: sudo sed -i 's/none/read|write/g' /etc/ImageMagick-6/policy.xml
+    - name: use Node.js 18.x
+      uses: actions/setup-node@v3
+      with:
+        node-version: 18
     - name: Build and test with Rake
       run: |
         gem install bundler --no-document

data/.github/workflows/ruby-win.yml

@@ -13,7 +13,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: [ '3.0', '2.7', '2.6', '2.5', '2.4' ]
+        ruby: [ '3.2', '3.1', '3.0', '2.7' ]
 
     steps:
     - uses: actions/checkout@v2

data/.github/workflows/ruby.yml

@@ -13,7 +13,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby: ['2.4', '2.5', '2.6', '2.7', '3.0', '3.1']
+        ruby: ['2.7', '3.0', '3.1', '3.2']
         os: [ubuntu-latest, macOS-latest]
     steps:
     - uses: actions/checkout@v2
@@ -28,4 +28,4 @@ jobs:
       run: |
         gem install bundler --no-document
         bundle install --retry 3
-        bundle exec rake
+        bundle exec rake test

data/.rubocop.yml

@@ -5,7 +5,7 @@ AllCops:
     - tmp/*
   DisplayCopNames: true
   NewCops: enable
-  TargetRubyVersion: 2.5
+  TargetRubyVersion: 2.7
 
 require:
   - rubocop-performance
@@ -38,6 +38,9 @@ Performance/StringInclude:
 Performance/CollectionLiteralInLoop:
   Enabled: false
 
+Performance/MapCompact:
+  Enabled: false
+
 #### Style
 
 Style/AsciiComments:
@@ -109,7 +112,7 @@ Style/LineEndConcatenation:
   Enabled: false
 
 Style/MethodCallWithArgsParentheses:
-  IgnoredMethods:
+  AllowedMethods:
     - 'require'
     - 'include'
     - 'file'
@@ -194,6 +197,9 @@ Style/OptionalBooleanParameter:
 Style/CombinableLoops:
   Enabled: false
 
+Style/FetchEnvVar:
+  Enabled: false
+
 ### Layout
 
 Layout/BlockAlignment:
@@ -296,3 +302,8 @@ Naming/VariableNumber:
 
 Gemspec/RequiredRubyVersion:
   Enabled: false
+
+Gemspec/DevelopmentDependencies:
+  EnforcedStyle: gemspec
+  Exclude:
+    - samples/syntax-book/Gemfile

data/NEWS.ja.md

@@ -1,3 +1,42 @@
+# Version 5.8.0
+## 新機能
+* `//graph` 命令でMermaid記法によるグラフ記述ができるようになりました。外部ツールの用意や設定については`doc/format.ja.md`を参照してください ([#1885])
+
+## バグ修正
+* EPUBMaker: 自動生成される部の内容に`<title>`が入らないのを修正しました ([#1898])
+
+## 機能強化
+* PDFMaker: `@<href>`命令で長いURLを記述したときに、ページをはみ出さずに折り返すようにしました ([#1890])
+
+## コントリビューターのみなさん
+* [@munepi](https://github.com/munepi)
+
+[#1885]: https://github.com/kmuto/review/pull/1885
+[#1890]: https://github.com/kmuto/review/issues/1890
+[#1898]: https://github.com/kmuto/review/pull/1898
+
+# Version 5.7.0
+## バグ修正
+* Windows において、`review-init -w` の実行時にバインドアドレスを省略したときにエラーが発生するのを修正しました ([#1824])
+* PDFMaker: `//blankline` でページをまたいだときに、ページの先頭に空行が入るのを抑制しました ([#1872])
+* EPUBMaker: MathJax で数式を表現する際に、`<`, `>`, `&` を変換し、HTML のエラーが出ないようにしました ([#1876], [#1877])
+
+## 非互換の変更
+* 動作検証済みバージョンを Ruby 2.7 以降としました ([#1871])
+* EPUMaker: EPUB の検証ルールに従い、EPUB の目次に表紙へのリンクを含めました ([#1874])
+
+## その他
+* Ruby 3.2 を動作検証テスト対象に含めました ([#1871])
+* RuboCop 1.45.1 の指摘を反映しました ([#1878])
+
+[#1824]: https://github.com/kmuto/review/issues/1824
+[#1871]: https://github.com/kmuto/review/pull/1871
+[#1872]: https://github.com/kmuto/review/issues/1872
+[#1874]: https://github.com/kmuto/review/issues/1874
+[#1876]: https://github.com/kmuto/review/pull/1876
+[#1877]: https://github.com/kmuto/review/pull/1877
+[#1878]: https://github.com/kmuto/review/pull/1878
+
 # Version 5.6.0
 ## 新機能
 * IDGXMLBuilder: `//texequation` と `@<m>` で `imgmath` math_formatに対応しました ([#1829])

data/NEWS.md

@@ -1,3 +1,41 @@
+# Version 5.8.0
+## New Features
+* The `//graph` operator allows graphical description in Mermaid notation. See `doc/format.md` for details on prepairing and setting up external tools ([#1885])
+
+## Bug Fixes
+* EPUBMaker: fix `<title>` not being included in the auto-generated part content ([#1898])
+
+## Enhancements
+* PDFMaker: fix to wrap long URLs with `@<href>` operator ([#1890])
+
+## Contributors
+* [@munepi](https://github.com/munepi)
+
+[#1885]: https://github.com/kmuto/review/pull/1885
+[#1890]: https://github.com/kmuto/review/issues/1890
+[#1898]: https://github.com/kmuto/review/pull/1898
+
+# Version 5.7.0
+## Bug Fixes
+* Fixed error when omitting a bind address of `review-init -w` on Windows ([#1824])
+* EPUBMaker: escape `<`, `>`, and `&` when converting to MathJax to avoid HTML errors ([#1876], [#1877])
+
+## Breaking Changes
+* Ruby 2.6 or earlier was excluded from the operation verification ([#1871])
+* EPUMaker: included a link to the cover in the table of contents according to EPUB validation rules ([#1874])
+
+## Others
+* Ruby 3.2 is now included in the testing target ([#1871])
+* refactor code with RuboCop 1.45.1 ([#1878])
+
+[#1824]: https://github.com/kmuto/review/issues/1824
+[#1871]: https://github.com/kmuto/review/pull/1871
+[#1872]: https://github.com/kmuto/review/issues/1872
+[#1874]: https://github.com/kmuto/review/issues/1874
+[#1876]: https://github.com/kmuto/review/pull/1876
+[#1877]: https://github.com/kmuto/review/pull/1877
+[#1878]: https://github.com/kmuto/review/pull/1878
+
 # Version 5.6.0
 ## New Features
 * IDGXMLBuilder: support `imgmath` math_format in `//texequation` and `@<m>` ([#1829])

data/README.md

@@ -117,4 +117,4 @@ Exception:
 
 ## Copyright
 
-Copyright (c) 2006-2022 Minero Aoki, Kenshi Muto, Masayoshi Takahashi, Masanori Kado.
+Copyright (c) 2006-2023 Minero Aoki, Kenshi Muto, Masayoshi Takahashi, Masanori Kado.

data/doc/config.yml.sample

@@ -262,6 +262,17 @@ toc: true
 # 追加する<meta>要素のプロパティとその値
 # opf_meta: {"ebpaj:guide-version": "1.1.3"}
 
+# Playwrightの利用オプション
+# playwright_options:
+  # playwrightコマンドのパス
+  # playwright_path: "./node_modules/.bin/playwright"
+  # playwright-runnerの切り取りを使う。pdfcropを使う場合はfalseにする
+  # selfcrop: true
+  # pdfcropコマンドのパス
+  # pdfcrop_path: "pdfcrop"
+  # pdftocairoコマンドのパス
+  # pdftocairo_path: "pdftocairo"
+
 # 以下のパラメータを有効にするときには、
 # epubmaker:
 #    パラメータ: 値

data/doc/format.ja.md

@@ -2,7 +2,7 @@
 
 Re:VIEW フォーマットの文法について解説します。Re:VIEW フォーマットはアスキー社（現カドカワ）の EWB を基本としながら、一部に RD や各種 Wiki の文法を取り入れて簡素化しています。
 
-このドキュメントは、Re:VIEW 5.5 に基づいています。
+このドキュメントは、Re:VIEW 5.8 に基づいています。
 
 ## 段落
 
@@ -407,13 +407,61 @@ plot sin(x)
 //}
 ```
 
-コマンド名には、「`graphviz`」「`gnuplot`」「`blockdiag`」「`aafigure`」「`plantuml`」のいずれかを指定できます。ツールはそれぞれ別途インストールし、インストール先のフォルダ名を指定することなく実行できる (パスを通す) 必要があります。
+コマンド名には、「`graphviz`」「`gnuplot`」「`blockdiag`」「`aafigure`」「`plantuml`」「`mermaid`」のいずれかを指定できます。ツールはそれぞれ別途インストールし、インストール先のフォルダ名を指定することなく実行できる (パスを通す) 必要があります。
 
 * Graphviz ( https://www.graphviz.org/ ) : `dot` コマンドへのパスを OS に設定すること
 * Gnuplot ( http://www.gnuplot.info/ ) : `gnuplot` コマンドへのパスを OS に設定すること
 * Blockdiag ( http://blockdiag.com/ ) : `blockdiag` コマンドへのパスを OS に設定すること。PDF を生成する場合は ReportLab もインストールすること
 * aafigure ( https://launchpad.net/aafigure ) : `aafigure` コマンドへのパスを OS に設定すること
 * PlantUML ( http://plantuml.com/ ) : `java` コマンドへのパスを OS に設定し、`plantuml.jar` が作業フォルダ、または `/usr/share/plantuml` あるいは `/usr/share/java` フォルダにあること
+* Mermaid ( https://mermaid.js.org/ ) : 以下を参照
+
+### Mermaid の利用
+
+Mermaid は Web ブラウザ上で動作する JavaScript ベースの図形描画ツールです。EPUB や LaTeX 経由の PDF で利用するには、Web ブラウザを内部的に呼び出して画像化する必要があります。現時点で、Linux 以外の動作は確認していません。
+
+1. プロジェクトに次のように `package.json` を作成します（既存のファイルがあるときには、`dependencies` に `"playwright"〜` の行を追加します）。
+   ```
+   {
+     "name": "book",
+     "dependencies": {
+       "playwright": "^1.32.2"
+     }
+   }
+   ```
+2. Playwright ライブラリをインストールします。`npm` がない場合は、[Node.js](https://nodejs.org/) の環境をセットアップしてください。
+   ```
+   npm install
+   ```
+3. Playwright ライブラリを Ruby から呼び出すモジュールである [playwright-runner](https://github.com/kmuto/playwright-runner) をインストールします。
+   ```
+   gem install playwright-runner
+   ```
+4. (オプション) EPUB には SVG 形式を作成する必要がありますが、SVG に変換するには、[poppler](https://gitlab.freedesktop.org/poppler/poppler) に含まれる `pdftocairo` コマンドが必要です。Debian およびその派生物では以下のようにしてインストールできます。
+   ```
+   apt install poppler-utils
+   ```
+5. (オプション) デフォルトでは図の周囲に大きめの余白ができてしまいます。これを詰めるには、TeXLive に含まれる `pdfcrop` コマンドが必要です。Debian およびその派生物では以下のようにしてインストールできます。
+   ```
+   apt install texlive-extra-utils
+   ```
+
+プロジェクトの `config.yml` を適宜調整します。デフォルト値は以下のとおりです。
+
+```
+playwright_options:
+  playwright_path: "./node_modules/.bin/playwright"
+  selfcrop: true
+  pdfcrop_path: "pdfcrop"
+  pdftocairo_path: "pdftocairo"
+```
+
+- `playwright_path`: `playwright` コマンドのパスを相対パスまたは絶対パスで指定する
+- `selfcrop`: `playwright-runner` の画像切り出しを使う。`pdfcrop` が不要になるが、周囲に余白が生じる。`pdfcrop` を使うときには `false` に設定する
+- `pdfcrop_path`: `pdfcrop` コマンドのパス。`selfcrop` が `true` のときには無視される
+- `pdftocairo_path`: `pdftocairo` コマンドのパス
+
+Re:VIEW 側の記法としては `//graph[ID][mermaid][キャプション]` または `//graph[ID][mermaid]` となりますが、この ID に基づき、`images/html/ID.svg`（EPUB の場合）や `images/latex/ID.pdf`（LaTeX PDF の場合）が生成されます。
 
 ## 表
 

data/doc/format.md

@@ -4,7 +4,7 @@ The document is a brief guide for Re:VIEW markup syntax.
 
 Re:VIEW is based on EWB of ASCII (now KADOKAWA), influenced RD and other Wiki system's syntax.
 
-This document explains about the format of Re:VIEW 5.5.
+This document explains about the format of Re:VIEW 5.8.
 
 ## Paragraph
 
@@ -425,7 +425,7 @@ plot sin(x)
 //}
 ```
 
-You can use `graphviz`, `gnuplot`, `blockdiag`, `aafigure`, and `plantuml` as the command name.
+You can use `graphviz`, `gnuplot`, `blockdiag`, `aafigure`, `plantuml`, and `mermaid` as the command name.
 Before using these tools, you should installed them and configured path appropriately.
 
 * Graphviz ( https://www.graphviz.org/ ) : set path to `dot` command
@@ -433,6 +433,54 @@ Before using these tools, you should installed them and configured path appropri
 * Blockdiag ( http://blockdiag.com/ ) : set path to `blockdiag` command. Install ReportLab also to make a PDF
 * aafigure ( https://launchpad.net/aafigure ) : set path to `aafigure` command
 * PlantUML ( http://plantuml.com/ ) : set path to `java` command. place `plantuml.jar` on working folder, `/usr/share/plantuml` or `/usr/share/java`.
+* Mermaid ( https://mermaid.js.org/ ) : see below
+
+### using Mermaid
+
+Mermaid is a JavaScript-based diagram tool that runs in a Web browser. For use with EPUB or LaTeX PDF, Re:VIEW calls the Web browser internally to create images. At this time, we have not confirmed that Mermaid works on any platforms other than Linux.
+
+1. Create `package.json` in your project (if you have an existing file, add the line `"playwright"...` to the `dependencies`).
+   ```
+   {
+     "name": "book",
+     "dependencies": {
+       "playwright": "^1.32.2"
+     }
+   }
+   ```
+2. Install Playwright library. If you don't have `npm`, set up [Node.js](https://nodejs.org/) first.
+   ```
+   npm install
+   ```
+3. Install [playwright-runner](https://github.com/kmuto/playwright-runner), a module that calls the Playwright library from Ruby.
+   ```
+   gem install playwright-runner
+   ```
+4. (Optional) Since EPUB cannot handle PDF, the images must be in SVG format; to convert them to SVG, you need the `pdftocairo` command included in [poppler](https://gitlab.freedesktop.org/poppler/poppler). It can be installed in Debian and its derivatives as follows:
+   ```
+   apt install poppler-utils
+   ```
+5. (Optional )By default, there will be white margins around the figure. To crop them, you need the `pdfcrop` command included in TeXLive, which can be installed in Debian and its derivatives as follows:
+   ```
+   apt install texlive-extra-utils
+   ```
+
+Adjust `config.yml`. The default values are as follows:
+
+```
+playwright_options:
+  playwright_path: "./node_modules/.bin/playwright"
+  selfcrop: true
+  pdfcrop_path: "pdfcrop"
+  pdftocairo_path: "pdftocairo"
+```
+
+- `playwright_path`: path of the `playwright` command.
+- `selfcrop`: use the default cropper of `playwright-runner`. The `pdfcrop` will not be needed, but there will be margins around it. Set to `false` if you can use `pdfcrop`.
+- `pdfcrop_path`: path of the `pdfcrop` command. Ignored if `selfcrop` is `true`.
+- `pdftocairo_path`: path of the `pdftocairo` command.
+
+The notation in Re:VIEW is `//graph[ID][mermaid][caption]` or `//graph[ID][mermaid]`. Based on this ID, `images/html/ID.svg` (for EPUB) or `images/latex/ID.pdf` (for LaTeX PDF) will be generated.
 
 ## Tables
 

data/lib/review/book/base.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2009-2022 Minero Aoki, Kenshi Muto, Masayoshi Takahashi
+# Copyright (c) 2009-2023 Minero Aoki, Kenshi Muto, Masayoshi Takahashi
 #               2002-2008 Minero Aoki
 #
 # This program is free software.
@@ -73,7 +73,7 @@ module ReVIEW
       end
 
       def imagedir
-        File.join(@basedir, config['imagedir'])
+        config['imagedir']
       end
 
       def image_types

data/lib/review/book/image_finder.rb

@@ -1,5 +1,5 @@
 #
-# Copyright (c) 2014-2018 Minero Aoki, Kenshi Muto, Masayoshi Takahashi
+# Copyright (c) 2014-2023 Minero Aoki, Kenshi Muto, Masayoshi Takahashi
 #
 # This program is free software.
 # You can distribute or modify this program under the terms of
@@ -13,35 +13,50 @@ require 'review/exception'
 module ReVIEW
   module Book
     class ImageFinder
-      def initialize(basedir, chapid, builder, exts)
-        @basedir = basedir
-        @chapid = chapid
-        @builder = builder
-        @exts = exts
-        @entries = dir_entries
+      def initialize(chapter)
+        @book = chapter.book
+        @basedir = @book.imagedir
+        @chapid = chapter.id
+        @builder = @book.config['builder']
+        @entries = dir_entries.map { |path| entry_object(path) }
+      end
+
+      def entry_object(path)
+        { path: path, basename: path.sub(/\.[^.]+$/, ''), downcase: path.sub(/\.[^.]+$/, $&.downcase) }
       end
 
       def dir_entries
-        Dir.glob(File.join(@basedir, '**{,/*/**}/*.*')).uniq.sort
+        Dir.glob(File.join(@basedir, '**{,/*/**}/*.*')).uniq.sort.map { |entry| entry.sub(%r{^\./}, '') }
       end
 
       def add_entry(path)
-        @entries << path unless @entries.include?(path)
+        path.sub!(%r{^\./}, '')
+        unless @entries.find { |entry| entry[:path] == path }
+          @entries << entry_object(path)
+        end
         @entries
       end
 
       def find_path(id)
         targets = target_list(id)
         targets.each do |target|
-          @exts.each do |ext|
-            @entries.find do |entry|
-              downname = entry.sub(/\.[^.]+$/, File.extname(entry).downcase)
-              if downname == "#{target}#{ext}"
-                return entry
+          @book.image_types.each do |ext|
+            entries = @entries.select do |entry|
+              entry[:basename] == target
+            end
+
+            unless entries
+              break
+            end
+
+            entries.find do |entry|
+              if entry[:downcase] == "#{target}#{ext}"
+                return entry[:path]
               end
             end
           end
         end
+
         nil
       end
 

data/lib/review/book/index.rb

@@ -138,14 +138,7 @@ module ReVIEW
       def initialize(chapter)
         super()
         @chapter = chapter
-        book = @chapter.book
-
-        chapid = chapter.id
-        basedir = book.imagedir
-        builder = book.config['builder']
-        types = book.image_types
-
-        @image_finder = ReVIEW::Book::ImageFinder.new(basedir, chapid, builder, types)
+        @image_finder = ReVIEW::Book::ImageFinder.new(@chapter)
       end
 
       def find_path(id)

data/lib/review/builder.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2002-2022 Minero Aoki, Kenshi Muto
+# Copyright (c) 2002-2023 Minero Aoki, Kenshi Muto
 #
 # This program is free software.
 # You can distribute or modify this program under the terms of
@@ -11,6 +11,7 @@ require 'review/textutils'
 require 'review/compiler'
 require 'review/sec_counter'
 require 'review/img_math'
+require 'review/img_graph'
 require 'review/loggable'
 require 'stringio'
 require 'fileutils'
@@ -35,13 +36,14 @@ module ReVIEW
     attr_accessor :doc_status
     attr_reader :location
 
-    def initialize(strict = false, *_args, img_math: nil)
+    def initialize(strict = false, *_args, img_math: nil, img_graph: nil)
       @strict = strict
       @output = nil
       @logger = ReVIEW.logger
       @doc_status = {}
       @dictionary = {}
       @img_math = img_math
+      @img_graph = img_graph
       @shown_endnotes = true
     end
 
@@ -61,6 +63,7 @@ module ReVIEW
       @tsize = nil
       if @book && @book.config
         @img_math ||= ReVIEW::ImgMath.new(@book.config)
+        @img_graph ||= ReVIEW::ImgGraph.new(@book.config, target_name)
         if words_file_path = @book.config['words_file']
           words_files = if words_file_path.is_a?(String)
                           [words_file_path]
@@ -234,7 +237,8 @@ module ReVIEW
       sepidx = nil
       rows = []
       lines.each_with_index do |line, idx|
-        if /\A[=\-]{12}/ =~ line || /\A[={\-}]{12}/ =~ line
+        # {} is for LaTeX
+        if /\A[=-]{12}/ =~ line || /\A[={}-]{12}/ =~ line
           sepidx ||= idx
           next
         end
@@ -512,12 +516,7 @@ module ReVIEW
     end
 
     def inline_wb(s)
-      translated = @dictionary[s]
-      if translated
-        inline_b(translated)
-      else
-        inline_b("[missing word: #{s}]")
-      end
+      inline_b(@dictionary[s] || "[missing word: #{s}]")
     end
 
     def raw(str)
@@ -703,6 +702,16 @@ EOTGNUPLOT
       file_path
     end
 
+    def graph_mermaid(id, _file_path, _line, tf_path)
+      begin
+        require 'playwrightrunner'
+      rescue LoadError
+        app_error "#{@location}: could not handle Mermaid of //graph in this builder."
+      end
+
+      @img_graph.defer_mermaid_image(File.read(tf_path), id)
+    end
+
     def image_ext
       raise NotImplementedError
     end

data/lib/review/configure.rb

@@ -68,6 +68,13 @@ module ReVIEW
         'externallink' => true,
         'join_lines_by_lang' => nil, # experimental. default should be nil
         'table_row_separator' => 'tabs',
+        # for Playwright
+        'playwright_options' => {
+          'playwright_path' => './node_modules/.bin/playwright',
+          'selfcrop' => true,
+          'pdfcrop_path' => 'pdfcrop',
+          'pdftocairo_path' => 'pdftocairo'
+        },
         # for IDGXML
         'tableopt' => nil,
         'listinfo' => nil,

data/lib/review/epubmaker/epubcommon.rb

@@ -1,6 +1,6 @@
 # = epubcommon.rb -- super class for EPUBv2 and EPUBv3
 #
-# Copyright (c) 2010-2022 Kenshi Muto and Masayoshi Takahashi
+# Copyright (c) 2010-2023 Kenshi Muto and Masayoshi Takahashi
 #
 # This program is free software.
 # You can distribute or modify this program under the terms of
@@ -231,6 +231,10 @@ module ReVIEW
         ReVIEW::Template.generate(path: template_name, binding: binding)
       end
 
+      def coveritem
+        []
+      end
+
       def hierarchy_ncx(type)
         require 'rexml/document'
         level = 1
@@ -264,7 +268,7 @@ module ReVIEW
         doc.context[:attribute_quote] = :quote
 
         e = doc.root.elements[1] # first <li/>
-        contents.each do |item|
+        (coveritem + contents).each do |item|
           next if !item.notoc.nil? || item.level.nil? || item.file.nil? || item.title.nil? || item.level > toclevel
 
           if item.level == level
@@ -304,7 +308,7 @@ module ReVIEW
 
       def flat_ncx(type, indent = nil)
         s = %Q(<#{type} class="toc-h1">\n)
-        contents.each do |item|
+        (coveritem + contents).each do |item|
           next if !item.notoc.nil? || item.level.nil? || item.file.nil? || item.title.nil? || item.level > config['toclevel'].to_i
 
           is = indent == true ? '　' * item.level : ''
@@ -324,10 +328,12 @@ module ReVIEW
         FileUtils.mkdir_p("#{tmpdir}/OEBPS")
         File.write(File.join(tmpdir, opf_path), opf)
 
-        if File.exist?("#{basedir}/#{config['cover']}")
-          FileUtils.cp("#{basedir}/#{config['cover']}", "#{tmpdir}/OEBPS")
-        else
-          File.write("#{tmpdir}/OEBPS/#{config['cover']}", cover)
+        if config['cover']
+          if File.exist?("#{basedir}/#{config['cover']}")
+            FileUtils.cp("#{basedir}/#{config['cover']}", "#{tmpdir}/OEBPS")
+          else
+            File.write("#{tmpdir}/OEBPS/#{config['cover']}", cover)
+          end
         end
 
         if config['colophon'] && !config['colophon'].is_a?(String)

data/lib/review/epubmaker/epubv2.rb

@@ -22,11 +22,6 @@ module ReVIEW
       CREATOR_ATTRIBUTES = %w[aut a-adp a-ann a-arr a-art a-asn a-aqt a-aft a-aui a-ant a-bkp a-clb a-cmm a-dsr a-edt a-ill a-lyr a-mdc a-mus a-nrt a-oth a-pht a-prt a-red a-rev a-spn a-ths a-trc a-trl]
       CONTRIBUTER_ATTRIBUTES = %w[adp ann arr art asn aqt aft aui ant bkp clb cmm dsr edt ill lyr mdc mus nrt oth pht prt red rev spn ths trc trl]
 
-      # Construct object with parameter hash +config+ and message resource hash +res+.
-      def initialize(producer) # rubocop:disable Lint/UselessMethodDefinition
-        super
-      end
-
       # Return opf file content.
       def opf
         @opf_metainfo = opf_metainfo