正在編輯「Kuke Wiki:个人主页」

每位注册用户的用户页（<code>User:你的用户名</code>）顶部都会自动生成一张个人资料卡，包含头图、头像、用户名、权限徽章、个人简介、贡献统计和最近编辑记录。

资料卡由系统自动渲染，'''不需要在用户页里写任何代码'''。头图、头像、简介这些个性化内容，通过编辑一个配置页来设置。

== 如何自定义 ==

编辑 <code>User:你的用户名/profile.json</code>（可从自己用户页上的「编辑我的资料」按钮直接进入），填入下面这样的内容：

<syntaxhighlight lang="json">
{
	"banner": "https://kuke-wiki.cn-nb1.rains3.com/图片路径.png",
	"avatar": "https://kuke-wiki.cn-nb1.rains3.com/头像.png",
	"title": "一句话头衔",
	"bio": "多行个人简介。\n换行用 \n 表示。",
	"links": [
		{ "label": "我的主页", "url": "https://example.com/" }
	]
}
</syntaxhighlight>

所有字段都是可选的，不填就用默认值。只想改简介，就只写 <code>bio</code> 一项。

== 字段说明 ==

{| class="wikitable"
! 字段 !! 说明
|-
| <code>banner</code> || 页面顶部的头图。留空使用站点默认头图。建议宽度 1200px 以上、比例接近 6:1。
|-
| <code>avatar</code> || 圆形头像。留空使用站点图标。建议正方形。
|-
| <code>title</code> || 用户名下方的一行头衔，最多 60 字。
|-
| <code>bio</code> || 个人简介，最多 400 字。用 <code>\n</code> 换行。
|-
| <code>links</code> || 自定义链接按钮，最多 4 个。每项写 <code>label</code>（按钮文字，最多 20 字）和 <code>url</code>。
|}

=== 图片从哪来 ===

<code>banner</code> 和 <code>avatar</code> 有两种写法：

* '''本站上传的文件'''：直接写文件名，例如 <code>"avatar": "我的头像.png"</code>。先通过 [[Special:Upload]] 上传。
* '''站点图床直链''': 完整的 <code>https://</code> 地址，但只接受以下来源：
** <code>kuke-wiki.cn-nb1.rains3.com</code>
** <code>kukemc-test.cn-nb1.rains3.com</code>
** <code>cdn.nlark.com</code>
** <code>m.ccw.site</code>

其它域名的图片会被忽略并回落到默认图，这是为了避免外站图片失效或被替换。

== 自动统计的部分 ==

下面这些数据由系统直接从数据库读取，无法手动修改：

* '''权限徽章'''：根据你所在的用户组自动显示（行政员、管理员、界面管理员等）。
* '''编辑次数'''：附带活跃度评级 —— 1 次起「新手编辑者」，50 次起「常规编辑者」，300 次起「活跃编辑者」，1000 次起「资深编辑者」。
* '''注册时间 / 首次编辑 / 最近编辑'''
* '''最近编辑列表'''：最近 5 次编辑及其摘要。

== 常见问题 ==

; 改完 profile.json 没变化？
: 按 Ctrl+F5 强制刷新一次。页面有缓存。

; JSON 写错了会怎样？
: 保存时编辑器会直接报错、不允许保存。万一存进去了格式有问题，资料卡会安全地回落到全部默认值，不会让页面出错。

; 别人能改我的资料吗？
: 不能。<code>User:你的用户名/profile.json</code> 只有你本人和界面管理员能编辑。

; 用户页正文还能写东西吗？
: 能。资料卡插在正文'''之前'''，你在 <code>User:你的用户名</code> 里写的内容照常显示在卡片下方。