大家好！祝大家新年快乐 🎉，2024 年万事如意！我们很高兴宣布 AstroPaper v4 的发布，这是一次重大更新，引入了一系列新功能、改进和 Bug 修复，旨在提升你的博客体验。非常感谢所有贡献者为版本 4 的实现所付出的宝贵贡献和努力！
目录
重大变更
升级到 Astro v4 #202
AstroPaper 现在充分利用了 Astro v4 的强大功能和特性。不过，这是一次细微的升级，不会影响大多数 Astro 用户。
用 Astro Content slug 替换 postSlug #197
博客内容 Schema 中的 postSlug 在 AstroPaper v4 中不再可用。最初 Astro 没有 slug 机制，因此我们必须自行解决。自 Astro v3 起，它支持内容集合和 slug 功能。现在，我们认为是时候采用 Astro 开箱即用的 slug 功能了。
file: src/content/blog/astro-paper-4.md
---
author: Sat Naing
pubDatetime: 2024-01-01T04:35:33.428Z
title: AstroPaper 4.0
slug: "astro-paper-v4" # 如果未指定 slug，则将使用 'astro-paper-4'（文件名）
# slug: "" ❌ 不能为空字符串
---slug 的行为现在略有不同。在 AstroPaper 的早期版本中，如果博客文章（markdown 文件）中未指定 postSlug，该文章的标题将被 slugify 化并用作 slug。然而，在 AstroPaper v4 中，如果未指定 slug 字段，markdown 文件名将被用作 slug。需要记住的一点是，slug 字段可以省略，但不能为空字符串（slug: "" ❌）。
如果你要将 AstroPaper 从 v3 升级到 v4，请务必将 src/content/blog/*.md 文件中的 postSlug 替换为 slug。
新功能
添加用于内容创建的代码片段 #206
AstroPaper 现在包含用于新博客文章的 VSCode 代码片段，无需手动复制/粘贴 frontmatter 和内容结构（目录、标题、摘要等）。
了解更多关于 VSCode 代码片段的信息，请点击此处。
在博客文章中显示修改日期 #195
通过在博客文章中显示修改日期时间，让读者了解最新更新。这不仅增强了用户对文章时效性的信任，也有助于改善博客的 SEO。
如果你对文章进行了修改，可以为其添加 modDatetime。现在，文章的排序行为略有不同。所有文章将同时按 pubDatetime 和 modDatetime 排序。如果文章同时具有 pubDatetime 和 modDatetime，其排序位置将由 modDatetime 决定。否则，仅考虑 pubDatetime 来确定文章的排序顺序。
实现返回顶部按钮 #188
通过新实现的返回顶部按钮，增强博客详情页面的用户导航体验。
在标签文章中添加分页 #201
通过在标签文章中添加分页，改善内容组织和导航，让用户更容易浏览相关内容。这确保了如果某个标签有很多文章，读者不会被所有标签相关文章淹没。
动态生成 robots.txt #130
AstroPaper v4 现在动态生成 robots.txt 文件，让你能更好地控制搜索引擎索引和网页爬取。此外，站点地图 URL 也将被添加到 robot.txt 文件中。
添加 Docker-Compose 文件 #174
通过添加 Docker-Compose 文件，管理 AstroPaper 环境现在比以往更加轻松，简化了部署和配置。
重构与 Bug 修复
用非 Slugify 化标签名称替换 Slugify 化标题 #198
为了提高清晰度、用户体验和 SEO，标签页面中的标题（Tag: some-tag）不再被 slugify 化（Tag: Some Tag）。
对 Min-Height 实现 100svh (79d569d)
我们将 body 上的 min-height 更新为使用 100svh，为移动端用户提供更好的体验。
将站点 URL 更新为单一可信来源 #143
站点 URL 现在作为单一可信来源，简化了配置并避免了不一致。详情请阅读此 PR 及其相关 Issue。
解决亮色模式下代码块文本不可见的问题 #163
我们已修复亮色模式下代码块文本不可见的问题。
解码面包屑中的 Unicode 标签字符 #175
面包屑中标签的最后一部分现在会被解码，使非英语 Unicode 字符显示得更好。
更新 LOCALE 配置以覆盖更广泛的区域设置 (cd02b04)
LOCALE 配置已更新，以覆盖更广泛的区域设置，满足更多样化的受众需求。
结语
我们相信这些更新将显著提升你的 AstroPaper 体验。感谢每一位贡献者、解决问题的人以及为 AstroPaper 点亮 Star 的人。我们期待看到你用 AstroPaper v4 创建出精彩的内容！
博客愉快！
Sat Naing
AstroPaper 创建者