review 5.7.0 → 5.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 11969067c8cb25999f37895ba330bd5c030c62402d1540510e241c6029c38d90
-  data.tar.gz: 4294e10f33abcb6063ea0098c3b7256374a5696d693fe2284dcb0fed4f2b2348
+  metadata.gz: 368cf93a0b3ae0f5aaecebdef459f759ab45998b9236cfa983294711a4f135b6
+  data.tar.gz: 9990d2ed06a889cc951c3db58b47431e8ad414842fb4e6868082e2c33dd73139
 SHA512:
-  metadata.gz: dddd61f8870c1f2e0d1117d3318cb456bcf49db10a12c4c93dc8b7638b08e5b6894efdfbdbd635d432196f82d40f906b29435f4f6e5ddbb78d2dcbd3829715af
-  data.tar.gz: 695257c02903d581c061cd7813e8951923a4a63986e879aa6e6ee31d963d627bf0e9512f85ffc56ca6a596a8f8f114ed012c3cce9daa7dd41072aabc89a9cb3d
+  metadata.gz: a78a8e4f75a856c15c492a9ef466efd72cad538a6c3378023b6c0dd83ec268e7a99126b16cb3d2ec158035b9f620380a50b759319131227c403b09b27bd8e8b6
+  data.tar.gz: 7f14b429a757435416de52eb8bed9d05925c1694e647c2165b68c46c835fcea9f0f1e4ea7d908219ceceb3edb179bf130ffe2ef811fe58416d00aba6f0d4e068

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

@@ -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/NEWS.ja.md

@@ -1,3 +1,20 @@
+# 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])

data/NEWS.md

@@ -1,3 +1,20 @@
+# 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])

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

@@ -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

@@ -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]
@@ -699,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.rb

@@ -17,6 +17,7 @@ require 'review/version'
 require 'review/htmltoc'
 require 'review/htmlbuilder'
 require 'review/img_math'
+require 'review/img_graph'
 
 require 'rexml/document'
 require 'rexml/streamlistener'
@@ -41,6 +42,7 @@ module ReVIEW
       @buildlogtxt = 'build-log.txt'
       @logger = ReVIEW.logger
       @img_math = nil
+      @img_graph = nil
       @basedir = nil
     end
 
@@ -282,11 +284,12 @@ module ReVIEW
       @manifeststr = ''
       @ncxstr = ''
       @tocdesc = []
+      @img_graph = ReVIEW::ImgGraph.new(@config, 'html', path_name: '_review_graph')
 
       basedir = File.dirname(yamlfile)
       base_path = Pathname.new(basedir)
       book = ReVIEW::Book::Base.new(basedir, config: @config)
-      @converter = ReVIEW::Converter.new(book, ReVIEW::HTMLBuilder.new(img_math: @img_math))
+      @converter = ReVIEW::Converter.new(book, ReVIEW::HTMLBuilder.new(img_math: @img_math, img_graph: @img_graph))
       @compile_errors = nil
 
       book.parts.each do |part|
@@ -310,6 +313,13 @@ module ReVIEW
         end
       end
       check_compile_status
+
+      begin
+        @img_graph.make_mermaid_images
+      rescue ApplicationError => e
+        error! e.message
+      end
+      @img_graph.cleanup_graphimg
     end
 
     def build_part(part, basetmpdir, htmlfile)
@@ -317,6 +327,7 @@ module ReVIEW
       File.open(File.join(basetmpdir, htmlfile), 'w') do |f|
         @part_number = part.number
         @part_title = part.name.strip
+        @title = @part_title
         @body = ReVIEW::Template.generate(path: template_name(localfile: '_part_body.html.erb', systemfile: 'html/_part_body.html.erb'), binding: binding)
         @language = @producer.config['language']
         @stylesheets = @producer.config['stylesheet']

data/lib/review/htmlbuilder.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2008-2022 Minero Aoki, Kenshi Muto, Masayoshi Takahashi,
+# Copyright (c) 2008-2023 Minero Aoki, Kenshi Muto, Masayoshi Takahashi,
 #                         KADO Masanori
 #               2002-2007 Minero Aoki
 #

data/lib/review/idgxmlmaker.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2019-2022 Kenshi Muto
+# Copyright (c) 2019-2023 Kenshi Muto
 #
 # This program is free software.
 # You can distribute or modify this program under the terms of
@@ -17,6 +17,7 @@ require 'review/idgxmlbuilder'
 require 'review/version'
 require 'review/makerhelper'
 require 'review/img_math'
+require 'review/img_graph'
 require 'review/loggable'
 
 module ReVIEW
