Skip to content

添加新文章指南 ​

需要修改的地方 ​

以在 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-DD
  • tags — 标签列表,用于标签页分类筛选

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 使用同一构建入口,校验失败会阻止本次部署。发布后仍需核查线上旧页面、旧资源及历史部署地址;仓库公开的文件不因网站隔离而变为私密。

Last updated: