Module: Vivlio::Starter::CLI::PostProcessCommands

Defined in:
lib/vivlio/starter/cli/post_process.rb,
lib/vivlio/starter/cli/post_process/html_parser.rb,
lib/vivlio/starter/cli/post_process/html_replacer.rb,
lib/vivlio/starter/cli/post_process/section_wrapper.rb,
lib/vivlio/starter/cli/post_process/heading_processor.rb,
lib/vivlio/starter/cli/post_process/footnote_converter.rb,
lib/vivlio/starter/cli/post_process/body_class_injector.rb

Overview

Module: PostProcessCommands

HTML後処理のThorコマンド群とヘルパーメソッドを提供

Defined Under Namespace

Modules: BodyClassInjector, FootnoteConverter, HeadingProcessor, HtmlParser, HtmlReplacer, SectionWrapper

Constant Summary collapse

POST_PROCESS_DESC = 
{
  short: 'HTMLファイルのポスト置換処理を行います',
  long: <<~DESC
    指定した HTML ファイルの後処理を行います。指定が無い場合はプロジェクトルートの全 .html を対象にします。

    処理内容:
    - <body> タグにファイルタイプクラスを付与
    - book.yml の files.post_replace で指定された YAML に基づく置換処理
    - 章末脚注をページ脚注に変換
    - ソースコードに行番号を追加（Prism.js対応）

    例:
      vs post_process 11-install
      vs post_process 11-install.html 12-tutorial
  DESC
}.freeze

Class Method Summary collapse

Class Method Details

.build_renumber_map(footnote_refs) ⇒ Object 



761
762
763
764
765
766
767
768
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 761

def build_renumber_map(footnote_refs)
  renumber_map = {}
  footnote_refs.each_with_index do |ref, idx|
    old_fn_id = ref['href'].sub('#', '')
    renumber_map[old_fn_id] = idx + 1
  end
  renumber_map
end

.collect_footnote_refs(doc) ⇒ Object 



746
747
748
749
750
751
752
753
754
755
756
757
758
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 746

def collect_footnote_refs(doc)
  refs = []
  doc.traverse do |node|
    next unless node.element?
    next unless node.name == 'a' && node['class']&.include?('footnote-ref') && node['href']&.start_with?('#fn')

    parent = node.parent
    next if parent&.name == 'span' && parent['class']&.include?('footnote-anchor')

    refs << node
  end
  refs
end

.execute_post_process(context_or_options, entries = []) ⇒ Object

Samovar/直接呼び出し用エントリポイント

Parameters:

  • context_or_options (Hash, Object) —

    コマンドコンテキスト

  • entries (Array<TokenResolver::Entry>) (defaults to: []) —

    Entry オブジェクトの配列



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
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
142
143
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
174
175
176
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 73

