Module: VivlioStarter::CLI::CoverCommands

Defined in:
lib/vivlio_starter/cli/cover.rb

Overview

================================================================

Module: カバー画像生成ロジック

提供機能:

- マスター画像から各フォーマット用カバー画像を生成
- A4/B5/A5/EPUB 対応

================================================================

Constant Summary collapse

DESCRIPTION = 
'カバー画像を生成'
LONG_DESCRIPTION = 
<<~DESC
  マスター画像（frontcover_master.png, backcover_master.png）から
  各フォーマット用のカバー画像を生成します。

  使用例:
    vs cover              # 自動判定して一括生成
    vs cover a4           # A4サイズのCMYK版PDF/X-1a生成
    vs cover b5           # B5サイズのCMYK版PDF/X-1a生成
    vs cover a5           # A5サイズのCMYK版PDF/X-1a生成
    vs cover epub         # EPUB用JPEG生成

  必要なツール:
    - ImageMagick (convert コマンド)
    - Ghostscript (gs コマンド)
DESC
FRONTCOVER_MASTER =

マスターファイル名

'frontcover_master.png'
BACKCOVER_MASTER = 
'backcover_master.png'
SIZES =

サイズ定義（350 dpi基準、本文サイズ＝塗り足しなし）

{
  a4: { width: 2894, height: 4091, mm: [210, 297] },
  b5: { width: 2508, height: 3541, mm: [182, 257] },
  a5: { width: 2039, height: 2894, mm: [148, 210] }
}.freeze
DPI = 
350
CROP_MARK_OFFSET_MM =

トンボオフセット（Vivliostyle 準拠）

13.0
EPUB_SIZE =

EPUB用サイズ

{ width: 1600, height: 2560 }.freeze
STANDARD_THEMES =

標準テーマかどうかを判定

%w[light dark].freeze

Class Method Summary collapse

Class Method Details

.check_master_files(covers_dir) ⇒ Object

マスターファイルの存在確認



260
261
262
263
264
265
266
267
268
269
270
271
 
# File 'lib/vivlio_starter/cli/cover.rb', line 260

def self.check_master_files(covers_dir)
  frontcover = File.join(covers_dir, FRONTCOVER_MASTER)
  backcover = File.join(covers_dir, BACKCOVER_MASTER)

  front_exists = File.exist?(frontcover)
  back_exists = File.exist?(backcover)

  Common.log_warn("表紙マスターが見つかりません: #{frontcover}") unless front_exists
  Common.log_warn("裏表紙マスターが見つかりません: #{backcover}") unless back_exists

  front_exists || back_exists
end

.detect_page_size(page_use) ⇒ Object

ページサイズを判定



251
252
253
254
255
256
257
 
# File 'lib/vivlio_starter/cli/cover.rb', line 251

def self.detect_page_size(page_use)
  case page_use.to_s.downcase[0..1]
  in 'a4' then :a4
  in 'a5' then :a5
  else :b5 # デフォルト
  end
end

.ensure_cover_files_for_build! ⇒ void

This method returns an undefined value.

テーマに応じたカバーファイルを確実に生成する

  • light/dark: SVGテンプレートから生成し PDF/JPG に変換
  • master/カスタム: 既存PNGから PDF/JPG に変換


68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
 
# File 'lib/vivlio_starter/cli/cover.rb', line 68

def self.ensure_cover_files_for_build!
  theme = Common.cover_theme
  return unless theme
  return unless Common.validate_cover_settings

  if STANDARD_THEMES.include?(theme)
    require_relative 'create' unless defined?(CreateCommands)
    CreateCommands.execute_cover({})
  else
    config = Common::CONFIG
    page_use = config.page.use || 'b5_standard'
    size = detect_page_size(page_use)
    # PDF カバー（RGB/CMYK）は pdf/print_pdf ターゲットがある場合のみ生成する。
    # epub/kindle のみのビルドでは不要で、無条件に呼ぶと execute_for_size が
    # 「生成対象がありません」と誤警告するため、ターゲットで分岐する。
    targets = target_list(config)
    execute_for_size(size, nil) if targets.intersect?(%w[pdf print_pdf])
    # EPUB/Kindle 表紙の元になる JPG は常に生成する。
    generate_epub_cover(Common.covers_dir, config)
  end
