第二十七章主题目录与文件分工

Ju7CMS 用户手册 · 发布于 2026-10-27 · 更新于 2026-10-27

主题就是一个目录：model 下七个目录各放什么、栏目怎么绑模板、改一处会影响哪里，以及新建主题的四个规则。

主题就是一个目录

前台长什么样，全部由 theme/ 下的一个目录决定。本站当前用的是 theme/576so/，目录名写在根目录 andvar.asp 的 theme_root 里。换主题不是回到后台点一下，而是把 theme_root 改成另一个目录名——这件事放到第三十五章讲。

文件 / 目录	职责
`config.xml`	主题说明：名称、适用终端（响应式）、语言、网址、日期、缩略图名
`index1.html`	首页模板。文件名里的 `1` 是语言编号
`head1.html`	页头：LOGO、主导航、城市切换、搜索框
`foot1.html`	页脚：联系方式、服务地区、友情链接、咨询弹窗
`seo/head.html`	所有页面共用的 `head` 内容：meta、预加载、统计脚本
`css/ju7.css`	全站唯一的主样式表
`js/`	`ju7.js` 公共脚本、`banner-count.js` 首页轮播、`floatbar.js` 浮动工具条、`leadform.js` 咨询弹窗
`images/`	主题图片；`images/docs/` 是本手册的插图
`model/`	各类页面模板，见下一节
`576so.webp`	主题缩略图，「模板管理」里显示的那张

文件名里的数字就是语言编号。程序取的是 head[langid].html、index[langid].html、foot[langid].html，所以只有一个语言时它们叫 head1、index1、foot1。新增语言要补齐这三个文件，缺一个该语言的前台就会 500。

search/、404/、password/ 三个目录只有一个文件，全站共用，不跟着栏目走。前面的业务目录里，一个文件往往被多个栏目共用，改一处会同时影响这些栏目。

每个栏目有两个模板字段：列表模板与内容模板，存的是相对 theme/主题名/ 的路径。从本站的真实配置里挑几行看就明白：

模板字段为空时，程序会退回 model/list/1.html 与 model/show/1.html。所以「页面能打开但样子不对」的第一嫌疑是栏目上绑错或没绑模板，不是模板文件坏了。

「功能 → 模板管理」可以直接编辑这些文件，也可以预览。它是前台整站的源码，改错一行可能整页 500 或整页空白，而且不会在后台提示。生产站上编辑前，先把文件下载一份。