一、插件简介

• 将栏目页与文章页生成静态页面，减少服务器压力、提升加载速度与抗并发能力。

• 前台访问优先返回已生成的静态内容，未生成时仍可正常走动态页面。

• 支持手动生成、自动生成与一键批量生成，并提供一键清空静态页面的能力。

二、适用场景

• 内容相对稳定、访问量较高的站点（新闻、博客、资讯门户等）。

• 需要更快首屏与更好 SEO 支持的页面。

• 希望降低后端压力、提升高并发下的可用性。

三、功能一览

• 一键生成所有页面：按当前后台语言，批量生成所有“列表栏目”及其文章的静态页面。

• 指定生成：

• 栏目页：对某个栏目生成该栏目的静态页面。

• 文章页：对某个栏目下的全部文章或单篇文章进行生成。

• 自动生成：开启后，文章新增或更新时自动生成对应文章页及所属栏目页。

• 清空静态页面：一键清空已生成的静态页面（不影响动态页面）。

• 多语言支持：生成与列表均按当前后台语言进行。

四、安装与启用

• 在插件管理中安装“页面静态化”插件。

• 安装完成后启用插件，即可在后台菜单看到“页面静态化”入口。

• 如不再使用，可禁用或卸载插件（卸载不会自动删除已生成的静态页面）。

五、快速上手（推荐）
1) 进入后台 -> 页面静态化。
2) 如需切换语言，点击页面顶部的语言切换按钮后再进行操作。
3) 点击“一键生成所有页面”，等待提示完成后即可。
4) 如需针对性生成，可在列表中：

• 对栏目行点击“生成”生成栏目页；

• 对文章行点击“生成”生成文章页；也可选择“生成单篇文章”。
  5) 在“设置”中勾选“自动生成”，文章新增或更新时将自动生成静态页面。
  6) 需要清理已生成页面时，点击“清空静态页面”。

六、后台操作说明

• 页面顶部提供工具按钮：

• 刷新：重新加载当前列表与状态。

• 一键生成所有页面：批量生成当前语言下的栏目与文章静态页。

• 清空静态页面：删除已生成的静态页面（此操作不可恢复）。

• 设置：打开配置弹窗以调整生成策略。

• 列表区：

• 显示所有列表栏目及其文章，并标记“已生成/未生成”状态。

• 栏目可展开/收起查看文章；支持记忆最近的展开状态。

• 操作区：

• 栏目行：生成栏目页、预览页面。

• 文章行：生成文章页、预览页面。

七、设置项说明

• 自动生成：开启后，文章新增或更新时自动生成对应静态页。

• 静态路径：用于组织静态页面的子目录名称（可留空）。为了更好地与系统默认读取一致，建议填写“static”。

八、访问与生效说明

• 前台访问时，如果存在对应的静态页面，将直接返回静态内容以获得更快速度。

• 如果尚未生成或被清空，系统会自动回退到动态页面，网站访问不受影响。

• 更改内容后，如未开启自动生成，请在“页面静态化”中按栏目/文章进行重新生成。

九、常见问题

• 生成后访问仍显示旧内容？

• 可能是浏览器缓存或 CDN 缓存导致，尝试强制刷新或稍后再试。

• 请重新生成对应栏目或文章，确保最新内容已生成。

• 生成失败怎么办？

• 检查当前账户是否有操作权限。

• 确认页面地址可正常访问（无登录或权限限制）。

• 稍后重试，或联系站点管理员协助处理。

• 开启“自动生成”后仍未生效？

• 确认已在设置中勾选开关，且文章状态为“启用”。

• 对已发布的旧内容，仍需手动执行一次生成以建立初始静态页。

• 清空后找不到页面？

• 清空只影响静态页面，不影响动态页面。若访问地址不存在静态页，将自动回退到动态页。

十、最佳实践

• 建议开启“自动生成”，保证文章更新后能迅速同步到静态页面。

• 大改版或批量编辑后，优先使用“一键生成所有页面”以确保一致性。

• 静态路径建议设置为“static”，便于统一管理与访问。

• 定期检查重点栏目与文章是否为“已生成”状态，确保热点内容访问体验。

十一、版本信息

• 插件名称：页面静态化（staticsite）

• 当前版本：1.0.0

• 作者与网站：ahui / badoucms.com

十二、联系我们

• 如需定制或问题咨询，请联系站点管理员或官方支持渠道。

（本文档不包含技术实现细节，仅面向最终使用者。）