贡献指南复制锚点链接

欢迎参与武大漫协站点的建设！本页面整合了投稿与维护所需的全部信息。

本站是使用 Next.js 与 Fumadocs 搭建的静态站，定位为社团历史活动与资料的保存库。它将 MDX 文本转换为静态网页，让你专注于内容撰写而非网页设计。MDX 支持常用的 Markdown 标记，也可以使用 React 组件；普通文章只要会基本的 Markdown 标记即可投稿。

我们希望收到什么复制锚点链接

我们希望各位添加的是有意义的材料。以下类型的投稿不会通过：

• 照搬群头像和群介绍（#26）
• 到此一游或测试信息（#3、#5）

本地部署复制锚点链接

1. fork 该仓库，然后克隆你的 fork 到本地
2. 安装 node.js（建议 24+，与 CI 一致）与 pnpm
3. 运行 pnpm install 安装依赖
4. 运行 pnpm dev 启动本地服务器，默认地址 http://localhost:3000/
5. 保存修改后，开发服务器会自动刷新页面；修改配置后按需重启 pnpm dev

提交前建议运行 pnpm build 确认能构建通过——构建会做死链检查，任何失效的站内链接都会导致构建失败（详见下方链接规范）。

目录与资源约定复制锚点链接

• 内容：MDX 文件（.mdx）放在 docs/<区域>/ 下（如 docs/activity/、docs/group/）
• 资源：图片等静态资源放在 public/ 的对应镜像目录下。例如 2024 冬日祭的图片放在 public/activity/2024/，页面里用绝对路径 /activity/2024/xxx.jpg 引用（public 即站点根目录）
• 学年：涉及年份的文件夹均为学年。如 2024 表示 2024 学年（2024.6–2025.6），与社团干部任期一致

新增页面复制锚点链接

新建一个 .mdx 文件后，需要把它登记到侧边栏才会出现在导航里。侧边栏在 lib/navigation.json 的 sidebar 中手动配置。找到对应区域（如 /activity/），在 items 里按现有写法追加一项即可。页面顶部的 frontmatter 需填写 title；正文继续保留一级标题。

新增内容时，参考同区域已有的页面是最快的方式，例如：

• 活动页：参考 docs/activity/2024/winter-festival.mdx
• 成员卡：参考 docs/activity/2025/welcome-party/credits.mdx
• 留声箱：参考 docs/message-box/quq/words.mdx

链接规范复制锚点链接

站内链接一律使用以 / 开头的绝对路径（如 /group/ani-key/），不要用相对路径。相对路径在嵌套目录下容易解析错误，且会触发构建期的死链检查导致部署失败。

自定义组件复制锚点链接

本站在 MDX 中注册了 React 组件，可直接使用 ChatMessage、MemberCard 和 TeamMembers 等。数据通过 @/lib/people 引入；页面中的顶层变量须写成 export const。JSX 属性使用 className 和 avatar={avatarOf('成员名称')}，对象、数组使用花括号。原生 HTML 的空元素需闭合，例如 <br /> 和 <img src="/example.jpg" alt="说明" />。

人员与头像注册表复制锚点链接

所有人员的数据统一登记在 lib/people.js 里，主要有两个作用：

1. 统一头像：页面通过 avatarOf('成员名称') 取头像，避免在多个页面里重复硬编码 URL。
2. 贡献者匹配：作为页面历史与贡献者数据的数据源。由于同一个贡献者在不同机器上的 Git 名字/邮箱可能不同，通过在这里设置别名，可以将错乱的提交记录合并到同一个人名下。

新增或完善成员数据时，在 people.js 里修改：

'-QuQ-': { 
  avatar: '/avatars/-QuQ-.jpeg', 
  github: 'shenxianovo', 
  mapByNameAliases: ['shenxianovo'], 
  mapByEmailAliases: ['shenxianovo@gmail.com', 'shenxianovo@outlook.com'] 
},
'九尾晨': { avatar: QQ('1540104836') },  // 如果只是普通成员（没有参与网站代码/文档维护），只需头像即可

• 本地头像：图片放在 public/avatars/<成员名>.jpg，写 '/avatars/<成员名>.jpg'
• QQ 头像：直接 QQ('你的QQ号')，模块顶部已有 QQ helper
• Github / Git 邮箱设定（仅对代码/文档提交者需要）：根据提交历史中的 Author 和 Email 配置 mapByNameAliases / mapByEmailAliases，让页面历史归拢记录。

页面历史和贡献者由 fumadocs-page-history 显示。注册表的键名是站内显示名称，github 只决定 GitHub 个人主页链接；例如上面的配置会显示 -QuQ-，点击后打开 shenxianovo 的主页。修改键名即可修改显示名称，同时应更新页面中 avatarOf / memberOf 的对应引用。姓名与邮箱别名只在构建期参与匹配，不会传给浏览器。

注册表里没有的名字会回落到默认占位头像（PLACEHOLDER_AVATAR）。

ChatMessage 对话气泡复制锚点链接

用于呈现聊天记录式的对话（参考 docs/about/introduction.mdx）。

import { avatarOf } from '@/lib/people'

<ChatMessage avatar={avatarOf('')} nickname="萌新一枚" message="为什么漫协要叫WHUDAYS呢？" position="right"/>
<ChatMessage avatar={avatarOf('店长')} nickname="店长" message="这都怪当年某管理的恶趣味……"/>

MemberCard 成员卡片复制锚点链接

用于展示成员/群友信息卡（参考 docs/group/vocaloid-utau-fans/index.mdx）。

import { avatarOf } from '@/lib/people'

<div className="member-grid">
  <MemberCard
    name="示例成员"
    avatar={avatarOf('示例成员')}
    description="一句话简介"
    link=""
    badges={[{ type: 'tip', text: '管理员' }, { type: 'warning', text: '创作者' }]}
    socials={[{ platform: 'github', url: 'https://github.com/xxx', icon: '/group/vocaloid-utau-fans/members/sns/github.svg' }]}
  />
</div>

提交与合并复制锚点链接

1. commit 时请尽量用中文填写有意义的 Commit Message。不确定怎么写可参考提交记录
2. 记得移除 AI 协作者的 Co-Authors（见上方关于 AI 协作）
3. 本项目通过 Pull Request 合并。请确保 pnpm build 能通过后再提交