Module: VivlioStarter::CLI::EntriesCommands

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

Overview

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

Module: entries メタデータ抽出ヘルパ

提供機能:

- build_entry: HTML から entries 用の { path:, title: } を組み立てる
- extract_html_title: HTML の <title> を抽出する

利用者:

- Build::VivliostyleConfigWriter（workspace の用途別 entries 生成）
- Build::EpubBuilder（EPUB 用 entries 生成）

かつての `vs entries`（ルート entries.js の手動生成コマンド）は P4 のワークスペース分離で実体を失ったため撤去した（vivlioverso-manual-flow-removal-spec.md）。

Class Method Summary collapse

.build_entry(html_file) ⇒ Hash
HTML ファイルから entries 用エントリを組み立てる。タイトルはタグ優先、無ければファイル名の番号を除いた部分。.</div> </li> <li class="public "> <a href="#extract_html_title-class_method" title="extract_html_title (class method)">.extract_html_title(path) ⇒ Object </a> <div class='inline'></div> </li> </ul> <div id="class_method_details" class="method_details_list"> <h2>Class Method Details</h2> <div class="method_details first"> <h3 class="signature first" id="build_entry-class_method"> .build_entry(html_file) ⇒ <tt>Hash</tt> </h3><div class="docstring"> <div class="discussion"> HTML ファイルから entries 用エントリを組み立てる。タイトルは <title> タグ優先、無ければファイル名の番号を除いた部分。 </div> </div> <div class="tags"> Parameters: <ul class="param"> <li> html_file (<tt>String</tt>) </li> </ul> Returns: <ul class="return"> <li> (<tt>Hash</tt>) — <div class='inline'>{ path: String, title: String }</div> </li> </ul> </div><table class="source_code"> <tr> <td> <pre class="lines"> 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43</pre> </td> <td> <pre class="code"># File 'lib/vivlio_starter/cli/entries.rb', line 29 def build_entry(html_file) base_name = File.basename(html_file, '.html') title = base_name html_title = extract_html_title(html_file) if html_title && !html_title.empty? title = html_title elsif html_title.to_s.empty? && (base_name =~ /^\d+-(.+)$/) title = ::Regexp.last_match(1) end # パスを相対パス形式に正規化（./を接頭辞として付与） normalized_path = html_file.start_with?('./') ? html_file : "./#{html_file}" { path: normalized_path, title: title } end</pre> </td> </tr> </table> </div> <div class="method_details "> <h3 class="signature " id="extract_html_title-class_method"> .extract_html_title(path) ⇒ <tt>Object</tt> </h3><table class="source_code"> <tr> <td> <pre class="lines"> 45 46 47 48 49 50 51 52 53 54</pre> </td> <td> <pre class="code"># File 'lib/vivlio_starter/cli/entries.rb', line 45 def extract_html_title(path) return unless File.exist?(path) content = File.read(path) ::Regexp.last_match(1).strip if content =~ %r{<title>(.+?)</title>} rescue StandardError => e # タイトル抽出失敗時はフォールバック名が使われるため、原因をデバッグログに残す <a href="Common.html" title="VivlioStarter::CLI::Common (module)">Common</a>.<a href="Common.html#log_debug-class_method" title="VivlioStarter::CLI::Common.log_debug (method)">log_debug</a>("[entries] #{path} のタイトル抽出に失敗: #{e.class}: #{e.message}") nil end</pre> </td> </tr> </table> </div> </div> </div> <div id="footer"> Generated on Mon Aug 10 05:25:35 2026 by <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a> 0.9.45 (ruby-4.0.2). </div> </div> </body> </html>

Module: VivlioStarter::CLI::EntriesCommands

Overview

Module: entries メタデータ抽出ヘルパ

かつての vs entries（ルート entries.js の手動生成コマンド）は P4 のワークスペース分離で実体を失ったため撤去した （vivlioverso-manual-flow-removal-spec.md）。

Class Method Summary collapse

かつての `vs entries`（ルート entries.js の手動生成コマンド）は P4 のワークスペース分離で実体を失ったため撤去した（vivlioverso-manual-flow-removal-spec.md）。