def execute_post_process(context_or_options, entries = [])
  opts = normalize_options(context_or_options)
  ENV['VERBOSE'] = '1' if opts[:verbose]

  entry_map = resolve_entry_map(entries)

  entry_map.each { |html_file, entry| BodyClassInjector.inject_body_class(html_file, entry) }

  replace_rules = load_replace_rules
  total_replacements = 0

  entry_map.each do |html_file, entry|
    Common.log_action("処理中: #{html_file}")

    result = HtmlReplacer.process_html_file(html_file, replace_rules)
    if result[:changed]
      total_replacements += result[:replacements]
      Common.log_success("#{html_file}: #{result[:replacements]}個の置換を反映")
    else
      Common.log_info("#{html_file}: 変更なし")
    end

    begin
      content_before = File.read(html_file, encoding: 'utf-8')
      content_after  = SectionWrapper.wrap_h2_with_article_if_image_style!(content_before)
      if content_after != content_before
        File.write(html_file, content_after, encoding: 'utf-8')
        Common.log_success("#{html_file}: h2を<article.section-topic>でラップ（theme.style=image）")
        result2 = HtmlReplacer.process_html_file(html_file, replace_rules)
        if result2[:changed]
          Common.log_success("#{html_file}: ラップ後の不要な空段落をクリーンアップ (#{result2[:replacements]}件)")
        end
      end
    rescue StandardError => e
      Common.log_error("#{html_file}: section-topicラップ中にエラー: #{e.message}")
    end

    begin
      wrap_sideimage_blocks!(html_file)
    rescue StandardError => e
      Common.log_error("#{html_file}: sideimage ラップ中にエラー: #{e.message}")
    end

    begin
      process_image_groups!(html_file)
    rescue StandardError => e
      Common.log_error("#{html_file}: image-group 処理中にエラー: #{e.message}")
    end

    begin
      wrap_img_text_blocks!(html_file)
    rescue StandardError => e
      Common.log_error("#{html_file}: img-text ラップ中にエラー: #{e.message}")
    end

    content = File.read(html_file, encoding: 'utf-8')
    converted = FootnoteConverter.convert_endnotes_to_page_footnotes!(content)
    if converted != content
      File.write(html_file, converted, encoding: 'utf-8')
      Common.log_success("#{html_file}: 章末脚注をページ脚注に変換")
    end

    begin
      process_sideimage_footnotes!(html_file)
    rescue StandardError => e
      Common.log_error("#{html_file}: sideimage 脚注処理中にエラー: #{e.message}")
    end

    begin
      renumber_footnotes_by_document_order!(html_file)
    rescue StandardError => e
      Common.log_error("#{html_file}: 脚注再番号付け中にエラー: #{e.message}")
    end

    # Prism.js 行番号付与（直接呼び出し）
    PrismLinesCommands.execute_prism_lines(html_file)

    wrap_cross_ref_code_blocks!(html_file)

    begin
      HeadingProcessor.inject_heading_markers!([html_file], max_level: 3)
      Common.log_info("#{html_file}: 見出しメタを付与 (class=data)")
    rescue StandardError => e
      Common.log_warn("#{html_file}: 見出しメタ付与に失敗: #{e}")
    end

    begin
      HeadingProcessor.inject_heading_number_spans!(html_file, entry)
      Common.log_info("#{html_file}: 見出し番号スパンを構築")
    rescue StandardError => e
      Common.log_warn("#{html_file}: 見出し番号スパン構築に失敗: #{e}")
    end

    # 最終クリーンアップ: Nokogiri 系のステップが <p><div>...</div></p> の
    # ねじれを正すときに残してしまう空の <p></p> などを除去する。
    final_result = HtmlReplacer.process_html_file(html_file, replace_rules)
    if final_result[:changed]
      total_replacements += final_result[:replacements]
      Common.log_info("#{html_file}: 最終クリーンアップで #{final_result[:replacements]} 件を整理")
    end
  end

  Common.log_success("ポスト置換処理完了 (合計: #{total_replacements}個の置換)")
end

.extract_image_group_width_fraction(figure, img) ⇒ Object

image-group 内の先頭画像から width 指定（%）を取り出し、0.0〜1.0 の範囲の比率として返す



582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 582

def extract_image_group_width_fraction(figure, img)
  width_attr = ''
  width_attr = figure['width'].to_s if figure
  width_attr = img['width'].to_s if width_attr.empty? && img

  if (m = width_attr.match(/([0-9]+(?:\.[0-9]+)?)\s*%/))
    return sanitize_image_group_fraction(m[1].to_f / 100.0)
  end

  style_sources = []
  style_sources << figure['style'].to_s if figure
  style_sources << img['style'].to_s if img

  style_sources.compact.each do |style|
    if (m = style.match(/width\s*:\s*([0-9]+(?:\.[0-9]+)?)\s*%/))
      return sanitize_image_group_fraction(m[1].to_f / 100.0)
    end
  end

  nil
end

.extract_sideimage_width_fraction(figure) ⇒ Object

sideimage コンテナ内の figure/img から width 指定（%）を取り出し、0.0〜1.0 の範囲の比率として返す



907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 907

def extract_sideimage_width_fraction(figure)
  # figure 要素・子 img 要素の両方を対象とする
  img = figure.at_css('img')

  width_attr = figure['width'].to_s
  width_attr = img['width'].to_s if width_attr.empty? && img

  if (m = width_attr.match(/([0-9]+(?:\.[0-9]+)?)\s*%/))
    return sanitize_sideimage_fraction(m[1].to_f / 100.0)
  end

  style_sources = []
  style_sources << figure['style'].to_s
  style_sources << img['style'].to_s if img

  style_sources.compact.each do |style|
    if (m = style.match(/width\s*:\s*([0-9]+(?:\.[0-9]+)?)\s*%/))
      return sanitize_sideimage_fraction(m[1].to_f / 100.0)
    end
  end

  nil
