主题开发文档

主题开发01：从零创建可被 WooCMS 识别的主题包

讲清主题目录、manifest 与 layouts 的最小闭环，确保一次扫描即可识别。

更新时间：2026-02-26 21:05:34.607916 +0000 UTC

结合 Specificity Cascade，教你验证 custom > preset > builtin fallback。

更新时间：2026-02-26 18:47:36.72372 +0000 UTC

说明页面、分类与模板键绑定关系，避免“模板已写但不生效”。

更新时间：2026-02-26 18:47:36.72372 +0000 UTC

覆盖 taxonomy 模板与文章主分类模板匹配规则，支撑频道化站点开发。

更新时间：2026-02-26 18:47:36.72372 +0000 UTC

使用 scripts/package_theme.sh 打包并通过后台上传安装，形成标准发布动作。

更新时间：2026-02-26 18:47:36.72372 +0000 UTC

围绕 code/version/presets/template_key 解释命名规则，减少扫描与激活失败。

更新时间：2026-02-26 18:47:36.72372 +0000 UTC

说明主题模板输出策略，避免前台引入不受控脚本与危险属性。

更新时间：2026-02-26 18:47:36.72372 +0000 UTC

结合 SiteContext 机制，避免“在 A 站改模板却在 B 站验证”的联调偏差。

更新时间：2026-02-26 18:47:36.72372 +0000 UTC

给出从开发到上线的完整检查清单，开发者可按单执行并自检。

更新时间：2026-02-26 18:47:36.72372 +0000 UTC

出现线上渲染异常时，按“回滚主题→核查模板→再发布”闭环处理。

更新时间：2026-02-26 18:47:36.72372 +0000 UTC