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! ⇒ Object

Step 1: ビルド前の画像準備。

かつてここで images/ へ .webp を並置していたが、やめた（2026-08-17・ image-format-per-target-spec.md §3.1）。あれは「原稿の .png / .jpg 参照を 無条件で .webp へ読み替える」実装を成立させるためのもので、画質やサイズのために やっていたわけではない。読み替えを撤去し、素材はそのまま使ってターゲットごとの 派生をビルドが作る方式へ移したので、この変換は要らなくなった。

素材そのものを軽くしたい著者は vs resize を明示的に実行する（§3.5：素材を 機械が黙って書き換えないという原則の出口）。

残すのは Techbook モードの SVG ラスタライズだけ。これは Type 3 フォント対策で、 画像最適化とは別の目的を持つ。



27
28
29
30
31
32
33
34
35
36
37
38
39
 
# File 'lib/vivlio_starter/cli/build/image_optimizer.rb', line 27

def optimize_images!
  dirs = [Common::IMAGES_DIR, File.join(Common::STYLESHEETS_DIR, 'images'), Common.data_dir]
  Common.log_info('[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 の事前生成



42
43
44
45
46
47
48
49
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
 
# File 'lib/vivlio_starter/cli/build/image_optimizer.rb', line 42

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