initial commit

This commit is contained in:
Jiao77
2025-09-29 05:57:18 +08:00
commit 9c0051c92b
73 changed files with 18737 additions and 0 deletions

94
docs/CENTER_FIX.md Normal file
View File

@@ -0,0 +1,94 @@
# 居中问题修复说明
## 🔧 问题分析
"欢迎来到 Jiao77" 卡片没有居中的问题是因为 Container 组件只设置了 `max-width` 但没有添加 `margin: 0 auto` 来实现水平居中。
## ✅ 修复内容
### 1. 修复 Container 组件
`src/components/Container.astro` 中为所有尺寸的容器添加了 `margin: 0 auto`
```css
/* 尺寸样式 */
.container-small {
max-width: 400px;
margin: 0 auto; /* 添加自动居中 */
}
.container-medium {
max-width: 600px;
margin: 0 auto; /* 添加自动居中 */
}
.container-large {
max-width: 800px;
margin: 0 auto; /* 添加自动居中 */
}
.container-full {
width: 100%;
}
```
### 2. 增强页面布局
`src/pages/index.astro` 中添加了外层容器来确保最佳的居中效果:
```astro
<main class="main-content">
<div class="container mx-auto px-4"> <!-- 新增的容器 -->
<AnimatedElement animation="fadeInUp" delay={200}>
<Container variant="glass" size="large" padding="xl" className="text-center mb-12">
<h1 class="hero-title">欢迎来到 Jiao77</h1>
<p class="hero-subtitle">探索现代化的网站体验</p>
</Container>
</AnimatedElement>
</div>
</main>
```
### 3. 添加配套的 CSS 样式
```css
.container {
max-width: 1200px;
width: 100%;
}
.mx-auto {
margin-left: auto;
margin-right: auto;
}
.px-4 {
padding-left: 1rem;
padding-right: 1rem;
}
```
## 🎯 修复效果
现在 "欢迎来到 Jiao77" 卡片会:
- ✅ 在桌面端完美居中显示
- ✅ 在移动端保持良好的响应式布局
- ✅ 保持原有的玻璃质感和动画效果
- ✅ 与下方的导航卡片网格保持一致的对齐
## 📱 响应式支持
修复同时考虑了不同屏幕尺寸:
- **大屏设备**: 最大宽度 800px居中显示
- **中等设备**: 自动适应容器宽度
- **小屏设备**: 添加适当的左右内边距防止贴边
## 🚀 部署更新
要应用这个修复到生产环境,请运行:
```bash
# 构建新版本
npm run build
# 部署到服务器
./deploy-full.sh
```
修复已完成!现在您的大标题卡片会在页面中完美居中显示。

206
docs/DEPLOYMENT.md Normal file
View File

