# niRvana Xiuno Theme
基于 niRvana 作品展示风格适配的 Xiuno BBS 主题插件。
## 主题特点
- 参考 niRvana 演示站的浮动导航、分类横条、图片卡片墙和暗色展示氛围。
- 首页与版块页采用响应式卡片网格，桌面端多列展示，移动端自动收缩。
- 帖子卡片优先使用正文图片或附件图片作为封面，没有图片时使用主题预览图兜底。
- 保留 Xiuno 的发帖、回复、置顶、精华、版块导航、登录用户菜单等论坛功能。
- 内置 Play 字体、暗色模式切换、页面加载动画和返回顶部按钮。
## 安装方式
将 `xn_niRvana_theme` 目录放入 Xiuno 的 `plugin/` 目录，然后进入后台插件管理安装并启用。
如果更新主题后样式或页面没有变化，请在后台清理缓存，或删除 `tmp/` 下对应的 `route_index.php`、`route_forum.php`、`view_htm_*` 缓存文件后刷新页面。
## 文件说明
- `conf.json`：Xiuno 插件配置。
- `hook/`：注入 CSS、JS，并在首页/版块页渲染前准备帖子封面。
- `overwrite/view/htm/`：覆盖 Xiuno 首页、版块页、帖子页、导航、页脚和列表模板。
- `css/nirvana.css`：主题主样式。
- `js/nirvana.js`：暗色模式、加载动画和返回顶部交互。
- `include/nirvana.func.php`：帖子封面提取辅助函数。
## 注意事项
PHP hook 文件是 Xiuno 直接拼接执行的代码片段，不能包含 `<?php` 和 `?>` 标签。
帖子封面提取顺序为：正文 Markdown 图片、正文 HTML 图片、附件图片、主题默认预览图。