end

.execute_epub(_context = nil) ⇒ Object 



176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
 
# File 'lib/vivlio_starter/cli/cover.rb', line 176

def execute_epub(_context = nil)
  Common.log_info '📚 EPUB用JPEGを生成します'
  config = Common::CONFIG
  theme = config.output.cover

  unless theme
    Common.log_error 'output.cover 設定が見つかりません'
    return
  end

  # light/dark テーマ: SVGテンプレートから生成（SVG→JPG変換含む）
  if STANDARD_THEMES.include?(theme)
    require_relative 'create' unless defined?(CreateCommands)
    CreateCommands.execute_cover({})
    Common.log_success '✅ EPUB用JPEGの生成が完了しました'
    return
  end

  # master/カスタム テーマ: PNGから生成
  covers_dir = Common.covers_dir
  input_file = CoverCommands.resolve_epub_cover_input(covers_dir, theme)
  unless input_file
    Common.log_error "カバー入力画像が見つかりません（テーマ: #{theme}）"
    return
  end

  CoverCommands.generate_epub_cover(covers_dir, config)
  Common.log_success '✅ EPUB用JPEGの生成が完了しました'
end

.execute_for_size(page_size, _context = nil) ⇒ Object 



144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
 
# File 'lib/vivlio_starter/cli/cover.rb', line 144

def execute_for_size(page_size, _context = nil)
  label = page_size.to_s.upcase
  Common.log_info "📚 #{label}サイズのカバーPDFを生成します"
  config = Common::CONFIG
  theme = config.output.cover || 'master'

  # light/dark テーマ: SVGテンプレートから生成
  if STANDARD_THEMES.include?(theme)
    require_relative 'create' unless defined?(CreateCommands)
    CreateCommands.execute_cover({})
    return
  end

  # master/カスタム テーマ: PNGから生成
  covers_dir = Common.covers_dir
  targets = target_list(config)

  unless CoverCommands.check_master_files(covers_dir)
    Common.log_error 'マスターファイルが見つかりません'
    return
  end

  generated = generate_pdf_targets_for_size(covers_dir, page_size, config, targets)

  if generated.empty?
    Common.log_warn('生成対象がありませんでした (pdf/print_pdf ターゲットが無効化されている可能性があります)')
  else
    Common.log_success("✅ #{label}カバーPDFの生成が完了しました: #{generated.join(', ')}")
  end
end

.execute_generate(_context = nil) ⇒ Object

================================================================

コマンド実装



94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
 
# File 'lib/vivlio_starter/cli/cover.rb', line 94

def execute_generate(_context = nil)
  Common.log_info '📚 カバー画像の一括生成を開始します'

  config = Common::CONFIG
  theme = config.output.cover

  unless theme
    Common.log_error 'output.cover 設定が見つかりません'
    return
  end

  # light/dark テーマ: SVGテンプレートから一括生成
  if STANDARD_THEMES.include?(theme)
    require_relative 'create' unless defined?(CreateCommands)
    CreateCommands.execute_cover({})
    return
  end

  # master/カスタム テーマ: PNGから生成
  covers_dir = Common.covers_dir
  page_cfg = config.page
  page_use = page_cfg[:use] || page_cfg[:preset] || page_cfg[:preset_name] || page_cfg[:size] || 'b5_standard'
  targets = target_list(config)
  page_size = CoverCommands.detect_page_size(page_use)
  Common.log_info "ページサイズ: #{page_size.upcase} (#{page_use})"

  unless CoverCommands.check_master_files(covers_dir)
    Common.log_error 'マスターファイルが見つかりません。処理を中断します。'
    return
  end
  generated = []

  generated += generate_pdf_targets_for_size(covers_dir, page_size, config, targets)

  # EPUB用カバー
  if targets.include?('epub')
    Common.log_info "\n📱 EPUB用カバー（1600×2560、JPEG）を生成中..."
    CoverCommands.generate_epub_cover(covers_dir, config)
    generated << 'EPUB用（JPEG）'
  end

  if generated.empty?
    Common.log_warn 'book.yml に出力設定が見つかりませんでした'
  else
    Common.log_success "\n✅ カバー画像の生成が完了しました"
    Common.log_info "生成されたカバー: #{generated.join(', ')}"
  end
