feat: 新增 QuantaNote 项目展示,重构项目卡片与截图浏览组件

- 新增 QuantaNote 完整项目数据(特性描述、截图、Logo)
  - 为所有项目添加 logo 和 websiteUrl 字段支持
  - 移除 stars/forks 相关展示与排序逻辑
  - ScreenshotCarousel 增加左右切换箭头和 Lightbox 全屏预览(支持键盘导航)
  - 更新项目创建文档,补充 logo 和 installGuide 配置说明
This commit is contained in:
2026-05-22 16:07:30 +08:00
parent 6b58b55c32
commit b6f15f82d8
40 changed files with 628 additions and 181 deletions
+40 -3
View File
@@ -12,7 +12,8 @@
| 2 | `src/utils/iconRegistry.ts` | 仅当使用新图标时 |
| 3 | `src/data/categories.yaml` | 仅当新增分类时 |
| 4 | `src/data/statuses.yaml` | 仅当新增状态时 |
| 5 | `public/screenshots/` | 仅当有截图时 |
| 5 | `public/logos/` | 仅当有项目 Logo 时 |
| 6 | `public/screenshots/` | 仅当有截图时 |
**核心原则:** 只需创建一个 YAML 文件,项目就会自动出现在网站上。`loader.ts` 使用 `import.meta.glob('./projects/*.yaml')` 自动扫描该目录,无需手动注册。
@@ -101,6 +102,11 @@ tags:
# 如果需要新图标,见"步骤二"
icon: 'Terminal'
# 项目 Logo 图片(可选,支持 SVG/PNG/JPG
# 图片放在 public/logos/ 目录下,路径相对于 public 目录
# 若设置了 logo,卡片和详情页会优先展示 Logo 图片,否则回退到上面的 lucide 图标
# logo: '/logos/my-new-app.png'
# GitHub 仓库地址(必须)
repoUrl: 'https://github.com/shenjianZ/my-new-app'
@@ -115,8 +121,6 @@ docsUrl: 'https://github.com/shenjianZ/my-new-app#readme'
latestVersion: 'v1.0.0'
releaseDate: '2026-05-22'
license: 'MIT'
stars: 10
forks: 2
language: 'TypeScript'
lastUpdated: '2026-05-22'
@@ -189,6 +193,39 @@ architecture:
# screenshots:
# - '/screenshots/my-new-app/main.png'
# - '/screenshots/my-new-app/settings.png'
# ========== 安装指南(可选) ==========
# 每个项目生产的安装包不同,按实际包格式填写即可
# 会以紧凑的单行提示展示在"下载安装"区域内
# 不填写则使用默认的通用安装说明
installGuide:
zh:
- platform: 'Windows'
icon: '🪟'
format: '.exe'
tip: 'SmartScreen 拦截?点击"更多信息" → "仍要运行"'
- platform: 'macOS'
icon: '🍎'
format: '.dmg'
tip: '提示已损坏?终端运行: xattr -dr com.apple.quarantine /Applications/MyApp.app'
- platform: 'Linux'
icon: '🐧'
format: '.AppImage'
tip: 'chmod +x MyApp-*.AppImage && ./MyApp-*.AppImage'
en:
- platform: 'Windows'
icon: '🪟'
format: '.exe'
tip: 'SmartScreen blocked? Click "More info" → "Run anyway"'
- platform: 'macOS'
icon: '🍎'
format: '.dmg'
tip: '"Damaged" error? Run: xattr -dr com.apple.quarantine /Applications/MyApp.app'
- platform: 'Linux'
icon: '🐧'
format: '.AppImage'
tip: 'chmod +x MyApp-*.AppImage && ./MyApp-*.AppImage'
```
---