end

.included(base) ⇒ Object 



68
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 68

def included(base); end

.load_replace_rules ⇒ Object

置換ルールの読み込み

book.ymlのfiles.post_replaceで指定されたYAMLファイルから置換ルールを読み込みます。



964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 964

def load_replace_rules
  target_yml = Common.post_replace_file_path
  display_yml = target_yml && Common.relative_path_from_root(target_yml)

  if target_yml && File.exist?(target_yml)
    begin
      yml_content = File.read(target_yml, encoding: 'utf-8')
      parsed = YAML.safe_load(yml_content, permitted_classes: [], aliases: true)
      replace_rules = parsed.is_a?(Array) ? parsed : nil
      Common.log_error('エラー: YAMLファイルは置換オブジェクト配列である必要があります') unless replace_rules
      Common.log_info("置換ルール: #{display_yml || target_yml} を使用")
      replace_rules
    rescue StandardError => e
      Common.log_error("YAMLの読み込みに失敗: #{e.message}")
      nil
    end
  else
    missing_label = if display_yml
                      display_yml
                    elsif target_yml
                      target_yml
                    elsif Common::POST_REPLACE_FILE
                      Common::POST_REPLACE_FILE
                    else
                      '(未設定)'
                    end
    Common.log_error("置換ルールYAMLが見つかりません: #{missing_label}")
    nil
  end
end

.move_body_asides_to_last_section!(doc) ⇒ Object

body 直下の aside.page-footnote-print を対応する参照の section 末尾に移動するappend_unused_footnotes_to_body! が body 末尾に追加した aside を適切な位置に配置し直す



879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 879

def move_body_asides_to_last_section!(doc)
  body = doc.at_css('body')
  return unless body

  body_asides = body.css('> aside.page-footnote-print').to_a
  return if body_asides.empty?

  body_asides.each do |aside|
    fn_id = aside['id']
    next unless fn_id

    # この aside を参照している <a class="footnote-ref"> を探す
    ref = doc.at_css("a.footnote-ref[href='##{fn_id}']")
    target_section = ref&.ancestors('section')&.first

    # 参照が見つからない場合は最後の section に移動
    target_section ||= body.css('section').to_a.last
    next unless target_section

    aside.remove
    target_section.add_child("\n")
    target_section.add_child(aside)
  end
end

.needs_renumbering?(renumber_map) ⇒ Object 



771
772
773
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 771

def needs_renumbering?(renumber_map)
  renumber_map.any? { |old_id, new_num| old_id.sub('fn', '').to_i != new_num }
end

.normalize_image_group_width!(figure, img) ⇒ Object

列幅でレイアウトを制御するため、figure/img 側の width 指定は取り除く



615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 615

def normalize_image_group_width!(figure, img)
  [figure, img].compact.each do |node|
    node.remove_attribute('width')

    style = node['style'].to_s
    next if style.empty?

    cleaned = style.gsub(/width\s*:\s*[^;]+;?/, '').strip
    if cleaned.empty?
      node.remove_attribute('style')
    else
      node['style'] = cleaned
    end
  end
end

.normalize_options(context_or_options) ⇒ Object

オプションを正規化



180
181
182
183
184
185
186
187
188
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 180

def normalize_options(context_or_options)
  if context_or_options.is_a?(Hash)
    context_or_options[:options] || context_or_options
  elsif context_or_options.respond_to?(:options)
    context_or_options.options || {}
  else
    {}
  end
end

.normalize_sideimage_figure_width!(figure) ⇒ Object

列幅でレイアウトを制御するため、figure/img 側の width 指定は取り除く



940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 940

def normalize_sideimage_figure_width!(figure)
  img = figure.at_css('img')

  [figure, img].compact.each do |node|
    node.remove_attribute('width')

    style = node['style'].to_s
    next if style.empty?

    cleaned = style.gsub(/width\s*:\s*[^;]+;?/, '').strip
    if cleaned.empty?
      node.remove_attribute('style')
    else
      node['style'] = cleaned
    end
  end
end

.process_image_groups!(html_file) ⇒ Object

image-group コンテナの列比率設定

VFM が出力する

<div class="image-group">
  <figure><img width="30%">...</figure>
  <figure><img>...</figure>
</div>