end

.find_executable(command) ⇒ Object 



605
606
607
608
609
610
611
612
613
614
 
# File 'lib/vivlio_starter/cli/cover.rb', line 605

def self.find_executable(command)
  return nil if command.to_s.empty?

  ENV.fetch('PATH', '').split(File::PATH_SEPARATOR).each do |dir|
    path = File.join(dir, command)
    return path if File.executable?(path) && !File.directory?(path)
  end

  nil
end

.generate_cmyk_pdf(covers_dir, page_size, config) ⇒ Object

印刷用 CMYK PDF 生成（print_pdf ターゲット用）

  • size は常に仕上がりサイズ（base_size）を渡す
  • 塗り足し・トンボオフセットの加算は generate_pdfx_single 内で行う
  • crop_marks: true を渡すことでトンボ付き PDF を生成する


331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
 
# File 'lib/vivlio_starter/cli/cover.rb', line 331

def self.generate_cmyk_pdf(covers_dir, page_size, config)
  base_size = SIZES[page_size] # 仕上がりサイズ（塗り足しなし）
  bleed_mm  = parse_bleed_mm(config)

  Common.log_info "  塗り足し: #{bleed_mm}mm（片側）" if bleed_mm.positive?

  theme       = config.dig(:output, :cover) || 'master'
  cover_bleed = (config.dig(:output, :print_pdf, :cover_bleed) || 'scale').to_s
  FileUtils.mkdir_p(Common.cover_cache_dir)

  # print_pdf ターゲットは常にトンボ付きで生成する
  %w[front back].each do |side|
    base_input = theme == 'master' ? "#{side}cover_master.png" : "#{side}cover_#{theme}.png"
    src, fill  = resolve_print_cover_input(covers_dir, base_input, cover_bleed)
    cache_pdf  = File.join(Common.cover_cache_dir, "#{side}cover_#{theme}_#{page_size}_cmyk.pdf")
    CoverCommands.generate_pdfx_single(
      File.join(covers_dir, src),
      cache_pdf,
      base_size,
      bleed_mm: bleed_mm,
      crop_marks: true,
      fill: fill
    )
    CoverCommands.publish_print_cover!(side, cache_pdf)
  end
end

.generate_epub_cover(covers_dir, config) ⇒ Object

EPUB用カバー生成（テーマベース）

output.cover テーマに応じて入力画像を選択し cover_theme.jpg を生成する

  • light/dark: SVGから変換済みの frontcover_theme.png、なければSVG直接
  • master: frontcover_master.png
  • カスタム: frontcover_theme.png

Parameters:

  • covers_dir (String) —

    カバーディレクトリ

  • config (Hash) —

    シンボルキーの設定ハッシュ



536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
 
# File 'lib/vivlio_starter/cli/cover.rb', line 536

def self.generate_epub_cover(covers_dir, config)
  theme = config.dig(:output, :cover)
  return unless theme

  # 入力はソース置き場（covers_dir）から、出力（生成物）は cache へ（移設仕様 §3.5）
  FileUtils.mkdir_p(Common.cover_cache_dir)
  output_jpg = File.join(Common.cover_cache_dir, "cover_#{theme}.jpg")

  # 入力画像を解決（PNG優先、SVGフォールバック）
  input_file = resolve_epub_cover_input(covers_dir, theme)
  unless input_file
    Common.log_warn("EPUB用カバーの入力画像が見つかりません（テーマ: #{theme}）")
    return
  end

  convert_cmd = imagemagick_convert_command
  unless convert_cmd
    Common.log_error 'ImageMagick（magick/convert）が見つかりません'
    return
  end

  Common.log_info "  生成中: #{File.basename(output_jpg)}"

  cmd = convert_cmd + [
    input_file,
    '-resize', "x#{EPUB_SIZE[:height]}",
    '-gravity', 'center',
    '-crop', "#{EPUB_SIZE[:width]}x#{EPUB_SIZE[:height]}+0+0",
    '+repage',
    '-quality', '90',
    output_jpg
  ]

  Common.log_error "  失敗: #{File.basename(output_jpg)}" unless system(*cmd, out: File::NULL, err: File::NULL)
