社交链接与图标
文章目录
专栏目录 · 主题文档
社交链接显示在作者头像、名字和文章数量下方。内置图标在 v0.5.0 之后加入;使用旧标签时,请阅读对应版本的说明。
添加账号
在博客根目录的 _config.syutoi.yml 中填写自己的主页地址。本仓库的示例站使用 example/_config.syutoi.yml:
social: |
替换示例地址,删除不使用的条目,然后重启预览或重新生成部署。列表整体覆盖,不会与主题默认值逐项合并;按填写顺序显示。不要在同一个 YAML 文件里重复声明多个 social。
支持的平台
type |
平台或用途 |
|---|---|
github |
GitHub |
gitlab |
GitLab |
x |
X;twitter 是兼容别名,也使用 X 图标 |
zhihu |
知乎 |
xiaohongshu |
小红书 |
bilibili |
哔哩哔哩 |
weibo |
微博 |
telegram |
Telegram |
youtube |
YouTube |
instagram |
|
mastodon |
Mastodon |
bluesky |
Bluesky |
email |
邮件,地址使用 mailto: |
rss |
订阅链接;不会自动生成订阅文件 |
website |
个人网站或其他网页 |
类型大小写不敏感。内置平台图标随主题提供,无需准备图片、安装插件或连接图标 CDN。只有配置使用的 SVG 会嵌入页面,颜色跟随明暗主题。图标保留键盘焦点、无障碍名称和悬停提示;名称取自内置标签或自定义 name。
品牌 SVG 来自 Simple Icons;来源、版本与许可见 图标维护说明。
自定义名称和文字链接
设置 type 时,name 修改悬停提示和读屏名称,不会把图标变为文字:
social: |
不填写 type 时显示文字,适合尚未支持的平台。未知类型有 name 时也显示文字,没有名称则忽略。主题不会根据 URL 猜测平台,不接受任意图标文件路径作为 type。名称按纯文字转义,不能填写 HTML。
URL 支持站内路径、HTTP(S) 和 mailto:;填写平台的完整个人主页链接,不要只写账号名。非法地址会被忽略。站内路径会自动加入站点 root 前缀,自定义页面需要自行创建。
隐藏与排查
social: [] |
上述配置隐藏全部社交链接。sidebar.enable: false 会隐藏整个侧栏,包括社交区域。
| 现象 | 检查方式 |
|---|---|
| 显示文字,没有图标 | 使用内置 type,例如 type: github;仅写 name: GitHub 会保留文字 |
| 某一项不显示 | 检查 URL、类型拼写;未知类型需补上 name |
| 整个社交区域不显示 | 检查列表是否为空、侧栏是否关闭,以及配置覆盖顺序 |
| 更新后没有变化 | 重启预览并重新生成;线上还需部署生成文件 |
旧的 {name, url} 列表保持文字显示;也支持 social: {github: {url: ...}} 的结构化映射。Shoka 的 URL || icon || color 字符串映射仍按文字链接处理,不使用旧图标和颜色。建议使用本页的列表格式。