のような構造で、先頭画像の width 指定を検出し、CSS 変数 –image-group-col1, –image-group-col2 としてコンテナの style 属性に埋め込む。



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
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 474

def process_image_groups!(html_file)
  content = File.read(html_file, encoding: 'utf-8')
  doc = HtmlParser.parse_html_document(content)
  changed = false

  doc.css('div.image-group').each do |container|
    # 先頭の figure または img を取得
    first_figure = container.at_css('> figure')
    first_img = first_figure&.at_css('img') || container.at_css('> img')

    next unless first_img || first_figure

    # 先頭画像の width 指定を取得
    fraction = extract_image_group_width_fraction(first_figure, first_img)
    next unless fraction

    col1_fr = fraction.round(3)
    col2_fr = (1.0 - fraction).round(3)

    existing_style = container['style'].to_s
    # 既存の image-group 用変数定義を一度取り除く
    cleaned_style = existing_style
                    .gsub(/--image-group-col1:[^;]+;?/, '')
                    .gsub(/--image-group-col2:[^;]+;?/, '')
                    .strip

    var_style = "--image-group-col1: #{col1_fr}fr; --image-group-col2: #{col2_fr}fr"

    container['style'] = if cleaned_style.empty?
                           var_style
                         else
                           "#{cleaned_style.chomp(';')}; #{var_style}"
                         end

    # 画像側の width 指定を削除（グリッド列幅で制御）
    normalize_image_group_width!(first_figure, first_img)

    changed = true
  end

  return unless changed

  HtmlParser.save_html_document(html_file, doc)
  Common.log_success("#{html_file}: image-group コンテナの列比率を設定しました")
end

.process_sideimage_footnotes!(html_file) ⇒ Object

sideimage 内の脚注参照を処理

Step 4 で page-footnote-print が生成された後に呼び出され、sideimage-body 内の [^urlN] を <sup><a href=“#fnN”>N</a></sup> に変換する。印刷読者のために、リンクのURLを脚注として表示する。



639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 639

def process_sideimage_footnotes!(html_file)
  content = File.read(html_file, encoding: 'utf-8')
  doc = HtmlParser.parse_html_document(content)

  changed = false

  # URLと脚注番号のマッピングを構築
  url_to_footnote = {}
  doc.css('aside.page-footnote-print').each do |aside|
    fn_num = aside['data-footnote-number']
    next unless fn_num

    link = aside.at_css('a')
    url_to_footnote[link['href']] = fn_num if link && link['href']
  end

  return if url_to_footnote.empty?

  # sideimage-body 内の <a> タグの直後にある [^urlN] を処理
  doc.css('div.sideimage-body').each do |body|
    body.css('a').each do |link_elem|
      next_node = link_elem.next_sibling
      next unless next_node&.text?

      text = next_node.text
      # [^urlN] または [^N] パターンを検出
      next unless text.match?(/^\s*\[\^(?:url)?\d+\]/)

      # リンクのURLから脚注番号を取得
      target_url = link_elem['href']
      fn_num = url_to_footnote[target_url]

      if fn_num
        # 脚注参照をスーパースクリプトリンクに置換
        modified = text.sub(/^\s*\[\^(?:url)?\d+\]/, '')

        # スーパースクリプトリンクを生成
        sup = Nokogiri::XML::Node.new('sup', doc)
        anchor = Nokogiri::XML::Node.new('a', doc)
        anchor['href'] = "#fn#{fn_num}"
        anchor['class'] = 'footnote-ref'
        anchor['role'] = 'doc-noteref'
        anchor.content = fn_num
        sup.add_child(anchor)

        # <a>タグの直後にスーパースクリプトを挿入
        link_elem.add_next_sibling(sup)

        # 残りのテキストを更新
        if modified.strip.empty?
          next_node.remove
        else
          next_node.content = modified
        end

      else
        # 対応する脚注が見つからない場合は参照を削除
        cleaned = text.gsub(/\s*\[\^(?:url)?\d+\]/, '')
        if cleaned.empty?
          next_node.remove
        else
          next_node.content = cleaned
        end
      end
      changed = true
    end
  end

  return unless changed

  HtmlParser.save_html_document(html_file, doc)
  Common.log_success("#{html_file}: sideimage 脚注参照を変換しました")
end

.remove_footnote_anchors(doc) ⇒ Object 