@@ -30,6 +31,7 @@ module ReVIEW
       @basedir = nil
       @logger = ReVIEW.logger
       @img_math = nil
+      @img_graph = nil
       @plaintext = nil
       @compile_errors = nil
     end
@@ -70,6 +72,7 @@ module ReVIEW
 
     def remove_old_files(path)
       @img_math.cleanup_mathimg
+      @img_graph.cleanup_graphimg
       FileUtils.rm_rf(path)
     end
 
@@ -86,6 +89,7 @@ module ReVIEW
       end
 
       @img_math = ReVIEW::ImgMath.new(@config)
+      @img_graph = ReVIEW::ImgGraph.new(@config, 'idgxml', path_name: '_review_graph')
 
       I18n.setup(@config['language'])
       begin
@@ -100,6 +104,13 @@ module ReVIEW
       if @config['math_format'] == 'imgmath'
         @img_math.make_math_images
       end
+
+      begin
+        @img_graph.make_mermaid_images
+      rescue ApplicationError => e
+        error! e.message
+      end
+      @img_graph.cleanup_graphimg
     end
 
     def generate_idgxml_files(yamlfile)
@@ -140,7 +151,7 @@ module ReVIEW
 
     def build_body(basetmpdir, _yamlfile)
       base_path = Pathname.new(@basedir)
-      @converter = ReVIEW::Converter.new(@book, ReVIEW::IDGXMLBuilder.new(img_math: @img_math))
+      @converter = ReVIEW::Converter.new(@book, ReVIEW::IDGXMLBuilder.new(img_math: @img_math, img_graph: @img_graph))
       @book.parts.each do |part|
         if part.name.present?
           if part.file?

data/lib/review/img_graph.rb

@@ -0,0 +1,79 @@
+#
+# Copyright (c) 2023 Kenshi Muto
+#
+# This program is free software.
+# You can distribute/modify this program under the terms of
+# the GNU LGPL, Lesser General Public License version 2.1.
+#
+require 'review/loggable'
+
+module ReVIEW
+  class ImgGraph
+    include Loggable
+
+    def initialize(config, target_name, path_name: '_review_graph')
+      @config = config
+      @target_name = target_name
+      @logger = ReVIEW.logger
+      @graph_dir = File.join(@config['imagedir'], target_name, path_name)
+      @graph_maps = {}
+    end
+
+    attr_reader :graph_maps
+
+    def cleanup_graphimg
+      FileUtils.rm_rf(@graph_dir)
+    end
+
+    def graph_ext
+      if %w[html markdown rst].include?(@target_name)
+        'svg'
+      else
+        'pdf'
+      end
+    end
+
+    def defer_mermaid_image(str, key)
+      @graph_maps[key] = { type: 'mermaid', content: str }
+      File.join('.', @config['imagedir'], @target_name, "#{key}.#{graph_ext}")
+    end
+
+    def mermaid_html(content)
+      <<-EOB
+<!DOCTYPE html>
+<html>
+<head><meta charset="UTF-8"><script type="module">import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@10/dist/mermaid.esm.min.mjs'; mermaid.initialize({ startOnLoad: true });</script></head>
+<body><div><pre class="mermaid">#{content}</pre></div></body></html>
+EOB
+    end
+
+    def make_mermaid_images
+      mermaid_graph_maps = @graph_maps.select { |_k, v| v[:type] == 'mermaid' }
+      return if mermaid_graph_maps.empty?
+
+      FileUtils.mkdir_p(File.join(@graph_dir, 'mermaid'))
+      mermaid_graph_maps.each_pair do |key, val|
+        File.write(File.join(@graph_dir, 'mermaid', "#{key}.html"), mermaid_html(val[:content]))
+      end
+      @logger.info 'calling Playwright'
+
+      begin
+        require 'playwrightrunner'
+        PlaywrightRunner.mermaids_to_images(
+          { playwright_path: @config['playwright_options']['playwright_path'],
+            selfcrop: @config['playwright_options']['selfcrop'],
+            pdfcrop_path: @config['playwright_options']['pdfcrop_path'],
+            pdftocairo_path: @config['playwright_options']['pdftocairo_path'] },
+          src: File.join(@graph_dir, 'mermaid'),
+          dest: File.join(@config['imagedir'], @target_name),
+          type: graph_ext
+        )
+      rescue SystemCallError => e
+        raise ApplicationError, "converting mermaid failed: #{e}"
+      rescue LoadError
+        raise ApplicationError, 'could not handle Mermaid of //graph in this builder.'
+      end
+      FileUtils.rm_rf(File.join(@graph_dir, 'mermaid'))
+    end
+  end
+end

