# blog-web

**Repository Path**: soft-open-learning/blog-web

## Basic Information

- **Project Name**: blog-web
- **Description**: blog
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-22
- **Last Updated**: 2026-07-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Aethera

单页 landing page，全屏视频背景 + 无缝淡入淡出循环。

## 技术栈

- **Astro 7** (SSG, 1 page, zero-JS default)
- **React 19** (仅 BackgroundScene island)
- **Tailwind CSS v4**
- 托管在 CloudFront 的视频源

## 项目结构

```
src/
├── components/dynamic/   # BackgroundScene, VideoBackground
├── layouts/              # PageLayout (HTML shell)
├── pages/                # index.astro (唯一页面)
└── styles/               # base.css, fonts.css, effects.css
```

## 背景实现

- 视频从距顶部 300px 处开始，左右及底部贴边
- `requestAnimationFrame` 驱动 0.5s 淡入 / 0.5s 淡出
- 播放完成后重置 `currentTime = 0`，形成无缝循环
- 渐变遮罩：`white → transparent → white`

## 命令

| 命令 | 作用 |
|------|------|
| `pnpm dev` | 开发服务器 |
| `pnpm build` | 构建到 `dist/` |
| `pnpm preview` | 预览构建结果 |

## 模块进度

| 模块 | 子模块 | 状态 | 说明 |
|------|--------|------|------|
| **主页** | 视频背景 | ✅ 已完成 | 全屏视频，rAF 驱动 0.5s 淡入/淡出循环 |
| | 渐变遮罩 | ✅ 已完成 | white → transparent → white |
| | 导航栏 | ✅ 已完成 | 居中导航，当前页高亮 |
| | 响应式适配 | ✅ 已完成 | 移动端适配 |
| **项目展示预览** | 页面路由 | ❌ 未开始 | `/works` |
| | 作品数据 | ❌ 未开始 | JSON 数据文件 |
| | 作品卡片 | ❌ 未开始 | 封面 + 标题 + 描述 + 链接 |
| | 分类筛选 | ❌ 未开始 | 按标签过滤 |
| **笔记** | 页面路由 | ❌ 未开始 | `/blog` + `[...slug]` |
| | 文章数据 | ❌ 未开始 | 静态 Markdown / 外部 API |
| | 文章列表 | ❌ 未开始 | 卡片网格 + 搜索 + 标签云 |
| | 文章详情 | ❌ 未开始 | Markdown 渲染 |
| **友链** | 页面路由 | ❌ 未开始 | `/friends` |
| | 友链数据 | ❌ 未开始 | JSON 数据文件 |
| | 友链卡片 | ❌ 未开始 | 头像 + 名称 + 简介 + 链接 |

## 历史

原计划是功能完整的博客站点（Gitee 集成、作品集、GitHub 仓库、友链），后精简为纯背景视频 landing page。详见 `agent.md`。