PageLastCommit

概述

PageLastCommit 组件用于显示当前文档页面的最后更新信息，包括：

• 更新时间：文件最后一次提交的时间
• 作者信息：提交者的 GitHub 用户名（可点击跳转）
• 提交信息：最后一次提交的 commit message（可点击跳转到具体 commit）

该组件已内置于文档页面的页头区域，无需手动添加。

效果展示

组件会在页面描述下方显示类似以下内容：

最后更新于 2025/11/26 14:37 由 mhaibaraai 提交 docs: 完善文档内容并新增模板说明

前置要求

1. GitHub Token 配置

在 .env 文件中配置 GitHub Personal Access Token：

NUXT_GITHUB_TOKEN=ghp_your_personal_access_token_here

2. GitHub 配置

确保在 app.config.ts 中正确配置了 GitHub 相关信息：

export default defineAppConfig({
  github: {
    rootDir: 'docs', // 文档所在目录
  }
})

自定义日期格式

通过 dateFormat 配置可以自定义日期显示格式：

export default defineAppConfig({
  github: {
    rootDir: 'docs',
    dateFormat: {
      locale: 'zh-CN',
      options: {
        year: 'numeric',
        month: 'numeric',
        day: 'numeric',
        hour: '2-digit',
        minute: '2-digit'
      }
    }
  }
})

常用日期格式示例

PR Squash Merge 支持

组件智能处理 GitHub 的 PR squash merge 场景：

• 当检测到提交者是 web-flow（GitHub 自动合并机器人）时
• 自动解析 commit message 中的 PR 编号（如 #123）
• 获取实际的 PR 作者信息并显示

API

Props

Changelog