快速上手
主题安装与切换
主题安装
主题以 zip 包上传,包内必须包含 theme.json 与主题入口模板。安装路径为 cms 的 themes/{code}/。
安装步骤
- 登录 cms 后台,进入「主题管理」。
- 上传主题 zip,系统会校验
theme.json并解压到themes/{code}。 - 点击「启用」,前台立即切换到新主题。
- 如页面样式未更新,执行「系统工具 → 清理缓存」。
主题包最小结构
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="..." /}。 - 主题依赖的插件需先安装并启用,否则对应标签输出为空。