大家好！祝大家新年快乐 🎉 并祝 2024 年一切顺利！我们很高兴宣布 AstroPaper v4 的发布，这是一次重大更新，引入了一系列新功能、改进和错误修复，以提升您的博客体验。非常感谢所有贡献者的宝贵意见和努力，使版本 4 成为可能！
目录
主要变化
升级到 Astro v4 #202
AstroPaper 现在利用 Astro v4 的强大功能和能力。但是，这是一次微妙的升级，不会破坏大多数 Astro 用户。
用 Astro Content slug 替换 postSlug #197
博客内容架构中的 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，该博客文章的标题将被 slugified 并用作 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 环境现在比以往任何时候都容易，简化了部署和配置。
重构和错误修复
用非 Slugified 标签名称替换 Slugified 标题 #198
为了提高清晰度、用户体验和 SEO，标签页面中的标题（Tag: some-tag）不再被 slugified（Tag: Some Tag）。
为最小高度实现 100svh (79d569d)
我们更新了 body 上的 min-height 以使用 100svh，为移动用户提供更好的 UX。
将站点 URL 更新为单一事实来源 #143
站点 URL 现在是单一事实来源，简化配置并避免不一致。在此 PR 及其相关问题中阅读更多信息。
解决浅色模式下不可见的文本代码块问题 #163
我们修复了浅色模式下不可见的文本代码块问题。
在面包屑中解码 Unicode 标签字符 #175
面包屑中 Tag 的最后一部分现在已解码，使非英语 Unicode 字符显示得更好。
更新 LOCALE 配置以覆盖整体语言环境 (cd02b04)
LOCALE 配置已更新以涵盖更广泛的语言环境，迎合更多样化的受众。
结尾
我们相信这些更新将显著提升您的 AstroPaper 体验。感谢为 AstroPaper 做出贡献、解决问题并给 AstroPaper 点赞的每一个人。我们期待看到您使用 AstroPaper v4 创建的精彩内容！
快乐博客！
Sat Naing
AstroPaper 创建者