# iCard Xiuno Theme 主题简介
iCard Xiuno Theme 是一款面向 Xiuno BBS 4.0 的个人卡片式主题。它参考 iCard 的视觉语言，把论坛首页、版块页、搜索页和帖子页整理成“顶部资料卡 + 左侧卡片导航 + 右侧内容网格”的布局，适合资源站、博客型社区、图文分享社区和轻量内容站。
## 主要特性
- 顶部个人资料卡：展示站点或当前用户信息，并提供登录、发帖、搜索、个人中心和暗色模式入口。
- 左侧卡片导航：桌面端使用大按钮纵向导航，移动端自动转为横向滑动快捷入口。
- 卡片式帖子列表：首页、版块页和搜索页使用双列帖子卡片，包含封面图、日期、标题、摘要、浏览数和回复数。
- 完整 Xiuno 功能保留：发帖、回帖、编辑、删除、置顶、精华、推荐、分页、附件和管理勾选仍沿用 Xiuno 原有逻辑。
- 独立搜索路由：主题自带 `search` 路由与搜索页，不依赖其他主题插件。
- 明暗模式切换：使用浏览器本地存储记住用户偏好。
- 响应式适配：桌面、平板、手机均有对应布局。
## 安装与启用
1. 将 `xn_iCard_theme` 目录放入 Xiuno 的 `plugin` 目录。
2. 进入 Xiuno 后台插件管理，安装并启用 `iCard Xiuno Theme`。
3. 如果安装后页面仍显示旧主题，请清理 Xiuno 缓存或重新启用本主题。
## 文件结构
- `conf.json`：插件信息、Hook 和模板覆盖配置。
- `hook/`：加载主题 CSS、JS，并注册搜索路由。
- `overwrite/view/htm/`：覆盖 Xiuno 前台模板。
- `route/search.php`：主题自带搜索路由。
- `css/icard.css`：主题样式与响应式布局。
- `js/icard.js`：暗色模式切换逻辑。
- `assets/img/`：顶部背景、头像占位图和帖子默认封面。
- `icon.png`：后台插件图标。
## 封面图规则
帖子列表会优先读取以下字段作为封面图：
`cover_url`、`image_url`、`pic_url`、`thumb_url`、`thumbnail`、`first_image`、`attach_url`
如果没有可用封面，主题会按帖子 ID 从 `assets/img/sj/` 中选择一张默认图。
## 注意事项
- 本主题适配 Xiuno BBS 4.0。
- 主题不修改数据库结构。
- 同时启用多个主题插件时，Xiuno 会自动卸载其他主题类插件；如有模板覆盖冲突，请检查插件优先级。