# iPhoto Xiuno Theme 主题简介
iPhoto Xiuno Theme 是一款面向 Xiuno BBS 4.0 的图片卡片式响应主题。它将论坛首页、版块页和帖子页改造成更适合图片展示、摄影分享、作品发布与轻社区浏览的界面：内容以封面图优先呈现，导航更轻，页面留白更舒展，同时保留 Xiuno 原有的发帖、回帖、置顶、精华、推荐、分页和管理操作。
## 主要特性
- 响应式图片卡片列表：首页使用多列图片流布局，移动端自动调整为更适合触控浏览的双列/三列布局。
- 版块视觉强化：版块页带大图横幅、版块简介、发帖入口和基础统计信息。
- 清爽帖子页：帖子正文、回复列表、作者信息和快捷回复重新排版，更适合阅读图片和长内容。
- 顶部导航优化：使用粘性顶部导航、横向版块快捷入口和更简洁的用户操作区。
- 明暗模式切换：内置 Light / Dark 主题切换，并使用浏览器本地存储记住用户偏好。
- 返回顶部按钮：长页面滚动后自动显示，方便快速回到页面顶部。
- 图片兜底封面：主题会优先读取帖子中的常见封面字段，缺失时使用 `img/default.jpg` 作为默认封面。
## 适用场景
- 摄影、壁纸、图库、设计作品、插画作品等图片内容社区。
- 希望论坛首页更接近图片瀑布流/作品列表体验的 Xiuno 站点。
- 需要一个轻量、现代、无需额外依赖的 Xiuno 主题插件。
## 安装与启用
1. 将 `xn_iPhoto_theme` 目录放入 Xiuno 的 `plugin` 目录。
2. 进入 Xiuno 后台插件管理，安装并启用 `iPhoto Xiuno Theme`。
3. 如需替换默认封面图，可直接替换 `img/default.jpg`。
4. 如需调整主题色、间距、卡片圆角等视觉细节，可修改 `css/iphoto.css`。
## 封面图读取规则
主题在帖子列表中会依次尝试读取以下字段作为封面图：
`cover_url`、`image_url`、`pic_url`、`thumb_url`、`thumbnail`、`first_image`、`attach_url`
如果当前站点已有图片上传、附件封面或自定义字段插件，可以让对应插件写入以上任一字段，即可被主题列表自动展示。没有可用封面时，主题会显示内置默认图。
## 覆盖模板
本主题覆盖了以下 Xiuno 前台模板：
- `view/htm/header_nav.inc.htm`
- `view/htm/footer_nav.inc.htm`
- `view/htm/index.htm`
- `view/htm/forum.htm`
- `view/htm/thread_list.inc.htm`
- `view/htm/thread.htm`
- `view/htm/post_list.inc.htm`
如果站点同时启用了其他会覆盖这些模板的插件，请注意插件覆盖优先级，避免页面结构互相冲突。
## 文件结构
- `conf.json`：插件基础信息、Hook 和模板覆盖配置。
- `css/iphoto.css`：主题样式与响应式布局。
- `js/iphoto.js`：明暗模式切换与返回顶部交互。
- `hook/`：加载主题 CSS 和 JS。
- `overwrite/`：主题覆盖的 Xiuno 前台模板。
- `img/default.jpg`：帖子列表默认封面图。
- `icon.png`：插件图标。
## 注意事项
- 本主题适配 Xiuno BBS 4.0。
- 主题不改变数据库结构，也不强制依赖其他插件。
- 为获得最佳展示效果，建议帖子提供封面图或首图数据。
- 修改模板前建议先备份当前主题目录，便于回退。