# 笔趣阁小说主题简介

笔趣阁小说主题是为 Xiuno BBS 制作的小说阅读站主题，适合把论坛版块内容组织成小说分类、书籍详情、章节目录和在线阅读页面。

## 主要功能

- 风格头部：细条栏、站点 Logo、快速搜索、阅读记录入口和横向分类导航。

- 小说首页：强力推荐、最近更新、分类推荐、热门排行等模块，列表字段按小说站习惯展示。

- 分类页：去掉多余面包屑和分类二级栏，改为紧凑的小说网格列表。

- 小说详情页：展示封面、作者、状态、最新章节、简介、相关推荐和章节目录。

- 章节目录支持倒序切换，并在顶部提供“更新报错 | 直达底部”快捷入口。

- 阅读页支持章节正文展示、上一章、目录、下一章等基础阅读操作。

- 搜索页和帖子列表自动适配小说封面、作者、简介和最近章节信息。

- 后台主题设置支持站点标题、Logo、SEO、阅读字号、阅读宽度、游客可读章节、页脚和统计代码。

- 内置自动采集，可从排行数据导入小说分类、书籍信息和章节目录。【授权版专属】

- 支持宝塔计划任务，可使用“访问 URL”或“Shell 脚本”定时触发同步。

## 全站同步

后台路径：插件设置 -> 笔趣阁小说主题 -> 全站同步。

可配置项：

- 采集配置：从某网站采集的小说总数。

- 每类数量：限制每个分类导入数量，填 0 表示不限制。

- 清空后同步：开启后会清空现有分类、主题、回帖和小说数据，再重新导入。

- 立即全站同步：后台异步启动同步任务。

- 宝塔定时：提供带密钥的访问 URL 和 Shell 命令，便于添加计划任务。

同步脚本：

```bash

php plugin/xn_biquge_theme/tools/sync_qute_top.php --limit=80 --per-category=0

```

不清空原数据时可追加：

```bash

--no-clear

```

## 宝塔定时建议

在宝塔面板添加计划任务时，推荐每天低峰期执行一次。

可选两种方式：

- 访问 URL：复制后台生成的 cron 地址。

- Shell 脚本：复制后台生成的命令，在站点根目录执行。

cron 地址带有后台生成的密钥，请不要公开泄露。

## 注意事项

- 开启“清空后同步”会删除现有论坛分类、主题、回帖和小说扩展数据，请先确认站点没有需要保留的内容。

- 全站同步依赖 PHP CLI、curl、DOM、mbstring 等常见扩展。

- 若后台无法启动异步任务，请检查宝塔 PHP 禁用函数，至少需要放行 `popen`、`exec` 或 `shell_exec` 中的一个，或改用宝塔 Shell 计划任务。

- 主题不会在普通前台访问时自动采集，只有后台点击同步、宝塔 cron 或手动执行脚本时才会启动。

## 适用场景

适合小说目录站、章节更新站、在线阅读站，以及希望用 Xiuno 版块数据快速搭建小说内容结构的网站。

## 演示

https://biquge.locbb.eu.org/