如何创建PbootCMS单页模板？

PbootCMS 里的”单页”本质上是一个”内容模型为‌专题‌的栏目”，一个栏目对应一篇文章，没有列表页。‌ 所以”创建单页模板”这件事拆开只有两半——后台建一个单页栏目、模板目录里建一个对应的 .html 文件，再让前者指向后者。
一、先理清两个容易搞混的概念

‌单页 ≠ 独立页面文件‌：它不是靠某个固定文件名自动生效的，而是由后台栏目”‌内容页模板‌”字段里填的那个文件名决定。
‌默认约定‌：选择”专题”模型后，系统给的内容页模板默认就是 about.html。你完全可以改成 contact.html、service.html 等任意名字，改的是”这个单页用哪个模板文件渲染”。
‌命名要点‌：文件名全小写、以 .html 结尾（不是 .txt），文件编码必须 ‌UTF-8 无 BOM‌，否则中文会乱码、标签可能不解析。

二、第一步：后台创建单页（先有数据，才有内容可调）

进入后台，按这个路径走：

‌基础内容 → 内容栏目 → 栏目新增‌

关键几项这样填：

‌栏目名称‌：如”关于我们””联系我们”
‌内容模型‌：选 ‌专题‌（它在这里叫”专题”，其实就是单页）
‌列表页模板‌：选择”无”（单页没有列表）
‌内容页模板‌：填你想用的模板文件名，如 about.html；想给”联系我们”单独做样式就改成 contact.html
‌栏目编码（scode）‌：如 about、contact，‌全小写、不可重复‌，这个值后面调用时要对应上

保存栏目后，回到 ‌文章内容 → 专题内容‌，就能看到刚建的单页，点进去编辑标题、正文、扩展字段即可。
三、第二步：在模板目录里创建模板文件

在网站根目录的 /template/你的模板目录/ 下新建文件，例如 about.html：

text
/template/
└── 你的模板目录/
├── index.html # 首页
├── list.html # 栏目列表页
├── content.html # 文章/产品详情页
├── about.html # 单页模板（就是本次要建的）
├── header.html # 公共头部
├── footer.html # 公共底部
└── static/ # css / js / images 资源

公共头尾用 {pboot:include(‘header.html’)} 引入，避免重复写；静态资源路径统一用 {pboot:sitetplpath}/static/…（或 {pboot:templatepath}），这样换模板、换域名、装到子目录都不会 404。
四、第三步：在模板里写标签

‌1）在单页自己的模板（如 about.html）里调用‌

单页自身就是一篇内容，直接用内容详情标签即可：

html
{content:title}
{content:content}

‌2）在首页、侧栏等其他页面调用指定单页‌

两种写法都可用：

html
<!– 写法A：按栏目编码调用（推荐，换ID也不影响） –>
{pboot:content scode=about}
<a href=”[content:link]”>[content:title]</a>
{/pboot:content}

<!– 写法B：按内容ID调用（注意是内容ID，不是栏目编码） –>
{pboot:content id=1}
<a href=”[content:link]”>[content:title]</a>
{/pboot:content}

‌3）常用的单页字段（循环体里用方括号写法）‌
表格
字段 说明
[content:title] 标题
[content:content] 富文本正文
[content:link] 链接
[content:ico] 缩略图
[content:date] 日期
[content:keywords] / [content:description] 关键词 / 描述
[content:ext_字段名] 自定义扩展字段
五、完整实战示例（about.html 可直接复用）

html
{pboot:include(‘header.html’)}
<main class=”single-page”>
<!– 页面 Banner（用扩展字段 ext_banner 传图） –>
<div class=”page-banner”>
<img src=”[content:ext_banner]” alt=”[content:title]”>
[content:title]</h1>
</div>

<!– 正文 –>
<div class=”container”>
<div class=”page-content”>
[content:content]
</div>

<!– 扩展字段：联系方式 –>
<div class=”contact-info”>
电话：[content:ext_tel]</p>
邮箱：[content:ext_email]</p>
地址：[content:ext_address]</p>
</div>

<p class=”update-time”>更新时间：[content:date]</p>
</div>
</main>
{pboot:include(‘footer.html’)}

想给页面加缓存（降低数据库压力），可在调用处加 cache 参数，例如 {pboot:single scode=’about’ cache=3600} 表示缓存 1 小时。
多语言站点调用时加 lng 参数，如 {pboot:single scode=’service’ lng=’en’}。

六、后台启用与生效检查

模板文件上传到 /template/你的模板目录/。
后台 ‌系统设置 → 模板风格‌，确认当前启用的是你修改的这套模板。
后台 ‌清理缓存‌，再刷新前台页面。

七、常见问题排查

‌单页内容不显示‌：先核对栏目编码（scode）与模板里写的是否完全一致。
‌标签被原样输出成文本‌：确认文件后缀是 .html，且编码是 UTF-8 无 BOM。
‌扩展字段为空‌：检查后台该单页的扩展字段名与模板中 ext_ 后的名字是否‌完全一致（含大小写）‌。
‌整站单页/详情页突然都不显示‌：少见但真实——检查后台是否在”‌内链替换次数‌”里误填了域名，清掉即可恢复。
‌路径/样式错乱‌：优先排查是否用了写死的相对路径，改用 {pboot:sitetplpath} 动态路径。