恭学教育官网

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

修改站点域名

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

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

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

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

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。

文件内容参考如下：

---
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 文件中：

[
  {
    "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	各篇文章详情页

本地开发

npm install
npm run dev

构建

npm run build