837
838
839
840
841
842
843
844
845
846
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 837

def remove_footnote_anchors(doc)
  # 旧形式: <span class="footnote-anchor"> を削除
  doc.css('span.footnote-anchor').each do |anchor|
    parent = anchor.parent
    anchor.remove
    parent.remove if parent&.name == 'p' && parent.content.strip.empty?
  end
  # 新形式: <p class="footnote-anchor"> を削除（VFM が {.footnote-anchor} から生成）
  doc.css('p.footnote-anchor').each(&:remove)
end

.renumber_footnotes_by_document_order!(html_file) ⇒ Object

脚注をドキュメント出現順に再番号付け

sideimage 内の脚注と本文の脚注が混在する場合、処理順序により番号が出現順にならないことがある。この関数で修正する。



720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 720

def renumber_footnotes_by_document_order!(html_file)
  content = File.read(html_file, encoding: 'utf-8')
  doc = HtmlParser.parse_html_document(content)

  footnote_refs = collect_footnote_refs(doc)
  return if footnote_refs.empty?

  renumber_map = build_renumber_map(footnote_refs)

  if needs_renumbering?(renumber_map)
    update_footnote_refs(footnote_refs)
    update_footnote_definitions(doc, renumber_map)
    sort_footnotes_in_sections(doc)
  end

  # footnote-anchor span は再番号付けの有無に関わらず常に削除する
  remove_footnote_anchors(doc)

  # body 直下の aside.page-footnote-print を最後の section 末尾に移動する
  move_body_asides_to_last_section!(doc)

  HtmlParser.save_html_document(html_file, doc)
  Common.log_success("#{html_file}: 脚注を出現順に再番号付けしました")
end

.reorder_asides(doc, asides, sorted_asides) ⇒ Object 



867
868
869
870
871
872
873
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 867

def reorder_asides(doc, asides, sorted_asides)
  marker = Nokogiri::XML::Comment.new(doc, 'footnote-sort-marker')
  asides.first.add_previous_sibling(marker)
  asides.each(&:remove)
  sorted_asides.reverse_each { |aside| marker.add_next_sibling(aside) }
  marker.remove
end

.resolve_entry_map(entries) ⇒ Hash{String => TokenResolver::Entry}

Entry 配列を解決し、HTML パス => Entry の Hash を返す

Parameters:

Returns:



194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 194

def resolve_entry_map(entries)
  raw = Array(entries).compact
  resolver = TokenResolver::Resolver.new

  if raw.empty?
    # 全 HTML ファイルを TokenResolver で解決
    Dir.glob('./*.html').each_with_object({}) do |html_file, map|
      entry = resolver.resolve_file(html_file)
      map[html_file] = entry
    end
  elsif raw.first.respond_to?(:kind)
    # Entry 配列: HTML パスと紐付け
    raw.each_with_object({}) do |entry, map|
      html_file = "./#{entry.basename}.html"
      map[html_file] = entry
    end
  else
    # basename/パスの場合は TokenResolver で解決
    raw.each_with_object({}) do |bn, map|
      entry = resolver.resolve_file(bn)
      html_file = "./#{entry.basename}.html"
      map[html_file] = entry
    end
  end
end

.sanitize_image_group_fraction(raw) ⇒ Object

パーセンテージから得た比率を安全な範囲に丸める



606
607
608
609
610
611
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 606

def sanitize_image_group_fraction(raw)
  return nil unless raw.positive?

  # 極端な比率を避けるため、5%〜95% にクランプ
  raw.clamp(0.05, 0.95)
end

.sanitize_sideimage_fraction(raw) ⇒ Object

パーセンテージから得た比率を安全な範囲に丸める



932
933
934
935
936
937
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 932

def sanitize_sideimage_fraction(raw)
  return nil unless raw.positive?

  # 極端な比率を避けるため、5%〜95% にクランプ
  raw.clamp(0.05, 0.95)
end

.sort_footnotes_in_sections(doc) ⇒ Object 



849
850
851
852
853
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 849

def sort_footnotes_in_sections(doc)
  doc.css('section').each do |section|
    sort_section_footnotes(doc, section)
  end
end

.sort_section_footnotes(doc, section) ⇒ Object 



856
857
858
859
860
861
862
863
864
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 856

