快速上手

主题安装与切换

更新于 2026-11-13 阅读 2 # 主题安装 主题以 zip 包上传,包内必须包含 `theme.json` 与主题入口模板。安装路径为 cms 的 `… Markdown

主题安装

主题以 zip 包上传,包内必须包含 theme.json 与主题入口模板。安装路径为 cms 的 themes/{code}/。

安装步骤

  1. 登录 cms 后台,进入「主题管理」。
  2. 上传主题 zip,系统会校验 theme.json 并解压到 themes/{code}。
  3. 点击「启用」,前台立即切换到新主题。
  4. 如页面样式未更新,执行「系统工具 → 清理缓存」。

主题包最小结构

mytheme/
├─ theme.json
├─ index/index.html
├─ list/list.html
├─ show/show.html
├─ common/header.html
├─ common/footer.html
└─ assets/style.css

切换注意事项

  • 启用新主题后,旧主题的模板标签调用不会自动迁移。
  • 主题内引用的静态资源建议使用 {pycms:theme_asset path="..." /}。
  • 主题依赖的插件需先安装并启用,否则对应标签输出为空。