data/lib/review/pdfmaker.rb

@@ -25,6 +25,7 @@ require 'review/template'
 require 'review/latexbox'
 require 'review/call_hook'
 require 'review/loggable'
+require 'review/img_graph'
 
 module ReVIEW
   class PDFMaker
@@ -260,17 +261,26 @@ module ReVIEW
     def generate_pdf
       remove_old_file
       @path = build_path
+      @img_graph = ReVIEW::ImgGraph.new(@config, 'latex', path_name: '_review_graph')
+
       begin
         @compile_errors = nil
 
         book = ReVIEW::Book::Base.new(@basedir, config: @config)
-        @converter = ReVIEW::Converter.new(book, ReVIEW::LATEXBuilder.new)
+        @converter = ReVIEW::Converter.new(book, ReVIEW::LATEXBuilder.new(img_graph: @img_graph))
         erb_config
 
         @input_files = make_input_files(book)
 
         check_compile_status(@config['ignore-errors'])
 
+        begin
+          @img_graph.make_mermaid_images
+        rescue ApplicationError => e
+          error! e.message
+        end
+        @img_graph.cleanup_graphimg
+
         # for backward compatibility
         @config['usepackage'] = ''
         @config['usepackage'] = "\\usepackage{#{@config['texstyle']}}" if @config['texstyle']

data/lib/review/plaintextbuilder.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2018-2022 Kenshi Muto
+# Copyright (c) 2018-2023 Kenshi Muto
 #
 # This program is free software.
 # You can distribute or modify this program under the terms of
@@ -723,6 +723,18 @@ module ReVIEW
       str
     end
 
+    def graph_mermaid(_id, file_path, _line, _tf_path)
+      if self.instance_of?(ReVIEW::PLAINTEXTBuilder)
+        file_path
+      else
+        super
+      end
+    end
+
+    def image_ext
+      'png'
+    end
+
     alias_method :th, :nofunc_text
     alias_method :td, :nofunc_text
     alias_method :inline_sup, :nofunc_text

data/lib/review/textmaker.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2018-2022 Kenshi Muto
+# Copyright (c) 2018-2023 Kenshi Muto
 #
 # This program is free software.
 # You can distribute or modify this program under the terms of
@@ -17,6 +17,7 @@ require 'review/topbuilder'
 require 'review/version'
 require 'review/makerhelper'
 require 'review/img_math'
+require 'review/img_graph'
 require 'review/loggable'
 
 module ReVIEW
@@ -31,6 +32,7 @@ module ReVIEW
       @logger = ReVIEW.logger
       @plaintext = nil
       @img_math = nil
+      @img_graph = nil
       @compile_errors = nil
     end
 
@@ -67,6 +69,7 @@ module ReVIEW
 
     def remove_old_files(path)
       @img_math.cleanup_mathimg
+      @img_graph.cleanup_graphimg
       FileUtils.rm_rf(path)
     end
 
@@ -83,6 +86,7 @@ module ReVIEW
       end
 
       @img_math = ReVIEW::ImgMath.new(@config, path_name: '_review_math_text')
+      @img_graph = ReVIEW::ImgGraph.new(@config, 'top', path_name: '_review_graph')
 
       I18n.setup(@config['language'])
       begin
@@ -97,6 +101,13 @@ module ReVIEW
       if @config['math_format'] == 'imgmath'
         @img_math.make_math_images
       end
+
+      begin
+        @img_graph.make_mermaid_images
+      rescue ApplicationError => e
+        error! e.message
+      end
+      @img_graph.cleanup_graphimg
     end
 
     def generate_text_files(yamlfile)
@@ -117,9 +128,9 @@ module ReVIEW
     def build_body(basetmpdir, _yamlfile)
       base_path = Pathname.new(@basedir)
       builder = if @plaintext
-                  ReVIEW::PLAINTEXTBuilder.new(img_math: @img_math)
+                  ReVIEW::PLAINTEXTBuilder.new(img_math: @img_math, img_graph: @img_graph)
                 else
-                  ReVIEW::TOPBuilder.new(img_math: @img_math)
+                  ReVIEW::TOPBuilder.new(img_math: @img_math, img_graph: @img_graph)
                 end
       @converter = ReVIEW::Converter.new(@book, builder)
       @book.parts.each do |part|

data/lib/review/version.rb

@@ -1,3 +1,3 @@
 module ReVIEW
-  VERSION = '5.7.0'.freeze
+  VERSION = '5.8.0'.freeze
 end

data/review.gemspec

@@ -25,6 +25,7 @@ Gem::Specification.new do |gem|
   gem.add_dependency('rubyzip')
   gem.add_dependency('tty-logger')
   gem.add_development_dependency('mini_magick')
