Skip to content

作者信息模块

发表于 2025-08-01
更新于 2026-05-08
阅读量 加载中...

功能概述

本模块用于在文章标题上方展示作者信息卡片,包含以下核心功能:

  • 作者姓名显示
  • 作者头像展示
  • Git提交信息集成

设计目的

  1. 增强内容可信度:明确标识文章创作者
  2. 建立作者品牌:通过统一形象展示提升辨识度
  3. 版本透明化:自动关联Git提交记录
  4. 读者互动:为后续添加作者联系功能预留接口

使用指南

自动集成模式(推荐)

contributor数组中添加名字等信息

ts
{
  name: 'Jack',
  username: 'k90zz',
  mapByNameAliases: ['atomeocean jack6', 'jack6'],
},

手动配置模式

如果页面作者不是 Git 提交者,或者需要手动指定展示顺序,可以在页面 frontmatter 中添加作者信息。组件会优先读取 authors,也兼容 authorcontributors

markdown
<!-- 文章Front Matter示例 -->
authors:
  - 张三

如果作者已经存在于 contributor 数组中,直接写名称、GitHub 用户名或 mapByNameAliases 中的别名即可自动匹配头像和主页链接:

yaml
---
title: 示例文章
authors:
  - Jack
  - BellaZ0317
---

也可以在 frontmatter 中直接写完整作者信息:

yaml
---
title: 示例文章
authors:
  - name: 张三
    avatar: https://example.com/avatar.png
    link: https://example.com/profile
---

显示效果

作者信息模块示例

图:包含头像、姓名和最后更新时间的作者卡片

技术实现

  1. Git信息抓取

    • 自动获取最近提交者的user.nameuser.email
    • 通过GitHub API获取对应头像(如未本地配置)

注意事项

常见问题

Q:头像不显示怎么办?

  1. 检查Gravatar邮箱是否匹配
  2. 确认本地头像路径正确
  3. 查看控制台网络请求