文章模板使用说明

模板位置

文章模板保存在源码仓库里：

docs/post-template.md

新建文章时，复制这个模板到文章目录：

cd /home/ubuntu/blog
cp docs/post-template.md src/content/posts/my-new-post.md

文件名建议只使用小写英文、数字和短横线，例如：

server-maintenance-note.md

基本结构

每篇文章都由两部分组成：头部元信息和正文。

---
title: 文章标题
description: 用一句话说明这篇文章解决什么问题
pubDate: 2026-06-18
tags:
  - note
  - blog
---

正文内容写在这里。

title 会显示为文章标题，description 会显示在首页文章列表里，pubDate 用于排序，tags 用于分类提示。

草稿模式

如果文章还没写完，不想出现在博客首页，可以加上：

draft: true

要发布时，删除这一行，然后重新构建发布。

推荐写作结构

一般文章可以按这个顺序写：

1. 背景：为什么写这篇文章。
2. 正文：核心内容和说明。
3. 操作步骤：可以直接复制执行的命令。
4. 结果：完成后应该看到什么。
5. 备注：后续维护注意事项。

这种结构适合技术笔记、服务器维护记录和教程文章。

写完后的发布流程

cd /home/ubuntu/blog
npm run build
sudo rsync -a --delete dist/ /var/www/html/

构建成功后再同步线上目录，避免把错误页面发布出去。