主题开发速览

结构

themes/<name>/
  theme.json          # 名称/版本/作者/预览图
  style.css           # 样式（含亮暗变量）
  views/layout.php    # 整页外壳（head/顶栏/页脚/语言切换）
  views/landing.php   # 首页门户落地页（可选）
  views/partials/*.php# 文章/页面/列表/侧栏/搜索等
  logo.svg favicon.svg

关键约定

• 模板变量由核心传入：页面用 View::render('layout', [...])，局部用 View::render('partials/xxx', $data)
• 多语言：标签优先 __('key')（lang/*.php）；内容与术语用 Poly / metas 的 name_en、译文组
• 链接：文章 /slug.html，语言前缀版 /en/slug.html；分类 /category/…
• SEO：主题负责输出 title/meta/OG/JSON-LD/canonical/hreflang（参考官方 yecha 主题实现）

建议

• 起步复制官方主题，只改配色与间距最快；
• 自定义样式放主题内，不要改内核；
• 主题需要新“页面”能力时，优先做成独立页（content page）或小插件。