+  gem.add_development_dependency('playwright-runner')
   gem.add_development_dependency('pygments.rb')
   gem.add_development_dependency('rake')
   gem.add_development_dependency('rubocop', '~> 1.45.1')

data/samples/syntax-book/ch02.re

@@ -365,6 +365,12 @@ labelで定義したラベルへの参照の例です。EPUBだと@<href>{#inlin
  : @<column>{ch03|column2}
 	コラム参照
 
+URLは@<embed>{@}<href>を使います。@<href>{https://localhost/longlonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglong}@<fn>{fnref}
+
+//footnote[fnref][脚注に長いURLを入れてみます。@<href>{https://localhost/longlonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglonglong}]
+
+
+
 === 参考文献
 参考文献@<tt>{bib.re}ファイルへの文献参照は、@<bib>{lins}とします。
 

data/templates/latex/review-jlreq/review-jlreq.cls

@@ -224,6 +224,20 @@
   \RequirePackage{pxjahyper}
 \fi
 
+%% better line breaks for long urls
+\AtBeginDocument{%
+  %% modified url.sty
+  \def\UrlBreaks{%
+    \do\0\do\1\do\2\do\3\do\4\do\5\do\6\do\7\do\8\do\9%
+    \do\A\do\B\do\C\do\D\do\E\do\F\do\G\do\H\do\I\do\J\do\K\do\L\do\M\do\N%
+    \do\O\do\P\do\Q\do\R\do\S\do\T\do\U\do\V\do\W\do\X\do\Y\do\Z%
+    \do\a\do\b\do\c\do\d\do\e\do\f\do\g\do\h\do\i\do\j\do\k\do\l\do\m\do\n%
+    \do\o\do\p\do\q\do\r\do\s\do\t\do\u\do\v\do\w\do\x\do\y\do\z%
+    %%
+    \do\.\do\@\do\\\do\/\do\!\do\_\do\|\do\;\do\>\do\]%
+    \do\)\do\,\do\?\do\&\do\'\do+\do\=\do\#}%
+}
+
 %% include fullpage graphics
 \edef\grnchry@head{\dimexpr\topmargin+1in+\headheight+\headsep}
 \edef\grnchry@gutter{\evensidemargin}

data/templates/latex/review-jsbook/review-jsbook.cls

@@ -400,6 +400,20 @@
 ]{hyperref}
 \RequirePackage{pxjahyper}
 
+%% better line breaks for long urls
+\AtBeginDocument{%
+  %% modified url.sty
+  \def\UrlBreaks{%
+    \do\0\do\1\do\2\do\3\do\4\do\5\do\6\do\7\do\8\do\9%
+    \do\A\do\B\do\C\do\D\do\E\do\F\do\G\do\H\do\I\do\J\do\K\do\L\do\M\do\N%
+    \do\O\do\P\do\Q\do\R\do\S\do\T\do\U\do\V\do\W\do\X\do\Y\do\Z%
+    \do\a\do\b\do\c\do\d\do\e\do\f\do\g\do\h\do\i\do\j\do\k\do\l\do\m\do\n%
+    \do\o\do\p\do\q\do\r\do\s\do\t\do\u\do\v\do\w\do\x\do\y\do\z%
+    %%
+    \do\.\do\@\do\\\do\/\do\!\do\_\do\|\do\;\do\>\do\]%
+    \do\)\do\,\do\?\do\&\do\'\do+\do\=\do\#}%
+}
+
 %% more useful macros
 %% ----------
 %% include fullpage graphics

metadata

@@ -1,15 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: review
 version: !ruby/object:Gem::Version
-  version: 5.7.0
+  version: 5.8.0
 platform: ruby
 authors:
 - kmuto
 - takahashim
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-02-28 00:00:00.000000000 Z
+date: 2023-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: image_size
@@ -95,6 +95,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: playwright-runner
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: pygments.rb
   requirement: !ruby/object:Gem::Requirement
@@ -354,6 +368,7 @@ files:
 - lib/review/i18n.yml
 - lib/review/idgxmlbuilder.rb
 - lib/review/idgxmlmaker.rb
+- lib/review/img_graph.rb
 - lib/review/img_math.rb
 - lib/review/index_builder.rb
 - lib/review/init-web/finish.html
@@ -590,7 +605,7 @@ licenses:
 - LGPL
 metadata:
   rubygems_mfa_required: 'true'
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -605,8 +620,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 3.4.14
+signing_key:
 specification_version: 4
 summary: 'Re:VIEW: a easy-to-use digital publishing system'
 test_files: []