如何发布一篇博文

这篇文档说明本站（Philomathesophy）如何书写与发布博文，方便你随时照着写。

博文存放在哪里

源码（可编辑的 markdown）在本地：

blog/posts/

• 无图片的文章：posts/文章名.md（单文件）
• 有图片的文章：posts/文章名/index.md + 图片放在同目录

服务器 /var/www/blog/posts/ 里的是构建产物（HTML），不能直接编辑。

文章格式（frontmatter）

每篇文章开头用 --- 包裹的 frontmatter 定义元信息：

---
title: 文章标题
date: 2026-08-01
categories: [Python]
description: 一句话摘要，会显示在首页卡片上
---

# 正文从这里开始

字段	必填	说明
title	✅	文章标题（也是页面大标题）
date	✅	日期，格式 YYYY-MM-DD，决定排序
categories	✅	分类，一篇文章可多个：[Python, PyQt5]
description	可选	摘要，首页/分类卡片显示
draft	可选	draft: true 表示草稿，首页不显示

现有分类：Python、PyQt5、算法、阅读、技术杂谈、网络爬虫、音频编解码、日隙随笔、思考、随笔

支持的语法

普通 Markdown

## 二级标题

**粗体**、*斜体*、[链接](https://example.com)、~~删除线~~

> 引用块

代码块

```python
def hello():
    print("世界，你好")
```

数学公式

KaTeX 渲染，行内公式 $E=mc^2$，块公式：

$$\int_0^\infty e^{-x^2}\,dx = \frac{\sqrt{\pi}}{2}$$

图片

图片放在文章同目录，相对路径引用：

![示意图](./image.png)

发布流程

# 1. 本地预览（可选）
cd blog
npm run dev        # 打开 http://localhost:5173

# 2. 构建
npm run build

# 3. 上传服务器
scp -r .vitepress\dist ops@139.199.70.119:/tmp/deploy/

# 4. 替换服务器内容
ssh ops@139.199.70.119 "sudo rm -rf /var/www/blog/* && sudo cp -r /tmp/deploy/dist/* /var/www/blog/ && sudo rm -rf /tmp/deploy"

注意事项

• 写草稿时加 draft: true，预览满意后去掉再发布
• 图片记得放同一目录，用相对路径引用
• 分类尽量沿用现有分类，便于归档整理
• 文章写好后刷新首页即可看到新文章出现在列表顶部