基础配置：个人信息、标题与导航#

1. 修改左侧个人信息 (名字、签名与头像)#

整个博客页面左侧边栏显示的作者信息框，完全由 config.ts 中的 profileConfig 控制。

打开 src/config.ts，找到如下配置：

1
export const profileConfig: ProfileConfig = {
2
    avatar: "https://github.com/你的名字.png",
3
    name: "你的名字",
4
    bio: "这里是你的个性签名。",
5
    links: [
6
        {
7
            name: "GitHub",
8
            icon: "fa6-brands:github",
9
            url: "https://github.com/你的名字",
10
        },
11
        // 你可以继续往下添加 Twitter, Bilibili 等社交链接
12
    ],
13
};

修改指南：

• 头像 (avatar)：可以是一个网络链接 (如 GitHub 头像链接)，也可以是你存放在本地 public/ 或 src/assets/ 目录下的图片。如果放在 public 下，直接写绝对路径 /avatar.png 即可。
• 名字与签名 (name & bio)：直接修改为你喜欢的文字。
• 社交链接 (links)：这会在你的名字下方生成一排可点击的社交图标。icon 字段支持 Icones 上超过十万个开源图标，直接复制标识符填入即可。

TIP

进阶技巧：修改头像的点击跳转链接 默认情况下，点击大头像会跳转到/about/页面。如果你希望它像通常的博客那样点击回到主页，只需打开 src/components/widget/Profile.astro 文件，找到第 10 行附近的 <a aria-label="..." href={url('/about/')}，将其修改为 href={url('/')} 即可。你也可以顺便将对应的图标修改为 material-symbols:home-outline-rounded 以匹配主页意图。

2. 修改网站名称与各页面 Title#

页面顶部浏览器标签页的标题由全局配置和各页面的多语言字典共同决定。

1
export const siteConfig: SiteConfig = {
2
    title: "你的博客名称",
3
    subtitle: '你的博客副标题',
4
    // ...
5
}

1
export const zh_CN: Translation = {
2
    [I18nKey.home]: '主页',
3
    [I18nKey.about]: '关于',
4
    [I18nKey.archive]: '归档',
5
    [I18nKey.blog]: '博文',
6
    [I18nKey.docs]: '知识库', // 你可以把 "文档" 改成 "知识库" 或 "Wiki"
7
    // ...
8
};

3. 修改顶部标题栏 (Titlebar) 的按钮与链接#

页面顶部的导航栏（如 Home, Blog, Docs 以及最右侧的 GitHub 图标链接）是由 config.ts 中的 navBarConfig 控制的。

找到如下代码：

1
export const navBarConfig: NavBarConfig = {
2
    links: [
3
        LinkPreset.Blog,
4
        LinkPreset.Docs,
5
        LinkPreset.Archive,
6
        LinkPreset.About,
7
        LinkPreset.Friends, // 我们新增的友链系统
8
        {
9
            name: "GitHub",
10
            url: "https://github.com/aquamarine-z",
11
            external: true, // true 表示在新标签页打开
12
            icon: "fa6-brands:github"
13
        },
14
    ],
15
};