撰写博文

我的博文要放在哪里?

你的博文的 Markdown 文档需要放置在 src/content/blog 目录下。

博文的 Front-matter 属性

在撰写博文时,你将需要对博文的 Front-matter 属性进行配置,来声明博文的标题、发布时间等信息。下面是可以配置的属性:

属性名类型必填项说明
title字符串文章标题,用于指定文章的标题。
description字符串文章简介。如果不指定,则简介会根据文章内容自动生成。
pubDate日期文章发布日期,支持 ISO8601 时间戳格式。
updatedDate日期文章修改日期,支持 ISO8601 时间戳格式。
heroImage字符串文章的主题图片,用于在 Open Graph 中显示。
draft布尔值文章为草稿,如果设置为 true,则文章不会被发布。
unlisted布尔值文章在博文列表和 RSS 不可见,但可以通过链接访问。示例

通过在文章的 Front-matter 中设置这些属性,你可以控制文章的显示、发布状态以及其他元数据信息。例如,你可以将文章标记为草稿,或者设置文章的发布和更新日期,以便正确地管理和展示你的内容。

下面是这篇博文的 Front-matter 信息:

---
title: '撰写博文'
description: '在使用 Koi 模板的博客撰写博文,你需要注意的事情'
pubDate: '2024-02-25'
---

(后略)

我想自己增加额外的属性

你可以直接修改 src/content/config.ts,手动增加需要的属性信息。更多可以参阅 Astro 的官方文档