主题
添加新文章指南
需要修改的地方
以在 src/notes/vue/ 下新增一篇 pinia-guide.md 为例:
1. 创建文章文件
新建 src/notes/vue/pinia-guide.md:
markdown
---
publish: true
title: Pinia 入门指南
date: 2026-05-16
tags: [Vue, Pinia, 状态管理]
---
# Pinia 入门指南
正文内容...Frontmatter 必填字段:
title— 文章标题date— 日期格式YYYY-MM-DDtags— 标签列表,用于标签页分类筛选
2. 更新侧边栏配置
.vitepress/config.js — 在 sidebar 中添加导航项:
js
{
text: 'Vue',
items: [
{ text: '响应式原理', link: '/notes/vue/reactivity' },
{ text: 'Pinia 入门指南', link: '/notes/vue/pinia-guide' }, // 新增
],
},总结
| 文件 | 修改内容 |
|---|---|
src/notes/vue/pinia-guide.md | 新建,文章主体 |
.vitepress/config.js | 添加侧边栏导航项 |
分类入口页使用 CategoryList 自动生成文章列表,不需要修改 src/notes/vue/index.md。
发布边界
只有 src/ 存放准备公开的网站内容,草稿放在仓库根目录的 drafts/(该目录不保证 Git 私密性)。每个页面必须在 frontmatter 中显式声明 publish: true 和 title;文章还必须有有效的 YYYY-MM-DD 日期及非空 tags 数组。缺少声明或声明为 false 会阻止构建,不能靠前端隐藏草稿。
scripts/publication.js 在配置加载时检查页面、静态资源、符号链接和导航,在构建结束时核对 HTML 页面集合与产物类型。首页、分类、标签共用的文章加载器也检查同一发布规则。src/public/ 仅允许图片、字体、音视频;文档下载需先明确扩展资源策略。禁止通过导入、Markdown include 或代码片段引用未批准公开的内容,公开目录不是代码沙箱。
运行 npm test 验证发布边界,再运行 npm run build。Vercel 使用同一构建入口,校验失败会阻止本次部署。发布后仍需核查线上旧页面、旧资源及历史部署地址;仓库公开的文件不因网站隔离而变为私密。