内容管理
博客发布
编写双语 MDX 文章，添加封面，并在博客中检查效果。
通过应用 content/posts/ 文件发布文章。先创建一对中英文内容，再检查列表和文章页面。
开始前准备
运行开发服务，准备标题、描述、日期、分类和可选封面。文件路径相对于当前应用根目录。
1. 创建中英文文章
创建 content/posts/first-post.zh.mdx：
---
title: 我们的第一次发布
description: 我们在做什么，为谁解决问题。
date: "2026-10-12"
categories: ["Product"]
published: true
---
欢迎使用我们的产品，这里是你现在可以做的事。
## 开始使用
介绍读者可以完成的第一个有用操作。创建 first-post.en.mdx，用相同字段填写英文。文件名前缀和发布日期保持一致。正文使用 MDX，丰富内容块 提供 Callout、Cards 和 Steps 示例。
2. 添加封面
将图片放在应用 public/images/blog/，在两份文章添加 image: /images/blog/your-cover.png。为元数据填写清晰标题和描述。
3. 打开博客
打开 /blog 和另一语言博客 URL，找到标题并进入文章。dev/build 自动生成内容源；类型缺失时启动开发服务或运行当前应用的构建命令。
确认结果
- 列表显示文章日期、分类和可选封面。
- 每种语言进入对应翻译文章。
- 标题层级、图片、正文块和元数据正确。
- 运行当前应用的构建命令；双应用产品还需
pnpm apps:parity并同步正文。
常见问题
| 问题 | 处理方式 |
|---|---|
| Frontmatter 校验失败 | 使用下方字段，日期为 ISO 字符串 |
| 封面打不开 | 图片放所选应用 public/，使用根相对 URL |
| 列表没有文章 | 检查 published 和语言文件名 |
| 草稿 URL 仍能访问 | published=false 只移出列表/站点地图，不限制正文访问；私有草稿不放部署内容目录 |
字段参考
| 字段 | 值 |
|---|---|
title | 文章标题 |
description | 可选元数据描述 |
date | 必填 ISO 日期字符串 |
image | 可选封面 URL |
categories | 字符串数组，默认空 |
published | 布尔值，默认 true |
Schema 在应用 source.config.ts，src/lib/blog-source.ts 构建语言 URL，src/components/mdx.tsx 映射内容块。改变行为时再修改这些文件。付费/私有正文需要服务端认证与权益校验，默认博客不提供付费正文门禁。