主题插件开发教程

主题插件是最适合使用 Vue、TypeScript 和 Vite 的地方。它拥有 HTML 表现层，但不负责读取 Core 内部状态。项目模型把 PageModel 交给主题，主题返回 HTML 和资源引用。

开发目录

theme-magazine/
├── package.json
├── src/
│   ├── index.ts
│   ├── components/
│   └── styles/main.scss
├── public/
└── vite.config.ts

发布目录

theme-magazine/
├── plugin.json
├── theme.json
├── layout/post.html
├── layout/page.html
└── source/
    ├── style.css
    └── client.js

开发阶段可以使用 Vue 单文件组件和 Vite，发布阶段只携带编译结果。客户端交互通过 client.js，生成阶段不默认启动 Node.js。

资源注入

主题清单声明 CSS、JS、字体和图片。AssetProvider 可以为它们计算 hash、复制到 public、生成 manifest 并注入页面。资源路径应使用相对或由模型插件提供的公共 URL，不要写死开发机路径。