博客操作指南

老Z2026/2/21大约 2 分钟

开发命令

# 启动开发服务器
pnpm run dev

# 构建生产版本
pnpm run build

开发服务器地址：http://localhost:8080

添加文章

在 docs/_posts/ 目录下创建 Markdown 文件。

文章格式

---
title: 文章标题
date: 2026-02-21
categories:
  - 分类名称
tags:
  - 标签1
  - 标签2
author: 老Z
---

## 章节标题

文章内容...

<!-- more -->

更多内容...

Frontmatter 字段

字段	必填	类型	说明
title	是	string	文章标题
date	是	string	发布日期（YYYY-MM-DD）
categories	是	string[]	分类
tags	是	string[]	标签
author	否	string	作者

摘要分割

 之前的内容作为文章摘要，在列表页显示。

部署流程

配置修改

导航栏

编辑 docs/.vuepress/config.ts：

navbar: [
  { text: '首页', link: '/' },
  { text: '文章', link: '/posts/' },
  { text: '分类', link: '/category/' },
  { text: '标签', link: '/tag/' },
  { text: '时间线', link: '/timeline/' },
  { text: '关于我', link: '/about/' },
]

网站信息

export default defineUserConfig({
  title: '网站标题',
  description: '网站描述',
})

theme: hopeTheme({
  author: { name: '作者名' },
  logo: '/logo.svg',
  footer: '页脚内容',
})