end

.generate_pdf_targets_for_size(covers_dir, page_size, config, targets) ⇒ Object 



227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
 
# File 'lib/vivlio_starter/cli/cover.rb', line 227

def generate_pdf_targets_for_size(covers_dir, page_size, config, targets)
  generated = []
  label = page_size.to_s.upcase
  pdf_target_enabled = targets.include?('pdf')
  print_target_enabled = targets.include?('print_pdf')

  # 新しい設定構造に対応
  if pdf_target_enabled
    Common.log_info("\n🎨 PDF用カバー（#{label}、RGB）を生成中...")
    CoverCommands.generate_rgb_pdf(covers_dir, page_size, config)
    generated << 'PDF用（RGB）'
  end

  if print_target_enabled
    Common.log_info("\n🖨️  印刷用カバー（#{label}、CMYK、PDF/X-1a）を生成中...")
    CoverCommands.generate_cmyk_pdf(covers_dir, page_size, config)
    generated << "印刷用（#{label}、PDF/X-1a）"
  end

  generated
end

.generate_pdfx_single(input_png, output_pdf, size, bleed_mm:, crop_marks: false, fill: :bleed) ⇒ Object

CMYK PDF 生成（単一ファイル）

crop_marks: false 時（pdf ターゲット）:

PNG → 塗り足し込みサイズ(trim+bleed×2)でリサイズ + CMYK変換 → PDF

crop_marks: true 時（print_pdf ターゲット）:

PNG → 充填サイズ(fill=:bleed なら trim+bleed×2 / :trim なら trim)へリサイズ
  → トンボ代(offset)帯を白で残して全紙サイズへ中央配置 → 中間 PDF
  → add_crop_marks_overlay でトンボを追加
  → Build::CmykConverter で Japan Color 2001 Coated → CMYK PDF/X-1a 化（ICC 有時）

ICC が使える環境（press-ready 同梱 or 設定指定）ではレイアウトを RGB で作り、 gs で ICC ベース CMYK 変換＋PDF/X-1a 出力インテント埋込を行う。ICC 不在時は 従来どおり ImageMagick の素朴 CMYK 変換にフォールバックする。

Parameters:

  • input_png (String) —

    入力 PNG パス

  • output_pdf (String) —

    出力 PDF パス

  • size (Hash) —

    仕上がりサイズ { width: px, height: px, mm: [w, h] }

  • bleed_mm (Float) —

    塗り足し幅（mm）

  • crop_marks (Boolean) (defaults to: false) —

    トンボを付与するか

  • fill (Symbol) (defaults to: :bleed) —

    充填モード（:bleed=塗り足し込み / :trim=仕上がりのみ）



424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
 
# File 'lib/vivlio_starter/cli/cover.rb', line 424

