添加上次修改时间

了解如何构建 remark 插件，将上次修改时间添加到 Markdown 和 MDX 文件的 frontmatter 中。使用此属性在你的页面中显示修改时间。

¥Learn how to build a remark plugin that adds the last modified time to the frontmatter of your Markdown and MDX files. Use this property to display the modified time in your pages.

秘诀

¥Recipe

Install Helper Packages

Install Day.js to modify and format times:
- npm
- pnpm
- Yarn
Terminal window
npm install dayjs
Terminal window
pnpm add dayjs
Terminal window
yarn add dayjs

Create a Remark Plugin

This plugin uses execSync to run a Git command that returns the timestamp of the latest commit in ISO 8601 format. The timestamp is then added to the frontmatter of the file.

import { execSync } from "child_process";

export function remarkModifiedTime() {
  return function (tree, file) {
    const filepath = file.history[0];
    const result = execSync(`git log -1 --pretty="format:%cI" "${filepath}"`);
    file.data.astro.frontmatter.lastModified = result.toString();
  };
}

Using the file system instead of Git

Although using Git is the recommended way to get the last modified timestamp from a file, it is possible to use the file system modified time. This plugin uses statSync to get the mtime (modified time) of the file in ISO 8601 format. The timestamp is then added to the frontmatter of the file.

import { statSync } from "fs";

export function remarkModifiedTime() {
  return function (tree, file) {
    const filepath = file.history[0];
    const result = statSync(filepath);
    file.data.astro.frontmatter.lastModified = result.mtime.toISOString();
  };
}

Add the plugin to your config

import { defineConfig } from 'astro/config';
import { remarkModifiedTime } from './remark-modified-time.mjs';

export default defineConfig({
  markdown: {
    remarkPlugins: [remarkModifiedTime],
  },
});

Now all Markdown documents will have a lastModified property in their frontmatter.

Display Last Modified Time

If your content is stored in a content collection, access the remarkPluginFrontmatter from the entry.render() function. Then render lastModified in your template wherever you would like it to appear.

---
import { CollectionEntry, getCollection } from 'astro:content';
import dayjs from "dayjs";
import utc from "dayjs/plugin/utc";

dayjs.extend(utc);

export async function getStaticPaths() {
  const blog = await getCollection('blog');
  return blog.map(entry => ({
    params: { slug: entry.slug },
    props: { entry },
  }));
}

const { entry } = Astro.props;
const { Content, remarkPluginFrontmatter } = await entry.render();

const lastModified = dayjs(remarkPluginFrontmatter.lastModified)
  .utc()
  .format("HH:mm:ss DD MMMM YYYY UTC");
---

<html>
  <head>...</head>
  <body>
    ...
    <p>Last Modified: {lastModified}</p>
    ...
  </body>
</html>

If you’re using a Markdown layout, use the lastModified frontmatter property from Astro.props in your layout template.

---
import dayjs from "dayjs";
import utc from "dayjs/plugin/utc";

dayjs.extend(utc);

const lastModified = dayjs()
  .utc(Astro.props.frontmatter.lastModified)
  .format("HH:mm:ss DD MMMM YYYY UTC");
---

<html>
  <head>...</head>
  <body>
    <p>{lastModified}</p>
    <slot />
  </body>
</html>