def sort_section_footnotes(doc, section)
  asides = section.css('> aside.page-footnote-print').to_a
  return if asides.size < 2

  sorted_asides = asides.sort_by { |a| a['data-footnote-number'].to_i }
  return if asides.map { |a| a['data-footnote-number'] } == sorted_asides.map { |a| a['data-footnote-number'] }

  reorder_asides(doc, asides, sorted_asides)
end

.update_aside_footnote(doc, old_fn_id, new_number) ⇒ Object 



815
816
817
818
819
820
821
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 815

def update_aside_footnote(doc, old_fn_id, new_number)
  aside = doc.at_css("aside##{old_fn_id}")
  return unless aside

  aside['id'] = "fn#{new_number}"
  aside['data-footnote-number'] = new_number.to_s
end

.update_fnref_link(doc, old_fn_id, new_number) ⇒ Object 



830
831
832
833
834
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 830

def update_fnref_link(doc, old_fn_id, new_number)
  old_fnref_id = old_fn_id.sub('fn', 'fnref')
  fnref = doc.at_css("a##{old_fnref_id}")
  fnref['id'] = "fnref#{new_number}" if fnref
end

.update_footnote_definitions(doc, renumber_map) ⇒ Object 



797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 797

def update_footnote_definitions(doc, renumber_map)
  # IDの衝突を避けるため、2段階で更新する
  # Phase 1: 全定義を一時ID（tmp_fnN）に変更
  # ※ update_footnote_refs が先に fnref ID を更新済みのため fnref は対象外
  renumber_map.each_key do |old_fn_id|
    tmp_id = "tmp_#{old_fn_id}"
    doc.at_css("aside##{old_fn_id}")&.tap { |n| n['id'] = tmp_id }
    doc.at_css("span##{old_fn_id}")&.tap { |n| n['id'] = tmp_id }
  end
  # Phase 2: 一時IDから最終IDへ変更
  renumber_map.each do |old_fn_id, new_number|
    tmp_id = "tmp_#{old_fn_id}"
    update_aside_footnote(doc, tmp_id, new_number)
    update_inline_footnote(doc, tmp_id, new_number)
  end
end

.update_footnote_ref_text(ref, new_number) ⇒ Object 



786
787
788
789
790
791
792
793
794
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 786

def update_footnote_ref_text(ref, new_number)
  if ref.parent&.name == 'sup'
    ref.content = new_number.to_s
  elsif ref.at_css('sup')
    ref.at_css('sup').content = new_number.to_s
  else
    ref.content = new_number.to_s
  end
end

.update_footnote_refs(footnote_refs) ⇒ Object 



776
777
778
779
780
781
782
783
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 776

def update_footnote_refs(footnote_refs)
  footnote_refs.each_with_index do |ref, idx|
    new_number = idx + 1
    ref['href'] = "#fn#{new_number}"
    ref['id'] = "fnref#{new_number}" if ref['id']
    update_footnote_ref_text(ref, new_number)
  end
end

.update_inline_footnote(doc, old_fn_id, new_number) ⇒ Object 



824
825
826
827
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 824

def update_inline_footnote(doc, old_fn_id, new_number)
  inline = doc.at_css("span##{old_fn_id}")
  inline['id'] = "fn#{new_number}" if inline
end

.wrap_cross_ref_code_blocks!(html_file) ⇒ Object

クロスリファレンス用コードブロックのラップ

pre_process で挿入した “<!–xref:ID–>” コメントを基準に、直前の <p>（キャプション）と直後の <pre>（Prism済みコード）を<div id=“ID” class=“cross-ref-list”> で包みます。旧スタイルの <p class=“code-caption” data-xref-id> にも対応します。行番号付与 (prism_lines) 後に実行します。



230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
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
301
302
303
304
305
306
307
308
309
310
311
312
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 230