def self.generate_pdfx_single(input_png, output_pdf, size, bleed_mm:, crop_marks: false, fill: :bleed)
  return unless File.exist?(input_png)

  convert_cmd = imagemagick_convert_command
  unless convert_cmd
    Common.log_error 'ImageMagick（magick/convert）が見つかりません'
    return
  end

  Common.log_info "  生成中: #{File.basename(output_pdf)}"

  trim_w_px = size[:width]
  trim_h_px = size[:height]
  trim_w_mm = size[:mm][0]
  trim_h_mm = size[:mm][1]
  px_per_mm = DPI / Units::MM_PER_INCH

  if crop_marks
    # --- Phase: トンボ付き PDF 生成 ---
    # 画像は塗り足しボックス(trim+bleed×2)または仕上がり(trim)サイズに収め、
    # トンボ代(offset)帯を白で残して全紙サイズへ中央配置する。かつて画像を全紙
    # サイズ(trim+(bleed+offset)×2)へ引き伸ばし約 +15% 拡大していた不具合を是正。
    require_relative 'create' unless defined?(CreateCommands)

    # ページサイズ = 仕上がり + 塗り足し×2 + オフセット×2
    offset_mm  = CROP_MARK_OFFSET_MM
    bleed_px   = (bleed_mm * px_per_mm).round
    margin_px  = ((bleed_mm + offset_mm) * px_per_mm).round
    total_w_px = trim_w_px + (2 * margin_px)
    total_h_px = trim_h_px + (2 * margin_px)

    content_w_px, content_h_px =
      if fill == :trim
        [trim_w_px, trim_h_px]
      else
        [trim_w_px + (2 * bleed_px), trim_h_px + (2 * bleed_px)]
      end

    temp_pdf = "#{output_pdf}.temp.pdf"

    # ICC ベースの CMYK 変換が可能なら、レイアウトは RGB で作り、後段の gs で
    # Japan Color 2001 Coated → CMYK PDF/X-1a 化する（くすみ解消・出力インテント埋込）。
    # ICC が無い環境では従来どおり magick の素朴 CMYK 変換にフォールバックする。
    use_icc = Build::CmykConverter.available?
    colorspace_args = use_icc ? [] : ['-colorspace', 'CMYK']

    begin
      # Step 1: 画像を充填サイズへリサイズ→白背景の全紙サイズへ中央配置→PDF
      cmd_convert = convert_cmd + [
        input_png,
        '-resize', "#{content_w_px}x#{content_h_px}!",
        '-background', 'white',
        '-gravity', 'center',
        '-extent', "#{total_w_px}x#{total_h_px}",
        *colorspace_args,
        '-density', DPI.to_s,
        '-units', 'PixelsPerInch',
        temp_pdf
      ]
      unless system(*cmd_convert, out: File::NULL, err: File::NULL)
        Common.log_error "  失敗（PDF生成）: #{File.basename(output_pdf)}"
        return
      end

      # Step 2: add_crop_marks_overlay でトンボを追加
      CreateCommands.add_crop_marks_overlay(temp_pdf, trim_w_mm, trim_h_mm, bleed_mm, offset_mm)

      # Step 2b: ICC ベースの CMYK PDF/X-1a 化（gs で色変換＋出力インテント埋込、
      # qpdf で TrimBox/BleedBox 確定）。失敗時は RGB のまま残す（印刷所側で変換可能）。
      if use_icc
        Build::CmykConverter.to_pdfx!(temp_pdf, bleed_mm:, crop_offset_mm: offset_mm,
                                                title: File.basename(output_pdf, '.pdf'))
      end

      # Step 3: 中間PDFを最終PDFにリネーム
      FileUtils.mv(temp_pdf, output_pdf)
    rescue StandardError => e
      Common.log_error "  失敗（トンボ付きPDF生成）: #{File.basename(output_pdf)} - #{e.message}"
      FileUtils.rm_f(temp_pdf) if temp_pdf && File.exist?(temp_pdf)
    end

  else
    # --- Phase: トンボなし PDF 生成（pdf ターゲット）---
    # 塗り足し込みサイズでリサイズして PDF 変換（既存動作を維持）
    bleed_px   = (bleed_mm * px_per_mm).round
    bleed_w_px = trim_w_px + (2 * bleed_px)
    bleed_h_px = trim_h_px + (2 * bleed_px)

    cmd_convert = convert_cmd + [
      input_png,
      '-resize', "#{bleed_w_px}x#{bleed_h_px}!",
      '-colorspace', 'CMYK',
      '-density', DPI.to_s,
      '-units', 'PixelsPerInch',
      output_pdf
    ]

    unless system(*cmd_convert, out: File::NULL, err: File::NULL)
      Common.log_error "  失敗（変換）: #{File.basename(output_pdf)}"
    end
  end
