页面元数据

主题通过 @vuepress/plugin-git 插件在页面底部显示页面的最后更新时间与贡献者，并提供了“编辑此页”按钮的支持。

主题同时根据侧边栏配置提供上一页和下一页的导航按钮。

基于 Git 的信息

vuepress-theme-hope 通过内置 @vuepress/plugin-git 插件，实现了页面创建时间、最后更新时间与贡献者的自动生成。

插件会通过页面文件最后一次 git 提交的 UNIX 时间戳 (ms) 来自动生成页面创建时间和最后更新时间，同时根据提交记录生成贡献者。

主题将以合适的日期格式将最后更新时间显示在每一页的底部，同时显示该页面所有贡献者。

提示

主题会使用 Date.toLocaleString(pageLang) 自动根据当前语言，本地化最后更新时间的表述文字。

使用限制

1. 由于贡献者、最后更新时间以及文件创建日期基于 git , 所以你只能在一个基于 git 的项目中启用它。

2. 由于使用的时间戳来自 git commit，因此它将仅在给定页的第一次提交之后显示，并且仅在该页面后续提交更改时更新。

3. 由于 git 插件需要调用 Git 程序并且涉及文件 IO，因此此功能会对启动与热更新速度造成严重影响，所以默认情况下主题不会在开发模式下启用。如有需要，请在主题选项中设置 plugins.git: true 或 hotReload: true。

编辑此页链接

你可以通过在主题选项中中设置如下项目，来自动为每个页面生成编辑此页链接:

• docsRepo: 文档仓库地址，默认同主题选项中的 repo
• docsDir: 文档在仓库中的目录，默认为根目录
• docsBranch: 文档存放的分值，默认为 "main"

显示控制

如果你想要全局禁用这些项目的显示，请在主题选项中中，将以下对应项目设置为 false。你也可以通过 YAML front matter 中设置这些项目来启用/禁用指定页面:

• lastUpdated: 是否显示页面最后更新时间
• contributors: 是否显示页面贡献者
• editLink: 是否展示编辑此页链接