def wrap_cross_ref_code_blocks!(html_file)
  content = File.read(html_file, encoding: 'utf-8')
  doc = HtmlParser.parse_html_document(content)
  changed = false

  # パターン1: <!--xref:ID--> コメントを基準にラップ
  doc.xpath('//comment()').each do |comment|
    text = comment.text.to_s.strip
    next unless text.start_with?('xref:')

    id = text.sub(/\Axref:/, '')
    next if id.empty?

    caption = comment.previous_element
    block = comment.next_element

    next unless caption&.name == 'p'
    next unless block

    # 直後が <pre> 単体、または <figure> 内に <pre> を含むパターンの両方に対応
    if block.name == 'pre'
      code_container = block
    elsif block.name == 'figure' && block.at_css('pre')
      code_container = block
    else
      next
    end

    # キャプションに code-caption クラスを付与（既存クラスは保持）
    existing_classes = caption['class'].to_s.split(/\s+/).reject(&:empty?)
    unless existing_classes.include?('code-caption')
      caption['class'] = (existing_classes + ['code-caption']).uniq.join(' ')
    end

    wrapper = Nokogiri::XML::Node.new('div', doc)
    wrapper['id'] = id
    wrapper['class'] = 'cross-ref-list'

    # wrapper を caption の直前に挿入し、caption とコードブロック要素を移動
    caption.add_previous_sibling(wrapper)
    wrapper.add_child(caption)
    wrapper.add_child(code_container)

    # マーカーコメントは削除
    comment.remove

    changed = true
  end

  # パターン2（後方互換）: <p class="code-caption" data-xref-id> + <pre>
  doc.css('p.code-caption[data-xref-id]').each do |p|
    id = p['data-xref-id'].to_s
    next if id.empty?

    node = p.next_sibling
    pre = nil
    while node
      if node.element?
        pre = node if node.name == 'pre'
        break
      end
      node = node.next_sibling
    end
    next unless pre

    wrapper = Nokogiri::XML::Node.new('div', doc)
    wrapper['id'] = id
    wrapper['class'] = 'cross-ref-list'

    p.remove_attribute('data-xref-id')

    p.add_previous_sibling(wrapper)
    wrapper.add_child(p)
    wrapper.add_child(pre)

    changed = true
  end

  return unless changed

  HtmlParser.save_html_document(html_file, doc)
  Common.log_success("#{html_file}: cross-ref list code blocks wrapped")
end

.wrap_img_text_blocks!(html_file) ⇒ Object

img-text / text-img 系コンテナの正規化

VFM が出力する

<div class="text2-img">
  テキスト…<span class="math inline">…</span>…
  <figure><img …></figure>
</div>

のような構造では、テキストノードや <span> が独立したグリッドセルになり、レイアウトが崩れる。figure 以外の子ノードを<div class=“img-text-body”> でまとめて包み、常に

<div class="text2-img">
  <div class="img-text-body">テキスト…</div>
  <figure>…</figure>
</div>

という 2 要素構造に正規化する。



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
571
572
573
574
575
576
577
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 538

def wrap_img_text_blocks!(html_file)
  content = File.read(html_file, encoding: 'utf-8')
  doc = HtmlParser.parse_html_document(content)
  changed = false

  selectors = %w[img-text img-text2 img-text3 text-img text2-img text3-img]
  css_selector = selectors.map { "div.#{it}" }.join(', ')

  doc.css(css_selector).each do |container|
    figure = container.at_css('> figure')
    next unless figure

    children = container.children
    body_nodes = children.reject do |node|
      node == figure || (node.text? && node.text.strip.empty?)
    end

    # 既に img-text-body でラップ済みならスキップ
    if body_nodes.size == 1 && body_nodes.first.element? &&
       body_nodes.first['class'].to_s.include?('img-text-body')
      next
    end

    next if body_nodes.empty?

    body_wrapper = Nokogiri::XML::Node.new('div', doc)
    body_wrapper['class'] = 'img-text-body'

    first_body = body_nodes.first
    first_body.add_previous_sibling(body_wrapper)
    body_nodes.each { body_wrapper.add_child(it) }

    changed = true
  end

  return unless changed

  HtmlParser.save_html_document(html_file, doc)
  Common.log_success("#{html_file}: img-text コンテナを正規化しました")
end

.wrap_sideimage_blocks!(html_file) ⇒ Object

sideimage コンテナ内テキストのラップ

Vivliostyle/VFM が出力する

<div class="sideimage-right">
  <figure>…</figure>本文テキスト…
</div>

のような構造では、figure 以外がテキストノードとなりCSS Grid の .sideimage-right > :not(figure) セレクタでは拾えない。そこで、figure 以外の子ノードを <div class=“sideimage-body”> でまとめて包み、常に

<div class="sideimage-right">
  <figure>…</figure>
  <div class="sideimage-body">本文…</div>
