chore: 初始化项目仓库

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-31 21:27:39 +08:00
commit b7addb5c7a
50 changed files with 15964 additions and 0 deletions
@@ -0,0 +1,73 @@
+# Sublog - Nuxt 3 博客
+
+基于 Nuxt 3 的静态博客站点，使用 @nuxt/content 管理 Markdown 文章。
+
+## 技术栈
+
+- **Nuxt 3** - Vue 3 全栈框架
+- **@nuxt/content** - Markdown 内容管理
+- **Tailwind CSS** - 样式框架
+- **TypeScript** - 类型安全
+- **Giscus** - GitHub Discussions 评论系统
+
+## 开发
+
+### 启动开发服务器
+
+```bash
+npm run dev
+```
+
+### 构建静态站点
+
+```bash
+npm run generate
+```
+
+构建产物输出到 `.output/public`，文章图片会自动复制。
+
+### 预览构建结果
+
+```bash
+npm run preview
+```
+
+## 新建文章
+
+```bash
+npm run new-post <slug>
+```
+
+会在 `content/posts/<slug>/` 下创建 `index.md` 和 `img/` 目录。
+
+## 项目结构
+
+```
+├── config/site.ts          # 站点配置（改这一个文件定制全站）
+├── content/posts/           # Markdown 文章
+│   └── <slug>/
+│       ├── index.md         # 文章内容
+│       └── img/             # 文章图片
+├── components/
+│   ├── layout/              # 布局组件（NavBar, Footer）
+│   └── blog/                # 博客组件（PostCard, PostToc, Giscus）
+├── composables/             # 组合式函数
+├── pages/                   # 页面路由
+├── layouts/                 # 布局模板
+├── server/routes/           # API 路由
+└── utils/                   # 工具函数
+```
+
+## 配置
+
+站点信息集中在 `config/site.ts`：
+
+- 站点名称、描述、关键词
+- 头像、favicon
+- 社交链接
+- 导航菜单
+- Giscus 评论配置
+
+## 部署
+
+构建后将 `.output/public` 目录部署到任意静态托管服务（Vercel、Netlify、Cloudflare Pages 等）。