Skip to content

Commit 0839f45

Browse files
committed
Update README.md with project overview, features, environment variables, routing, and startup instructions
1 parent 238ea33 commit 0839f45

File tree

1 file changed

+41
-0
lines changed

1 file changed

+41
-0
lines changed

README.md

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,42 @@
11
# plist
2+
3+
## 项目简介
4+
5+
`plist` 是一个基于 Go 的在线图片分类展示工具,支持静态和动态加载图片,提供简单的认证功能。
6+
7+
## 功能特性
8+
9+
- **图片分类展示**:支持按目录分类展示图片。
10+
- **动态加载**:支持动态加载分类和图片,提升用户体验。
11+
- **认证功能**:通过密码保护访问,未认证用户需登录。
12+
- **分页支持**:分类和图片支持分页加载。
13+
- **自定义配置**:通过环境变量自定义站点配置。
14+
15+
## 环境变量配置
16+
17+
以下环境变量可用于自定义站点配置:
18+
19+
- `SITE_DIR`:图片目录路径(默认值:`./`images)。
20+
- `SITE_PASSWORD`:访问密码(默认值:空)。
21+
- `SITE_PORT`:服务端口(默认值:`8008`)。
22+
- `SITE_TITLE`:站点标题(默认值:`在线图集`)。
23+
- `SITE_ICON`:站点图标 URL(默认值:`https://i.obai.cc/favicon.ico`)。
24+
- `SITE_DYNAMIC`:是否启用动态加载(默认值:`false`)。
25+
26+
## 路由说明
27+
28+
- `/`:主页面,展示图片分类。
29+
- `/category/{分类名}`:分类页面,展示分类下的图片。
30+
- `/login`:登录页面,用于认证访问。
31+
- `/api/index`:获取分类的 JSON 数据(动态模式)。
32+
- `/api/category/{分类名}`:获取分类下图片的 JSON 数据(动态模式)。
33+
- `/images/{分类名}/{图片名}`:访问图片文件。
34+
35+
## 启动项目
36+
37+
1. 确保已安装 Go 环境。
38+
2. 将项目克隆到本地并进入项目目录。
39+
3. 使用以下命令运行项目:
40+
```sh
41+
go run main.go
42+
```

0 commit comments

Comments
 (0)