大家好!祝大家新年快乐 🎉,祝 2024 年一切顺利!
我们很高兴地宣布 AstroPaper v4 的发布,这是一次重大更新,引入了一系列新功能、改进和错误修复,旨在提升您的博客体验。非常感谢所有贡献者的宝贵投入和努力,让版本 4 得以实现!

目录
重大变更
升级至 Astro v4 #202
AstroPaper 现在利用了 Astro v4 的强大功能和特性。不过,这是一个平滑的升级,不会破坏大多数 Astro 用户的使用。

用 Astro 内容集合的 slug 替换 postSlug #197
AstroPaper v4 的博客内容 schema 中不再提供 postSlug。最初 Astro 没有 slug 机制,因此我们必须自己解决。自从 Astro v3 以来,它支持内容集合和 slug 功能。现在,我们认为是时候采用 Astro 开箱即用的 slug 功能了。
文件: 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,该博客文章的标题将被 slug 化并用作 slug。但是,在 AstroPaper v4 中,如果未指定 slug 字段,则 markdown 文件名将被用作 slug。
需要注意的是,slug 字段可以省略,但不能是空字符串 (slug: "" ❌)。
如果您是从 v3 升级到 AstroPaper v4,请务必将 src/content/blog/*.md 文件中的 postSlug 替换为 slug。
新功能
添加用于内容创建的代码片段 #206
AstroPaper 现在包含用于新博客文章的 VSCode 代码片段,无需手动复制/粘贴前言和内容结构(目录、标题、摘要等)。在这里阅读更多关于 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 环境变得比以往任何时候都更容易,从而简化了部署和配置。
重构与错误修复
用未 slug 化的标签名称替换 slug 化的标题 #198
为了提高清晰度、用户体验和 SEO,标签页面中的标题(Tag: some-tag)不再进行 slug 化处理(Tag: Some Tag)。
实现使用 100svh 作为最小高度 (79d569d)
我们更新了 body 上的最小高度以使用 100svh,为移动端用户提供更好的用户体验。
更新站点 URL 为单一事实来源 #143
站点 URL 现在是单一事实来源,从而简化了配置并避免不一致。请阅读此 PR 及其相关问题了解更多详情。
解决浅色模式下文本代码块不可见的问题 #163
我们修复了浅色模式下文本代码块不可见的问题。
在面包屑导航中解码 Unicode 标签字符 #175
面包屑导航中标签的最后一部分现已解码,使非英语 Unicode 字符显示得更好。
更新 LOCALE 配置以涵盖整体区域设置 (cd02b04)
LOCALE 配置已更新以涵盖更广泛的区域设置,迎合更多样化的受众。
结语
我们相信这些更新将显著提升您的 AstroPaper 体验。感谢所有贡献、解决问题以及为 AstroPaper 点赞 Star 的每一个人。我们期待看到您使用 AstroPaper v4 创作的精彩内容!
祝博客写作愉快!
Sat Naing
AstroPaper 创始人