# 恭学教育官网

基于 VitePress 构建的恭学教育官方网站。

## 修改站点域名

项目构建时通过 `SITE_URL` 环境变量指定站点域名，该域名会用于生成 `sitemap.xml`、`<link rel="canonical">` 以及 Open Graph 等 SEO 标签。

当前 `package.json` 中的 `build` 脚本已默认设置为：

```bash
SITE_URL=https://gongxue100.com vitepress build docs
```

如需切换到其他域名（例如测试环境或新域名），直接修改 `package.json` 中 `scripts.build` 的 `SITE_URL` 值即可：

```bash
SITE_URL=https://你的域名.com vitepress build docs
```

> 注意：修改域名后需重新执行 `npm run build` 才能使 sitemap 和 SEO 标签生效。

## 如何添加知识库文章

项目中的知识库文章位于 `docs/knowledge/` 目录，采用**静态 Markdown + JSON 索引**的方式管理。

### 1. 创建文章文件

在 `docs/knowledge/` 目录下新建一个 `.md` 文件，文件名即为文章 ID，例如 `my-new-article.md`。

文件内容参考如下：

```markdown
---
id: my-new-article
title: 文章标题
summary: 文章摘要，会显示在知识库列表卡片上
category: exam_policy
tags:
  - 天津专升本
  - 考试政策
author: 恭学教育
publishedAt: 2026-06-15
coverImage: https://example.com/cover.png
viewCount: 0
isTop: false
---

<script setup>
import KnowledgeDetail from '../.vitepress/theme/pages/KnowledgeDetail.vue'
</script>

<KnowledgeDetail>

这里写正文内容，支持 HTML 和 Markdown。

</KnowledgeDetail>
```

`category` 常见取值：

- `exam_policy`：考试政策
- `school_intro`：院校介绍
- `study_method`：学习方法
- `exam_guide`：备考攻略

### 2. 更新列表索引

将文章元数据追加到 `docs/knowledge/index.json` 文件中：

```json
[
  {
    "id": "my-new-article",
    "title": "文章标题",
    "summary": "文章摘要，会显示在知识库列表卡片上",
    "category": "exam_policy",
    "tags": ["天津专升本", "考试政策"],
    "coverImage": "https://example.com/cover.png",
    "author": "恭学教育",
    "publishedAt": "2026-06-15",
    "viewCount": 0,
    "isTop": false
  }
]
```

### 文件作用说明

| 文件 | 作用 |
|------|------|
| `docs/knowledge/index.md` | 知识库列表页 |
| `docs/knowledge/index.json` | 知识库列表页读取的文章数据源 |
| `docs/knowledge/*.md` | 各篇文章详情页 |

## 本地开发

```bash
npm install
npm run dev
```

## 构建

```bash
npm run build
```