78 lines
1.7 KiB
Markdown
78 lines
1.7 KiB
Markdown
# 静态资源目录
|
||
|
||
本目录存放项目的所有静态资源文件。
|
||
|
||
## 📁 目录结构
|
||
|
||
```
|
||
static/
|
||
├── images/ # 图片资源
|
||
│ └── logo.jpg # 系统 Logo（106KB）
|
||
├── icons/ # 图标资源
|
||
│ ├── favicon.ico # 浏览器标签页图标
|
||
│ ├── apple-touch-icon.png
|
||
│ └── android-chrome-*.png
|
||
└── fonts/ # 字体文件
|
||
```
|
||
|
||
## 📋 文件说明
|
||
|
||
### images/
|
||
- `logo.jpg` - 系统主 Logo，用于登录页面和首页
|
||
|
||
### icons/
|
||
- `favicon.ico` - 16x16 浏览器标签页图标
|
||
- `apple-touch-icon.png` - 180x180 iOS 设备图标
|
||
- `android-chrome-192.png` - 192x192 Android 图标
|
||
- `android-chrome-512.png` - 512x512 Android 图标
|
||
|
||
### fonts/
|
||
- 自定义字体文件（如有需要）
|
||
|
||
## 🎨 资源规范
|
||
|
||
### Logo
|
||
- 格式：JPG/PNG/SVG
|
||
- 建议尺寸：512x512 或更大
|
||
- 用途：登录页面、首页、关于页面
|
||
|
||
### Favicon
|
||
- 格式：ICO（多尺寸包含 16x16, 32x32）
|
||
- 用途：浏览器标签页、书签
|
||
|
||
### 应用图标
|
||
- 格式：PNG（透明背景）
|
||
- 尺寸：192x192, 512x512
|
||
- 用途：PWA、主屏幕快捷方式
|
||
|
||
## 📦 部署说明
|
||
|
||
### 后端访问
|
||
```python
|
||
# FastAPI 挂载静态文件目录
|
||
app.mount("/static", StaticFiles(directory="static"), name="static")
|
||
```
|
||
|
||
### 前端访问
|
||
```javascript
|
||
// 开发环境
|
||
<img src="/static/images/logo.jpg" />
|
||
|
||
// 生产环境（由 Nginx 代理）
|
||
<img src="/static/images/logo.jpg" />
|
||
```
|
||
|
||
### Nginx 配置示例
|
||
```nginx
|
||
# 静态资源
|
||
location /static {
|
||
alias /path/to/jiachenlong/static;
|
||
expires 30d;
|
||
add_header Cache-Control "public, immutable";
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
**最后更新**: 2026-03-16
|