</div>

という 2 要素構造に正規化する。



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
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
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
 
# File 'lib/vivlio/starter/cli/post_process.rb', line 332

def wrap_sideimage_blocks!(html_file)
  content = File.read(html_file, encoding: 'utf-8')
  doc = HtmlParser.parse_html_document(content)
  changed = false

  doc.css('div.sideimage-right, div.sideimage-left, div.sideimage').each do |container|
    figure = container.at_css('> figure')
    next unless figure

    # 画像幅指定（width=50% など）から列比率を推定し、CSS変数として埋め込む
    if (fraction = extract_sideimage_width_fraction(figure))
      text_fr = (1.0 - fraction).round(3)
      img_fr  = fraction.round(3)

      existing_style = container['style'].to_s
      # 既存の sideimage 用変数定義を一度取り除く
      cleaned_style = existing_style
                      .gsub(/--sideimage-text-fr:[^;]+;?/, '')
                      .gsub(/--sideimage-img-fr:[^;]+;?/, '')
                      .strip

      var_style = "--sideimage-text-fr: #{text_fr}fr; --sideimage-img-fr: #{img_fr}fr"

      container['style'] = if cleaned_style.empty?
                             var_style
                           else
                             "#{cleaned_style.chomp(';')}; #{var_style}"
                           end

      normalize_sideimage_figure_width!(figure)

      changed = true
    end

    children = container.children

    body_nodes = children.reject do |node|
      node == figure || (node.text? && node.text.strip.empty?)
    end

    # すでに sideimage-body がひとつだけある場合は何もしない
    if body_nodes.size == 1 && body_nodes.first.element? &&
       body_nodes.first['class'].to_s.split.include?('sideimage-body')
      next
    end

    next if body_nodes.empty?

    body_wrapper = Nokogiri::XML::Node.new('div', doc)
    body_wrapper['class'] = 'sideimage-body'

    first_body = body_nodes.first
    first_body.add_previous_sibling(body_wrapper)

    body_nodes.each do |node|
      body_wrapper.add_child(node)
    end

    changed = true
  end

  # sideimage-body 内に残っているバッククォート付きコードを <code> 要素に変換
  doc.css('div.sideimage-body').each do |body|
    body.traverse do |node|
      next unless node.text?

      text = node.text
      next unless text.include?('`')

      segments = text.split(/(`[^`]*`)/)
      next if segments.length == 1

      # 元のテキストノードの直前に、新しいノードを順番に挿入していく
      segments.each do |seg|
        if seg.start_with?('`') && seg.end_with?('`') && seg.length >= 2
          inner = seg[1..-2]
          code = Nokogiri::XML::Node.new('code', doc)
          code.content = inner
          node.add_previous_sibling(code)
        else
          node.add_previous_sibling(Nokogiri::XML::Text.new(seg, doc))
        end
      end

      # 役目を終えた元のテキストノードは削除する
      node.remove
      changed = true
    end

    # sideimage-body 内のマークダウンリンクを <a> タグに変換
    # [テキスト](URL) → <a href="URL">テキスト</a>
    # 脚注参照 [^urlN] は一旦そのまま残す（後で process_sideimage_footnotes! で処理）
    body.traverse do |node|
      next unless node.text?

      text = node.text
      next unless text.match?(/\[.+?\]\(.+?\)/)

      # マークダウンリンクと脚注参照を分割（脚注参照は後で処理するので残す）
      pattern = /(\[[^\]]+\]\([^)]+\))/
      segments = text.split(pattern)
      next if segments.length == 1

      segments.each do |seg|
        if (m = seg.match(/^\[([^\]]+)\]\(([^)]+)\)$/))
          # マークダウンリンク: [text](url) → <a>text</a>
          link_text = m[1]
          link_url = m[2]
          anchor = Nokogiri::XML::Node.new('a', doc)
          anchor['href'] = link_url
          anchor.content = link_text
          node.add_previous_sibling(anchor)
        else
          # 通常テキスト（脚注参照 [^urlN] も含む）
          node.add_previous_sibling(Nokogiri::XML::Text.new(seg, doc))
        end
      end

      node.remove
      changed = true
    end
  end

  return unless changed

  HtmlParser.save_html_document(html_file, doc)
  Common.log_success("#{html_file}: sideimage コンテナを正規化しました")
end