Module: VivlioStarter::CLI::Build::ImageOptimizer

Defined in:
lib/vivlio_starter/cli/build/image_optimizer.rb

Overview

ImageOptimizer: 画像最適化モジュール

WebP変換、リサイズ、テーマ画像の準備を担当する。

Class Method Summary collapse

Class Method Details

.optimize_images!(preset = nil) ⇒ Object

Step 2: 画像最適化（WebP 変換/リサイズ）



15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
 
# File 'lib/vivlio_starter/cli/build/image_optimizer.rb', line 15

def optimize_images!(preset = nil)
  p = preset&.to_sym || :medium
  preset_task = { high: 'resize:high', low: 'resize:low' }[p] || 'resize:medium'

  Common.log_action("[Step 1] 画像の最適化（WebP 変換/リサイズ）を実行します… preset=#{p}")
  # data/ 配下の png/jpg も対象に含める（QueryStream データ画像の .webp 並置・spec §3.6）。
  dirs = [Common::IMAGES_DIR, File.join(Common::STYLESHEETS_DIR, 'images'), Common.data_dir]
  dirs.each do |d|
    if Dir.exist?(d)
      Common.log_info("[Step 1] 対象ディレクトリ: #{d}（preset: #{p}）")
      case preset_task
      when 'resize:high'
        ResizeCommands.execute_resize_high(d)
      when 'resize:low'
        ResizeCommands.execute_resize_low(d)
      else
        ResizeCommands.execute_resize_medium(d)
      end
    else
      Common.log_info("[Step 1] スキップ（存在しません）: #{d}")
    end
  end
  Common.log_success('[Step 1] 画像最適化が完了しました')

  # Techbook モード: 全 SVG を rsvg-convert → lossless WebP に変換
  # Chromium PDF エンジンが SVG 内のパスを Type 3 フォントとして埋め込む問題を回避する
  if Common::CONFIG.output.pdf.techbook == true
    # dirs には data/ も含まれるため、データ画像の SVG も Type 3 フォント問題回避の対象になる。
    svg_dirs = dirs + [File.join(Common::STYLESHEETS_DIR, 'twemoji')]
    Common.log_action('[Step 1] Techbook: SVG → lossless WebP 変換を実行します')
    ResizeCommands.convert_svg_to_webp(svg_dirs)
  end
end

.prepare_theme_images! ⇒ Object

Step 3: frontispiece / ornament の事前生成



50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
 
# File 'lib/vivlio_starter/cli/build/image_optimizer.rb', line 50

def prepare_theme_images!
  Common.log_action('[Step 2] frontispiece / ornament の準備を開始します…')

  cfg = Common::CONFIG
  theme_cfg = cfg[:theme]
  unless theme_cfg
    Common.log_info('[Step 2] theme 設定が存在しないためスキップします')
    return
  end

  # theme.color / frontispiece / ornament の設定ミスを著者向けに警告する（一度だけ）
  require_relative '../pre_process/theme_validator'
  VivlioStarter::CLI::PreProcessCommands::ThemeValidator.validate!(cfg)

  # ビルド設定を .cache/vs/book-settings.css へ全文生成する（課題 C / P3）。
  # 全モード（full/preflight/single）がこのステップを通るため、生成器の唯一の接続先。
  require_relative '../pre_process/book_settings_css'
  VivlioStarter::CLI::PreProcessCommands::BookSettingsCss.generate!(cfg)

  # style: simple のときは画像を使わないため生成をスキップ
  theme_style = theme_cfg[:style].to_s.strip.downcase
  if theme_style == 'simple'
    Common.log_info('[Step 2] style: simple のため frontispiece / ornament の生成をスキップします')
    return
  end

  frontispiece_entry = theme_cfg[:frontispiece]
  ornament_entry = theme_cfg[:ornament]

  # String の場合はそのまま、Data オブジェクトの場合は :image を取得
  frontispiece_source = frontispiece_entry.is_a?(String) ? frontispiece_entry : frontispiece_entry&.dig(:image)
  ornament_source = ornament_entry

  generated_any = false

  if frontispiece_source && !frontispiece_source.to_s.strip.empty?
    path = VivlioStarter::CLI::PreProcessCommands.resolve_frontispiece_path(frontispiece_source,
                                                                              allow_generation: true)
    Common.log_success("[Step 2] frontispiece を準備しました: #{path}")
    generated_any = true
  else
    Common.log_info('[Step 2] frontispiece 設定なし（既定画像を使用）')
  end

  if ornament_source && !ornament_source.to_s.strip.empty?
    path = VivlioStarter::CLI::PreProcessCommands.resolve_ornament_path(ornament_source,
                                                                          allow_generation: true)
    Common.log_success("[Step 2] ornament を準備しました: #{path}")
    generated_any = true
  else
    Common.log_info('[Step 2] ornament 設定なし（既定画像を使用）')
  end

  Common.log_info('[Step 2] 追加生成は不要でした') unless generated_any
rescue StandardError => e
  Common.log_warn("[Step 2] frontispiece / ornament 準備中にエラーが発生しました: #{e.message}")
end