make-a-doc

用途：创建文档（简历、单页说明、备忘录、信件、报告、指南、论文），并在动手前先判断用户想要两种版式中的哪一种，因为二者导出方式完全不同。\n\n流动页面：文字铺排到标准纸张（Letter/A4）并按需分页，适用于报告、备忘录、信件、论文、指南。起步先调用 copy_starter_component，kind 为 "doc_page.js"，然后把整篇文档写成常规流动 HTML，放在 <doc-page size="letter" margin="0.75in"> 内。纸张、桌面背景和全部打印几何由该组件负责；不要自写 @page 规则、body 背景、page-card div、break-after: page 假纸张，也不要在多列网格内部项目上用 break-inside: avoid（网格只在行间断开，强行保持的行放不下会留空白带）。\n\n流动页面的打印规则：多列文本用 CSS columns（column-count 与 column-gap；跨越列的标题用 column-span: all；窄列中用 hyphens: auto，需在 html 元素上设置 lang），绝不要用并排的 flex/grid 列，只有真正的 CSS columns 才能跨页流动与断开。必须另起一页的内容（章节、附录）用 break-before: page；自定义的保持块（提示框、数据块、卡片）加入 break-inside: avoid 规则，并让每个短于一页，组件已保持标题与内容同页、图形/代码/表格行完整，并抑制孤行寡行（自定义文本块可扩展 orphans: 3; widows: 3）。长表格使用 <thead> 以便表头每页重复。内容中不用 position: fixed/sticky，也不用视口单位，固定元素会盖印到每个打印页（页眉页脚应放在组件的槽位中），100vh 在打印时尺寸错误。\n\n固定纸张：必须恰好填满一页固定尺寸的设计，如海报、信息图、社交图、证书。没有起始组件，按真实像素尺寸构建，在顶层元素上写明 px 宽度（固定高度时也写高度）；导出时会自动把 PDF 页面设为该尺寸。不要为它写 @page 规则。\n\n两种版式的样式：正文 14–16px，行高宽松（1.55–1.7）；清晰的标题层级；克制的配色。表格带表头行和细线边框；图形和代码块各配简短说明。正文第一个元素就是文档自己的 h1（粘贴内容中任何标题样式的首行用它作为该 h1，而不要渲染成单独的报头）。