end

.generate_rgb_pdf(covers_dir, page_size, config) ⇒ Object

RGB版PDF生成（ページサイズ依存） 入力（マスター PNG）は covers_dir から、出力（生成物）は cover_cache_dir へ （generated-assets 移設仕様 §3.5: ソース探索と生成物書き込みの分離）



276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
 
# File 'lib/vivlio_starter/cli/cover.rb', line 276

def self.generate_rgb_pdf(covers_dir, page_size, config)
  size = SIZES[page_size] || SIZES[:b5]
  theme = config.dig(:output, :cover) || 'master'
  FileUtils.mkdir_p(Common.cover_cache_dir)

  # 新しい命名規則で出力ファイル名を生成
  front_output = "frontcover_#{theme}_#{page_size}_rgb.pdf"
  back_output = "backcover_#{theme}_#{page_size}_rgb.pdf"

  # masterテーマの場合はmaster.pngを、それ以外はテーマ名のPNGを使用
  front_input = theme == 'master' ? FRONTCOVER_MASTER : "frontcover_#{theme}.png"
  back_input = theme == 'master' ? BACKCOVER_MASTER : "backcover_#{theme}.png"

  CoverCommands.generate_rgb_pdf_single(
    File.join(covers_dir, front_input),
    File.join(Common.cover_cache_dir, front_output),
    size
  )

  CoverCommands.generate_rgb_pdf_single(
    File.join(covers_dir, back_input),
    File.join(Common.cover_cache_dir, back_output),
    size
  )
end

.generate_rgb_pdf_single(input_png, output_pdf, size) ⇒ Object

RGB版PDF生成（単一ファイル）



303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
 
# File 'lib/vivlio_starter/cli/cover.rb', line 303

def self.generate_rgb_pdf_single(input_png, output_pdf, size)
  return unless File.exist?(input_png)

  convert_cmd = imagemagick_convert_command
  unless convert_cmd
    Common.log_error 'ImageMagick（magick/convert）が見つかりません'
    return
  end

  Common.log_info "  生成中: #{File.basename(output_pdf)}"

  # ImageMagickでPNG→PDF変換
  cmd = convert_cmd + [
    input_png,
    '-resize', "#{size[:width]}x#{size[:height]}!",
    '-density', '350',
    '-units', 'PixelsPerInch',
    output_pdf
  ]

  Common.log_error "  失敗: #{File.basename(output_pdf)}" unless system(*cmd, out: File::NULL, err: File::NULL)
end

.imagemagick_convert_command ⇒ Object 



597
598
599
600
601
602
603
 
# File 'lib/vivlio_starter/cli/cover.rb', line 597

def self.imagemagick_convert_command
  return ['magick'] if find_executable('magick')

  return ['convert'] if find_executable('convert')

  nil
end

.parse_bleed_mm(config) ⇒ Object

bleed 値を mm で取得（"3mm" → 3）



617
618
619
620
621
622
 
# File 'lib/vivlio_starter/cli/cover.rb', line 617

def self.parse_bleed_mm(config)
  bleed_raw = config.dig(:output, :print_pdf, :bleed)
  return 0 unless bleed_raw

  bleed_raw.to_s.gsub(/mm\z/i, '').to_f
end

.publish_print_cover!(side, cache_pdf_path) ⇒ String?

印刷カバー PDF（CMYK）をルート直下へ成果品として複製する（移設仕様 §3.4）。 CMYK カバーは入稿物であり、著者が covers/ や .cache を掘らずに最終 print PDF と 同じ場所（ルート）で入稿一式を揃えられるようにする。cache 側は再生成判定と vs cover 再実行の生成場所として残すため move ではなく copy とする。

Parameters:

  • side (String) —

    'front' | 'back'

  • cache_pdf_path (String) —

    cache 内の内部名 CMYK PDF

