74 lines
1.7 KiB
Markdown
74 lines
1.7 KiB
Markdown
# 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 等）。
|