在这篇文章中，我将解释如何使用 pre-commit Git hook 来自动设置 AstroPaper 博客主题前置元数据中的创建日期（pubDatetime）和修改日期（modDatetime）。
目录
让它们无处不在
Git hooks 非常适合自动化任务，比如添加或检查分支名称到你的提交消息中，或者防止你提交明文密码。它们最大的缺点是客户端钩子是按机器设置的。
你可以通过创建一个 hooks 目录并手动将它们复制到 .git/hooks 目录或设置符号链接来解决这个问题，但这都需要你记住去设置它，而这不是我擅长做的事情。
由于这个项目使用 npm，我们可以使用一个叫做 Husky（这已经在 AstroPaper 中安装）的包来自动为我们安装钩子。
更新！在 AstroPaper v4.3.0 中，pre-commit 钩子已被移除，改用 GitHub Actions。但是，你可以轻松地自行安装 Husky。
钩子
由于我们希望这个钩子在我们提交代码时运行以更新日期，并将其作为我们更改的一部分，我们将使用 pre-commit 钩子。这已经在 AstroPaper 项目中设置好了，但如果没有，你可以运行 npx husky add .husky/pre-commit 'echo "This is our new pre-commit hook"'。
导航到 hooks/pre-commit 文件，我们将添加以下一个或两个代码片段。
当文件被编辑时更新修改日期
pubDatetime: 2025-03-23T00:24:42+08:00
更新：
这部分已经更新为一个更智能的钩子版本。现在它在文章发布之前不会增加 modDatetime。在第一次发布时，将草稿状态设置为 first，然后观察魔法发生。
pubDatetime: 2025-03-23T00:24:42+08:00
# 修改的文件，更新 modDatetime
git diff --cached --name-status |
grep -i '^M.*\.md$' |
while read _ file; do
filecontent=$(cat "$file")
frontmatter=$(echo "$filecontent" | awk -v RS='---' 'NR==2{print}')
draft=$(echo "$frontmatter" | awk '/^draft: /{print $2}')
if [ "$draft" = "false" ]; then
echo "$file modDateTime updated"
cat $file | sed "/---.*/,/---.*/s/^modDatetime:.*$/modDatetime: $(date -u "+%Y-%m-%dT%H:%M:%SZ")/" > tmp
mv tmp $file
git add $file
fi
if [ "$draft" = "first" ]; then
echo "First release of $file, draft set to false and modDateTime removed"
cat $file | sed "/---.*/,/---.*/s/^modDatetime:.*$/modDatetime:/" | sed "/---.*/,/---.*/s/^draft:.*$/draft: false/" > tmp
mv tmp $file
git add $file
fi
donegit diff --cached --name-status 获取已暂存准备提交的文件。输出看起来像：
A src/content/blog/setting-dates-via-git-hooks.md开头的字母表示采取了什么操作，在上面的例子中，文件已被添加。修改的文件有 M。
我们将该输出通过管道传递到 grep 命令，在那里我们查找每一行以找到已被修改的文件。该行需要以 M 开头（^(M)），后面可以有任意数量的字符（.*），并以 .md 文件扩展名结尾（.(md)$）。这将过滤掉不是修改过的 markdown 文件的行 egrep -i "^(M).*\.(md)$"。
pubDatetime: 2025-03-23T00:24:42+08:00
改进 - 更明确
可以添加只查找 blog 目录中的 markdown 文件，因为这些是唯一具有正确前置元数据的文件。
pubDatetime: 2025-03-23T00:24:42+08:00
正则表达式将捕获两个部分，字母和文件路径。我们将把这个列表通过管道传递到 while 循环中，以遍历匹配的行，并将字母分配给 a，将路径分配给 b。我们暂时忽略 a。
要知道文件的草稿状态，我们需要它的前置元数据。在下面的代码中，我们使用 cat 获取文件内容，然后使用 awk 在前置元数据分隔符（---）处分割文件，并取第二个块（前置元数据，即 --- 之间的部分）。从这里我们再次使用 awk 来找到 draft 键并打印其值。
filecontent=$(cat "$file")
frontmatter=$(echo "$filecontent" | awk -v RS='---' 'NR==2{print}')
draft=$(echo "$frontmatter" | awk '/^draft: /{print $2}')现在我们有了 draft 的值，我们将做以下三件事之一：将 modDatetime 设置为现在（当 draft 为 false 时 if [ "$draft" = "false" ]; then），清除 modDatetime 并将 draft 设置为 false（当 draft 设置为 first 时 if [ "$draft" = "first" ]; then），或者什么都不做（在任何其他情况下）。
下一部分的 sed 命令对我来说有点神奇，因为我不经常使用它，它是从另一篇关于做类似事情的博客文章中复制的。本质上，它在文件的前置元数据标签（---）内查找 pubDatetime: 键，获取整行并用 pubDatetime: $(date -u "+%Y-%m-%dT%H:%M:%SZ")/" 相同的键和正确格式的当前日期时间替换它。
这个替换是在整个文件的上下文中进行的，所以我们把它放到一个临时文件中（> tmp），然后我们将（mv）新文件移动到旧文件的位置，覆盖它。然后将其添加到 git 中，准备提交，就好像我们自己做了更改一样。
pubDatetime: 2025-03-23T00:24:42+08:00
注意
为了让 sed 工作，前置元数据中需要已经有 modDatetime 键。要让应用程序使用空日期构建，你需要进行一些其他更改，请参见下文。
pubDatetime: 2025-03-23T00:24:42+08:00
为新文件添加日期
为新文件添加日期的过程与上面相同，但这次我们要查找已添加的行（A），并且我们要替换 pubDatetime 值。
# 新文件，添加/更新 pubDatetime
git diff --cached --name-status | egrep -i "^(A).*\.(md)$" | while read a b; do
cat $b | sed "/---.*/,/---.*/s/^pubDatetime:.*$/pubDatetime: $(date -u "+%Y-%m-%dT%H:%M:%SZ")/" > tmp
mv tmp $b
git add $b
donepubDatetime: 2025-03-23T00:24:42+08:00
改进 - 只循环一次
我们可以在循环中使用 a 变量来切换，在一个循环中更新 modDatetime 或添加 pubDatetime。
pubDatetime: 2025-03-23T00:24:42+08:00
填充前置元数据
如果你的 IDE 支持代码片段，那么可以创建一个自定义代码片段来填充前置元数据。AstroPaper v4 将默认为 VSCode 提供一个。
空 modDatetime 更改
为了让 Astro 编译 markdown 并完成其工作，它需要知道前置元数据中预期的内容。它通过 src/content/config.ts 中的配置来实现这一点。
要允许键存在但没有值，我们需要编辑第 10 行以添加 .nullable() 函数。
const blog = defineCollection({
type: "content",
schema: ({ image }) =>
z.object({
author: z.string().default(SITE.author),
pubDatetime: z.date(),
- modDatetime: z.date().optional(),
+ modDatetime: z.date().optional().nullable(),
title: z.string(),
featured: z.boolean().optional(),
draft: z.boolean().optional(),
tags: z.array(z.string()).default(["others"]),
ogImage: image().or(z.string()).optional(),
description: z.string(),
canonicalURL: z.string().optional(),
readingTime: z.string().optional(),
}),
});为了防止 IDE 在博客引擎文件中报错，我还做了以下更改：
- 在
src/layouts/Layout.astro的第 15 行添加| null，使其看起来像这样：
export interface Props {
title?: string;
author?: string;
description?: string;
ogImage?: string;
canonicalURL?: string;
pubDatetime?: Date;
modDatetime?: Date | null;
}- 在
src/components/Datetime.tsx的第 5 行添加| null，使其看起来像这样：
interface DatetimesProps {
pubDatetime: string | Date;
modDatetime: string | Date | undefined | null;
}