Returns:

  • (String, nil) —

    ルート側の成果品パス（生成元が無ければ nil）



366
367
368
369
370
371
372
373
374
375
376
377
378
379
 
# File 'lib/vivlio_starter/cli/cover.rb', line 366

def self.publish_print_cover!(side, cache_pdf_path)
  return nil unless File.exist?(cache_pdf_path)

  output = Common.generate_cover_output_filename(side)
  FileUtils.cp(cache_pdf_path, output)
  # 1 ビルド内でカバー生成は複数回走り得る（print フェーズ＋Step 10）ため、
  # 常時表示の log_result は同一成果品につきプロセス内 1 回に抑える
  @published_print_covers ||= {}
  unless @published_print_covers[output]
    @published_print_covers[output] = true
    Common.log_result("入稿用カバー PDF: #{output}", status: :artifact)
  end
  output
end

.resolve_epub_cover_input(covers_dir, theme) ⇒ String?

EPUB カバー用の入力画像パスを解決する

Parameters:

  • covers_dir (String) —

    カバーディレクトリ

  • theme (String) —

    テーマ名

Returns:

  • (String, nil) —

    入力画像の絶対パス



577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
 
# File 'lib/vivlio_starter/cli/cover.rb', line 577

def self.resolve_epub_cover_input(covers_dir, theme)
  # master テーマ → frontcover_master.png
  if theme == 'master'
    path = File.join(covers_dir, FRONTCOVER_MASTER)
    return path if File.exist?(path)

    return nil
  end

  # light/dark/カスタム → frontcover_{theme}.png 優先
  png_path = File.join(covers_dir, "frontcover_#{theme}.png")
  return png_path if File.exist?(png_path)

  # light/dark のSVGフォールバック
  svg_path = File.join(covers_dir, "frontcover_#{theme}.svg")
  return svg_path if File.exist?(svg_path)

  nil
end

.resolve_print_cover_input(covers_dir, base_input, cover_bleed) ⇒ Array(String, Symbol)

print 用の入力画像と充填モードを決める。

塗り足し込みの著者画像 <base>_bleed.png（例 frontcover_master_bleed.png）があれば 最優先で採用する（実画が塗り足しまで届くのでトリム画像との絵柄差が出ない）。無ければ output.print_pdf.cover_bleed 設定で分岐する:

scale（既定）= トリム画像を塗り足しまで拡大して流用（中央拡大・端裁断を許容）
keep         = 拡大しない（塗り足し帯は白。フチが端まで無いデザイン向け）

Parameters:

  • covers_dir (String) —

    covers/ ディレクトリのフルパス

  • base_input (String) —

    既定入力ファイル名（frontcover_master.png 等）

  • cover_bleed (String) —

    'scale' | 'keep'

Returns:

  • (Array(String, Symbol)) —

    [入力ファイル名, 充填モード（:bleed=塗り足し込み / :trim=仕上がりのみ）]



393
394
395
396
397
398
399
400
401
 
# File 'lib/vivlio_starter/cli/cover.rb', line 393

def self.resolve_print_cover_input(covers_dir, base_input, cover_bleed)
  bleed_input = base_input.sub(/\.png\z/i, '_bleed.png')
  if File.exist?(File.join(covers_dir, bleed_input))
    Common.log_info "  塗り足し込み画像を使用: #{bleed_input}"
    return [bleed_input, :bleed]
  end

  cover_bleed == 'keep' ? [base_input, :trim] : [base_input, :bleed]
end

.target_list(config) ⇒ Object

出力ターゲット一覧を取得（シンボルキー前提）



210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
 
# File 'lib/vivlio_starter/cli/cover.rb', line 210

def target_list(config)
  raw = config.dig(:output, :targets)
  list = case raw
         in String => s
           s.split(',').map(&:strip)
         in Array => a
           a.map { |v| v.to_s.strip }
         else
           []
         end

  list = list.reject(&:empty?).map(&:downcase)
  list = ['pdf'] if list.empty?
  list
end