把一篇文章发布到这里

这是一篇示例使用说明。项目的完整操作说明位于源码目录的 README.md。

新建内容文件

在 src/content/writings/ 下建立文章文件夹，正文保存为 index.md。图片可以放在同一文件夹，通过相对路径引用。

文件夹用于整理文件；正式文章地址由 frontmatter 中的 slug 决定。

填写文章信息

---
title: "我的第一篇文章"
slug: my-first-writing
description: "用一句话说明这篇文章讨论什么。"
publishedAt: "2026-10-16"
category: technology
tags: [写作]
draft: true
---

category 可以选择 technology、literature、philosophy 或 essays。准备公开时，将 draft 改为 false。

文章修改后，可以填写 updatedAt。日期采用 YYYY-MM-DD 格式。

本地预览

在源码目录执行：

pnpm dev

草稿可以通过自己的文章地址在开发服务器中查看，列表仍只显示已经公开的文章。

构建与检索

pnpm build
pnpm preview

构建先检查类型与元数据，再生成静态页面和全文搜索索引。搜索需要在构建预览中验证。

生产构建不会生成草稿文章页面，也不会把草稿放进搜索索引。

MDX 与图片

需要在正文中使用组件时，将文件扩展名改为 .mdx，文章地址仍由 slug 决定。当前这篇说明使用 MDX，下面的图片由导入的 Astro Image 组件渲染：

普通文章继续使用 Markdown 即可。数学公式、代码、引用和目录由两种格式共用的处理配置生成。

视频与外部资源

公开的视频可以使用标准 HTML 播放器；大文件放在独立资源存储，通过公开地址引用：

<video controls preload="metadata" playsinline aria-label="演示视频">
  <source src="https://媒体域名/演示.mp4" type="video/mp4" />
  <track kind="captions" src="https://媒体域名/字幕.vtt" srclang="zh" label="中文字幕" />
  你的浏览器无法播放该视频。
</video>

发布前填写真实资源地址，并提供字幕或文字说明。未公开的创作资料保存在仓库之外；draft 是发布状态，不是私密资料的访问控制。

系列与专题

在 src/content/series.json 中填写合集标题、摘要及文章 slug 列表。文章保持一份，合集按引用显示；系列按清单顺序阅读，专题用于汇集共同主题。

后续公开发布

GitHub 与 Cloudflare 的账户绑定将在后续完成。正式域名确定后，配置 SITE_URL，即可在构建时生成 canonical、sitemap 与 RSS。