
# Light.W Xiuno Theme
一款专为图片内容而生的 Xiuno 主题,参考 Light.W / bz.loc.cc 的轻量瀑布流风格改造,适合图片分享、壁纸、相册、摄影和图集类社区。
## 主题特点
- 基于 Xiuno BBS 4.x 和 Bootstrap 4 页面结构
- 首页、版块页采用响应式瀑布流图片卡片布局
- 主色调 `#3cc376`,整体清新、轻量、留白充足
- 自动提取主题首帖中的第一张图片作为列表缩略图
- 支持自定义缩略图字段和正文标记
- 集成 baguetteBox.js,帖子详情页图片支持灯箱预览
- 保留 Xiuno 原生发帖、回帖、编辑、删除、分页、版主管理能力
- 手机端自动切换为双列紧凑瀑布流
## 缩略图规则
列表缩略图按以下顺序获取:
1. 主题数据字段:`cover_url`、`image_url`、`pic_url`、`thumb_url`、`thumbnail`、`lightw_thumb`
2. 首帖正文标记:`lightw-thumb: 图片地址`
3. 首帖正文标记:`thumb: 图片地址`
4. 首帖正文标记:`thumbnail: 图片地址`
5. 首帖正文中的第一张 `<img>` 图片
6. 首帖正文中的第一条图片 URL
7. 主题目录下的 `screenshot.png`
示例:
```text
lightw-thumb: https://example.com/cover.webp
这里是帖子正文内容。
```
## 图片查看器
主题已内置 `baguetteBox.js`:
- 文件位置:`vendor/baguettebox/`
- 样式通过 `hook/header_link_after.htm` 加载
- 脚本通过 `hook/footer_js_after.htm` 加载
- 帖子详情页正文图片会自动变成可点击预览
## 文件结构
```text
xn_LightW_theme/
├─ conf.json
├─ install.php
├─ unstall.php
├─ icon.png
├─ screenshot.png
├─ css/
│ └─ lightw.css
├─ js/
│ └─ lightw.js
├─ hook/
│ ├─ header_link_after.htm
│ └─ footer_js_after.htm
├─ overwrite/view/htm/
│ ├─ header_nav.inc.htm
│ ├─ footer_nav.inc.htm
│ ├─ index.htm
│ ├─ forum.htm
│ ├─ thread_list.inc.htm
│ ├─ thread.htm
│ └─ post_list.inc.htm
└─ vendor/baguettebox/
├─ baguetteBox.min.css
└─ baguetteBox.min.js
```
## 安装说明
1. 将 `xn_LightW_theme` 放入 Xiuno 的 `plugin/` 目录。
2. 进入 Xiuno 后台插件管理。
3. 安装并启用 `Light.W Xiuno Theme`。
4. 清理缓存后刷新前台页面。
## 兼容说明
- 适配 Xiuno BBS 4.x。
- 主题使用 Xiuno 原生 Bootstrap 4 环境。
- 原 Light.W 是 Typecho 主题,本版本已转换为 Xiuno 插件主题结构,不依赖 Typecho。