km:html-document

把已有内容打包为单个安全加固的 HTML 文档，支持 Mermaid 图表。

把已有的文本和图表打包成一个安全加固的单文件 HTML 报告，支持 Mermaid 图表和统一布局。它负责布局、CSS/JS 打包和安全策略，但不替你决定报告内容和结构，内容由你提供。适合你说“生成 HTML 报告”这种场景，最后产出一个可直接分享的自包含文件。

# HTML Document

用意済みの内容を、単一の自己完結 HTML 文書として組む。扱うのは HTML のレイアウト・見た目・図・セキュリティ基盤だけで、**内容（何を書くか・どう構成するか）は決めない**（内容は呼び出し側が決める）。

骨組み HTML に本文を流し込み、最後に `build.js` で CSS/JS を挿入して単一ファイルにする。CSS/JS 本体は読まずビルドに任せるので、本文作成のコンテキストを軽く保てる。

## Context

- Output dir: !`pwd`
- Today: !`date +%Y-%m-%d`

## Files（`references/`）

| ファイル | 役割 | 本文作成時 |
| --- | --- | --- |
| `document-template.html` | 骨組み（CSP・レイアウト・`BUILD:INLINE` マーカー） | 読む / 編集する |
| `document-template.css` | スタイル | 読まない（ビルドが挿入） |
| `document-template.js` | mermaid 初期化・図操作（拡縮・WebP 化） | 読まない（ビルドが挿入） |
| `build.js` | マーカーを CSS/JS で置換し単一 HTML を生成 | 実行する |
| `authoring-guide.md` | 図種・エスケープ・セキュリティ・スタイルの詳細 | 必要時に参照 |

## Workflow

1. 出力先を決める（既定 `./<slu