@@ -0,0 +1,206 @@
# 🚀 部署指南
将您的 Astro 网站部署到 jiao77.cn (110.42.70.70) 服务器的完整步骤。
## 📋 部署前准备
### 1. 确认服务器环境
登录到您的服务器并检查:
```bash
# SSH 连接到服务器
ssh root@110.42.70.70 # 或您的用户名
# 检查 Apache 状态
sudo systemctl status apache2
# 检查 Apache 网站根目录
ls -la /var/www/jiao77.cn/
# 检查 Apache 模块
apache2ctl -M | grep -E "(rewrite|deflate|expires|headers)"
```
### 2. 启用必要的 Apache 模块
如果模块未启用,请运行:
```bash
sudo a2enmod rewrite
sudo a2enmod deflate
sudo a2enmod expires
sudo a2enmod headers
sudo systemctl reload apache2
```
## 🚀 部署步骤
### 方法一:自动部署 (推荐)
1. **构建项目**
```bash
npm run build
```
2. **运行部署脚本**
```bash
./deploy.sh
```
按提示输入服务器用户名和网站根目录路径。
### 方法二:手动部署
1. **构建项目**
```bash
npm run build
```
2. **压缩文件**
```bash
cd dist
tar -czf ../website.tar.gz *
cd ..
```
3. **上传到服务器**
```bash
scp website.tar.gz root@110.42.70.70:/tmp/
```
4. **在服务器上解压**
```bash
ssh root@110.42.70.70
cd /var/www/html
sudo rm -rf * # 清空现有文件 (请谨慎!)
sudo tar -xzf /tmp/website.tar.gz -C /var/www/html/
sudo chown -R www-data:www-data /var/www/html/
sudo chmod -R 755 /var/www/html/
```
### 方法三:使用 rsync (最佳选择)
```bash
# 直接同步 dist 目录内容
rsync -avz --delete --progress dist/ root@110.42.70.70:/var/www/html/
```
## ⚙️ Apache 配置
### 1. 配置虚拟主机 (可选但推荐)
`apache-config.conf` 的内容添加到您的 Apache 配置中:
```bash
# 在服务器上
sudo nano /etc/apache2/sites-available/jiao77.conf
# 粘贴 apache-config.conf 的内容
# 启用站点
sudo a2ensite jiao77.conf
sudo systemctl reload apache2
```
### 2. 上传 .htaccess 文件
确保 `.htaccess` 文件已上传到网站根目录:
```bash
scp .htaccess root@110.42.70.70:/var/www/html/
```
## 🔧 服务器优化
### 1. 设置正确的文件权限
```bash
sudo chown -R www-data:www-data /var/www/html/
sudo find /var/www/html/ -type d -exec chmod 755 {} \;
sudo find /var/www/html/ -type f -exec chmod 644 {} \;
```
### 2. 配置防火墙 (如果启用)
```bash
sudo ufw allow 80/tcp # HTTP
sudo ufw allow 443/tcp # HTTPS
```
## 📊 部署后检查
### 1. 功能测试
- [ ] 访问 http://jiao77.cn 或 http://110.42.70.70
- [ ] 检查首页导航卡片是否正常显示
- [ ] 访问 `/reports` 页面确认报告组件正常
- [ ] 测试页眉展开/收缩功能
- [ ] 检查移动端响应式设计
- [ ] 验证动画效果是否流畅
### 2. 性能测试
```bash
# 使用 curl 测试压缩
curl -H "Accept-Encoding: gzip" -I http://jiao77.cn
# 检查响应时间
curl -o /dev/null -s -w "时间: %{time_total}s\n" http://jiao77.cn
```
### 3. 在线工具检测
- [GTmetrix](https://gtmetrix.com/) - 性能分析
- [PageSpeed Insights](https://pagespeed.web.dev/) - Google 性能评分
- [SSL Labs](https://www.ssllabs.com/ssltest/) - SSL 配置检测 (如果使用 HTTPS)
## 🔄 更新部署流程
当您需要更新网站时:
1. **修改代码**
2. **重新构建**: `npm run build`
3. **部署**: `./deploy.sh`
## 🛡️ SSL/HTTPS 配置 (推荐)
### 1. 获取免费 SSL 证书 (Let's Encrypt)
```bash
sudo apt update
sudo apt install certbot python3-certbot-apache
sudo certbot --apache -d jiao77.cn -d www.jiao77.cn
```
### 2. 自动续期
```bash
sudo crontab -e
# 添加这行:
0 12 * * * /usr/bin/certbot renew --quiet
```
## 🐛 故障排除
### 问题1页面不显示或显示 Apache 默认页
- 检查文件权限
- 确认 DocumentRoot 配置正确
- 查看 Apache 错误日志:`sudo tail -f /var/log/apache2/error.log`
### 问题2CSS/JS 文件加载失败
- 检查 .htaccess 文件是否正确上传
- 确认 mod_rewrite 模块已启用
- 检查文件路径是否正确
### 问题3动画效果不工作
- 检查 JavaScript 控制台错误
- 确认所有资源文件都已上传
- 验证 Content-Security-Policy 配置
### 问题4移动端显示异常
- 检查 viewport meta 标签
- 验证响应式 CSS 是否正确加载
- 测试不同设备和浏览器
## 📞 技术支持
如果遇到部署问题,请检查:
1. Apache 错误日志:`/var/log/apache2/error.log`
2. Apache 访问日志:`/var/log/apache2/access.log`
3. 浏览器开发者工具控制台
4. 网络连接和防火墙设置
## 📈 监控和维护
建议设置:
- 定期备份网站文件
- 监控服务器资源使用情况
- 定期更新 Apache 和系统安全补丁
- 设置网站监控服务检测可用性

153
docs/TEXT_COLOR_UPDATE.md Normal file
View File

@@ -0,0 +1,153 @@
# 📝 文字颜色更新 & 文档整理
## ✅ 完成的更新
### 🎨 主题配色全面升级
已将网站配色全面更新为莫兰迪色彩主题,包含深蓝色文字系统和蓝绿色调背景,营造优雅舒适的视觉体验。
#### 🌊 主题色彩方案:
- **主色调**: `#5b778e` (深蓝灰)
- **辅助色1**: `#b2c5d5` (浅蓝灰)
- **辅助色2**: `#b1d9d4` (薄荷绿)
- **辅助色3**: `#aecedd` (天空蓝)
- **深蓝文字**: `#011a2d` (深海蓝)
- **中蓝文字**: `#2c4a6b` (海洋蓝)
#### 更新的组件和元素:
**1. 首页 (`src/pages/index.astro`)**
- 主标题: `#011a2d` (深蓝色)
- 副标题: `#011a2d` (深蓝色)
- 描述文字: `#2c4a6b` (中等深蓝色)
- 标题渐变: `#011a2d``#2c4a6b``#5b778e`
**2. Header组件 (`src/components/Header.astro`)**
- 品牌标题: `#011a2d` (深蓝色)
- 导航链接: `#011a2d` (深蓝色)
- 按钮文字: `#011a2d` (深蓝色)
- 品牌渐变: `#011a2d``#2c4a6b`
**3. Footer组件 (`src/components/Footer.astro`)**
- 品牌标题: `#011a2d` (深蓝色)
- 副标题: `#011a2d` (深蓝色)
- 描述文字: `#2c4a6b` (中等深蓝色)
- 链接文字: `#2c4a6b` (中等深蓝色)
- 社交链接: `#2c4a6b` (中等深蓝色)
- 版权信息: `#2c4a6b` (中等深蓝色)
- 悬浮状态: `#011a2d` (深蓝色)
**4. NavigationCard组件 (`src/components/navigation/NavigationCard.astro`)**
- 卡片图标: `#5b778e` (主题蓝灰)
- 悬浮图标: `#011a2d` (深蓝色)
- 卡片标题: `#011a2d` (深蓝色)
- 描述文字: `#2c4a6b` (海洋蓝)
- 箭头图标: `#5b778e` (主题蓝灰)
- Primary背景: `rgba(91, 119, 142, 0.1)` (主色调透明)
- Secondary背景: `rgba(178, 197, 213, 0.1)` (辅助色1透明)
- Accent背景: `rgba(177, 217, 212, 0.1)` (辅助色2透明)
**5. MetricCard组件 (`src/components/report/MetricCard.astro`)**
- 默认图标: `#5b778e` (主题蓝灰)
- 图标背景: `rgba(91, 119, 142, 0.2)` (主色调透明)
- 指标标题: `#2c4a6b` (海洋蓝)
- 指标数值: `#011a2d` (深蓝色)
- 中性变化: `#5b778e` (主题蓝灰)
- Primary背景: `#5b778e → #b2c5d5` (渐变)
- Success背景: `#b1d9d4 → #aecedd` (渐变)
- Warning背景: `#b2c5d5 → #aecedd` (渐变)
- Info背景: `#aecedd → #b1d9d4` (渐变)
**6. MetricsGrid组件 (`src/components/report/MetricsGrid.astro`)**
- 网格标题: `#011a2d` (深蓝色)
- 底部边框: `rgba(91, 119, 142, 0.3)` (主色调透明)
**7. ReportSection组件 (`src/components/report/ReportSection.astro`)**
- 区域标题: `#011a2d` (深蓝色)
- 标题渐变: `#011a2d → #2c4a6b → #5b778e`
- 副标题: `#2c4a6b` (海洋蓝)
- 分割线: `rgba(91, 119, 142, 0.3-0.6)` (渐变)
- 正文内容: `#2c4a6b` (海洋蓝)
- 列表项: `#5b778e` (主题蓝灰)
- 加粗文字: `#011a2d` (深蓝色)
- 代码块: `#011a2d` 文字 + `rgba(91, 119, 142, 0.15)` 背景
- 引用块: `#2c4a6b` 文字 + `#5b778e` 左边框
#### 🎨 颜色层次结构:
- **深蓝文字** (`#011a2d`): 主标题、品牌、重要导航
- **海洋蓝文字** (`#2c4a6b`): 描述文字、链接、正文内容
- **主题蓝灰** (`#5b778e`): 图标、装饰元素
- **背景色调**: 莫兰迪蓝绿渐变系统
- **卡片背景**: 主题色透明叠加效果
- **渐变效果**: `#011a2d``#2c4a6b``#5b778e`
### 📁 文档整理
创建了 `docs/` 文件夹并整理了所有说明文档:
```
docs/
├── CENTER_FIX.md # 居中问题修复说明
├── DEPLOYMENT.md # 详细部署指南
├── THEME_UPDATE.md # 主题色更新说明
└── UPDATE_CARDS.md # 卡片内容更新说明
```
#### 文档结构:
- **根目录**: 只保留 `README.md` 主要说明
- **docs目录**: 包含所有技术文档和更新日志
- **配置文件**: 保持在根目录 (如 `deploy.sh`, `.htaccess` 等)
## 🎯 视觉效果全面提升
### 🌊 莫兰迪配色美学
- **主题统一**: 深蓝文字 + 蓝绿背景的和谐搭配
- **层次清晰**: 从深海蓝到天空蓝的渐进色彩系统
- **质感丰富**: 玻璃质感与莫兰迪色彩的完美融合
### 📱 卡片设计升级
- **Primary卡片**: 深蓝灰主题 (`#5b778e`) - 专业稳重
- **Secondary卡片**: 浅蓝灰主题 (`#b2c5d5`) - 清新雅致
- **Accent卡片**: 薄荷绿主题 (`#b1d9d4`) - 活力自然
- **悬浮效果**: 图标从主题色变为深蓝色的优雅过渡
### ✨ 用户体验优化
- **视觉对比**: 深蓝文字在莫兰迪背景上的优秀可读性
- **情感共鸣**: 舒缓的蓝绿色调营造放松愉悦的浏览体验
- **品牌识别**: 独特的莫兰迪配色形成强烈的视觉记忆点
### 🎨 设计一致性
-**全站统一**: 所有组件使用相同的配色体系
-**玻璃质感**: 保持现代化的毛玻璃效果
-**响应式**: 在所有设备上都呈现完美效果
-**动画流畅**: 颜色过渡自然顺畅
## 🚀 部署更新
项目已重新构建完成,可以使用以下命令部署:
```bash
./deploy-full.sh
```
## 📱 兼容性
新的文字颜色在所有设备和浏览器上都表现优秀:
- **桌面端**: 完美的视觉层次和可读性
- **移动端**: 优化的对比度和清晰度
- **平板端**: 平衡的视觉效果
## 🎉 全站配色统一完成
-**主题统一**: 所有组件都使用莫兰迪配色体系
-**Navigation系统**: 导航卡片完美融入主题色彩
-**Report系统**: 技术报告页面全面升级为主题配色
-**文档完善**: 详细记录所有组件的配色方案
-**视觉一致**: 从首页到报告页的全站设计协调
-**响应式**: 所有设备上都呈现一致的美学效果
🌈 **现在您的焦七七小站拥有:**
- **专业的莫兰迪配色体系** - 和谐统一的视觉语言
- **全站一致性** - 从导航卡片到技术报告的完美融合
- **优秀的可读性** - 深蓝色文字系统提供完美对比度
- **现代化设计** - 玻璃质感 + 莫兰迪色彩的完美结合

124
docs/THEME_UPDATE.md Normal file
View File

@@ -0,0 +1,124 @@
# 🎨 主题色更新完成 - 蓝绿配色方案
根据您提供的5个颜色已成功将整个网站的主题色从莫兰蒂配色更新为清新的蓝绿色调。
## 🎯 新配色方案
### 原始颜色
您提供的5个颜色
- `#5b778e` - 深蓝灰色
- `#b2c5d5` - 淡蓝色
- `#b2c5d5` - 淡蓝色 (重复)
- `#b1d9d4` - 淡绿蓝色
- `#aecedd` - 浅蓝灰色
### 扩展配色
基于您的颜色,我创建了完整的配色系统:
```css
morandi: {
cream: '#aecedd', // ()
beige: '#b1d9d4', // 绿 ()
sage: '#b2c5d5', // (绿)
dusty: '#b2c5d5', // ()
mauve: '#7a99b0', // ( - )
clay: '#6a8ca3', // ( - )
mist: '#9bb5c8', // ( - )
stone: '#698297', // ( - )
deep: '#5b778e' // ()
}
```
## ✅ 更新的组件和文件
### 1. 配色定义文件
- `tailwind.config.mjs` - 主题色配置
- `src/layouts/BaseLayout.astro` - 背景渐变色
### 2. 页面组件
- `src/pages/index.astro` - 首页标题和文字颜色
- `src/components/Header.astro` - 页眉品牌和导航颜色
- `src/components/Footer.astro` - 页脚文字和链接颜色
### 3. 背景渐变更新
**导航页面背景**:
```css
background: linear-gradient(135deg,
#aecedd 0%, // 浅蓝灰
#b1d9d4 25%, // 淡绿蓝
#b2c5d5 50%, // 淡蓝
#9bb5c8 75%, // 雾蓝
#7a99b0 100% // 中等蓝灰
);
```
**报告页面背景**:
```css
background: linear-gradient(180deg,
#9bb5c8 0%, // 雾蓝
#698297 50%, // 石蓝
#5b778e 100% // 深蓝
);
```
## 🎨 视觉效果
### 整体色调
- **主调**: 清新的蓝绿色系
- **感觉**: 宁静、专业、现代化
- **适用**: 技术网站、个人作品集
### 渐变效果
- **浅色渐变**: 用于导航页面,营造轻松氛围
- **深色渐变**: 用于报告页面,提供专业感
- **文字颜色**: 使用深色确保可读性
### 动画和交互
- ✅ 保持了所有原有的动画效果
- ✅ 玻璃质感效果依然完美
- ✅ 悬浮和交互状态更新为新配色
- ✅ 渐变文字效果使用新的色彩组合
## 📱 响应式兼容
新配色在所有设备尺寸上都表现良好:
- **桌面端**: 完整的渐变和动画效果
- **平板端**: 优化的布局和颜色搭配
- **移动端**: 清晰的对比度和可读性
## 🚀 部署
主题色更新已完成并构建成功。要部署到生产服务器:
```bash
./deploy-full.sh
```
## 🔍 主要更新点
### 文字颜色
- 主标题: `#5b778e` (深蓝)
- 副标题: `#5b778e` (深蓝)
- 描述文字: `#698297` (石蓝)
- 链接悬浮: `#5b778e` (深蓝)
### 背景颜色
- 导航页: 浅蓝渐变 (`#aecedd``#7a99b0`)
- 报告页: 深蓝渐变 (`#9bb5c8``#5b778e`)
- 玻璃效果: 半透明白色覆盖
### 品牌元素
- Logo渐变: `#5b778e``#6a8ca3`
- 按钮颜色: 基于新配色的透明度变化
- 边框颜色: 半透明的新主题色
## 🎉 效果预览
新的蓝绿配色带来:
- 🌊 清新的海洋感
- 💎 专业的技术感
- 🎯 优秀的视觉层次
- 🔮 现代化的设计语言
整个网站现在呈现出更加宁静、专业和现代化的视觉效果!

98
docs/UPDATE_CARDS.md Normal file
View File

@@ -0,0 +1,98 @@
# 🎯 焦七七小站 - 导航页面更新完成
根据您提供的参考页面,已成功更新了 Astro 版本的导航页面内容。
## ✅ 更新内容
### 🏠 页面标题与描述
- **标题**: 焦七七小站 (添加了火箭图标 🚀)
- **副标题**: 技术服务平台
- **描述**: 整合多种自建服务,提供便捷的技术解决方案。从这里发现更多可能性!
### 🔗 服务卡片 (9个)
1. **AList 网盘**
- 图标: `fas fa-cloud`
- 链接: `http://jiao77.cn:52443`
- 描述: 整合多平台云存储的统一管理工具
2. **Q-Nas**
- 图标: `fas fa-server`
- 链接: `http://jiao77.cn:5666`
- 描述: 基于飞牛系统的nas服务
3. **nuc-Nas**
- 图标: `fas fa-database`
- 链接: `http://jiao77.cn:56661`
- 描述: 另外一个飞牛nas
4. **RAGflow 知识库**
- 图标: `fas fa-robot`
- 链接: `http://jiao77.cn:28081`
- 描述: 基于检索增强生成的知识管理系统
5. **Open WebUI**
- 图标: `fas fa-brain`
- 链接: `http://jiao77.cn:38080`
- 描述: 强大的AI交互界面
6. **技术博客**
- 图标: `fas fa-blog`
- 链接: `https://jiao77.cn:801`
- 描述: 分享技术思考和项目经验
7. **Navidrome 音乐**
- 图标: `fas fa-music`
- 链接: `http://jiao77.cn:45332`
- 描述: 个人音乐服务器
8. **Gitea**
- 图标: `fas fa-code-branch`
- 链接: `http://jiao77.cn:3012`
- 描述: 轻量级的代码托管解决方案
9. **技术报告**
- 图标: `fas fa-file-alt`
- 链接: `http://jiao77.cn/report`
- 描述: 技术报告的导航
## 🔧 技术改进
### 外部链接支持
- 自动检测外部链接 (`http://``https://`)
- 为外部链接添加 `target="_blank"``rel="noopener noreferrer"`
- 保持内部链接的默认行为
### 响应式布局
- 卡片采用3列网格布局 (桌面端)
- 移动端自动适应为单列
- 保持莫兰蒂配色和玻璃质感
### 动画效果
- 保持原有的渐入动画
- 悬浮效果和交错动画
- 卡片提升和缩放效果
## 🚀 部署
项目已重新构建完成,可以使用以下命令部署到生产服务器:
```bash
./deploy-full.sh
```
## 📱 预览
- **开发环境**: http://localhost:4321
- **生产环境**: http://jiao77.cn (部署后)
## 🎨 设计特色保持
✅ 玻璃质感背景
✅ 莫兰蒂配色方案
✅ 圆角设计元素
✅ 流畅动画效果
✅ 响应式布局
✅ 现代化UI设计
所有原有的设计特色都已保持,只是将内容替换为您的实际服务链接和描述。