feat: support yaml-based template meta

src/pipeline/loadMeta.ts

@@ -0,0 +1,108 @@
+import path from 'node:path';
+import { parse as parseYaml } from 'yaml';
+
+import { DOCUMENTS_DIR } from '../config.js';
+import { logger } from '../logger.js';
+import { pathExists, readText } from '../utils/fs.js';
+
+export interface DocumentMetaSection {
+    title?: string;
+    author?: string;
+    published?: string;
+    pubDate?: string;
+    copyright?: string;
+}
+
+export interface DocumentMeta {
+    title: string;
+    author: string;
+    published: string;
+    description?: string;
+    copyright: string;
+    frontCover?: DocumentMetaSection;
+    backCover?: DocumentMetaSection;
+}
+
+const META_FILES = ['_meta.yaml', '_meta.yml'];
+
+const DEFAULT_META: DocumentMeta = {
+    title: 'Template',
+    author: 'ろむねこ',
+    published: '0000/000/00',
+    copyright: 'template',
+    description: ''
+};
+
+function toRecord(value: unknown): Record<string, unknown> | undefined {
+    if (value && typeof value === 'object' && !Array.isArray(value)) {
+        return value as Record<string, unknown>;
+    }
+    return undefined;
+}
+
+function pickString(value: unknown): string | undefined {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed.length > 0 ? trimmed : undefined;
+    }
+    return undefined;
+}
+
+function buildSection(value: unknown): DocumentMetaSection | undefined {
+    const record = toRecord(value);
+    if (!record) {
+        return undefined;
+    }
+    const section: DocumentMetaSection = {};
+    const title = pickString(record.title);
+    const author = pickString(record.author);
+    const published = pickString(record.published);
+    const pubDate = pickString(record.pubDate);
+    const copyright = pickString(record.copyright);
+
+    if (title) section.title = title;
+    if (author) section.author = author;
+    if (published) section.published = published;
+    if (pubDate) section.pubDate = pubDate;
+    if (copyright) section.copyright = copyright;
+
+    return Object.keys(section).length > 0 ? section : undefined;
+}
+
+function mergeMeta(partial: Record<string, unknown>): DocumentMeta {
+    return {
+        title: pickString(partial.title) ?? DEFAULT_META.title,
+        author: pickString(partial.author) ?? DEFAULT_META.author,
+        published: pickString(partial.published) ?? DEFAULT_META.published,
+        description: pickString(partial.description) ?? DEFAULT_META.description,
+        copyright: pickString(partial.copyright) ?? DEFAULT_META.copyright,
+        frontCover: buildSection(partial.frontCover),
+        backCover: buildSection(partial.backCover)
+    };
+}
+
+async function loadYamlMeta(filePath: string) {
+    const raw = await readText(filePath);
+    try {
+        const parsed = parseYaml(raw);
+        const record = toRecord(parsed);
+        if (!record) {
+            throw new Error('YAML の内容がオブジェクトではありません。');
+        }
+        return mergeMeta(record);
+    } catch (error) {
+        throw new Error(`YAML を解析できませんでした (${path.basename(filePath)}): ${(error as Error).message}`);
+    }
+}
+
+export async function loadMeta(): Promise<DocumentMeta> {
+    for (const filename of META_FILES) {
+        const fullPath = path.join(DOCUMENTS_DIR, filename);
+        if (await pathExists(fullPath)) {
+            logger.info(`メタ情報ファイル ${filename} を読み込みます`);
+            return loadYamlMeta(fullPath);
+        }
+    }
+    logger.info('メタ情報ファイルが見つからなかったため、テンプレートのデフォルト値を使用します');
+    return DEFAULT_META;
+}

src/pipeline/renderTemplate.ts

@@ -5,6 +5,7 @@ import tidy from 'htmltidy2';
 
 import { logger } from '../logger.js';
 import { writeText } from '../utils/fs.js';
+import { DocumentMeta } from './loadMeta.js';
 
 const renderFile = promisify(ejs.renderFile);
 const tidyHtml = promisify(tidy.tidy);
@@ -13,9 +14,9 @@ const tidyHtml = promisify(tidy.tidy);
  * scripts/ejs.js (2SC1815J/md2pdf, MIT License) を TypeScript 化し、
  * HTML Tidy 設定もフォーク元に合わせている。
  */
-export async function renderTemplate(templatePath: string, outputPath: string) {
+export async function renderTemplate(templatePath: string, outputPath: string, meta: DocumentMeta) {
     logger.info('テンプレート HTML を描画しています…');
-    const rendered = await renderFile(templatePath);
+    const rendered = await renderFile(templatePath, { meta });
     const tidied = await tidyHtml(rendered, {
         doctype: 'html5',
         indent: 'auto',