友链·导航书签·站点入口维护
1064 字
5 分钟
友链·导航书签·站点入口维护
- 1Firefly 简单使用指南
- 2Firefly 布局系统详解
- 3Firefly Wiki Link 内部链接示例
- 4Firefly 一款清新美观的 Astro 博客主题模板
- 5在文章中嵌入视频
- 6Firefly 文章加密
- 7Markdown 教程
- 8Markdown 扩展功能
- 9Markdown Mermaid 图表
- 10Markdown PlantUML 图表
- 11Firefly 代码块示例
- 12KaTeX 数学公式示例
- 13MDX 格式文章示例
- 14内容发布全流程(写文章 + 推送上线)
- 15碎碎念(动态)维护指南
- 16相册与照片墙维护指南
- 17公告与固定页面文案维护
- 18友链·导航书签·站点入口维护本文
- 19R2 图床运营规范
- 20pnpm 常用指令速查(本地开发与构建)
📖 本文管什么
把站点里所有「链接集合」和「身份入口」收在一起讲——友链、导航书签、顶部菜单、简介与社交链接。它们都是配置文件里的一组数组,维护方式高度相似:改数组 → git 三连。
一、友链(src/config/friendsConfig.ts)
友链是一个对象数组,每项大概长这样:
{ name: "示例站点", // 站点名 url: "https://example.com", avatar: "https://cdn.xxx.top/page/01-example.webp", // 头像 description: "一句话介绍",}加 / 改 / 删友链
| 操作 | 做法 |
|---|---|
| 加 | 数组末尾加一个对象 |
| 改 | 改对应对象字段 |
| 删 | 去掉对应对象 |
| 排序 | 一般按数组顺序,想置顶就挪到前面 |
⚠️ 头像一定要本地化(重要)
不要把外链头像直接填进去。别人的头像热链到你的页面,一是依赖对方服务器、随时裂图,二是每次访问都打对方站、不礼貌也慢。
正确姿势:
- 把对方头像下载 → 转成 webp
- 传图床上传到
page/目录 - 把
avatar填成你图床的本地链接(命名规范见 R2 图床运营规范)
已上传的本地头像也叫不回来了——所以对没配头像的友链、或头像失效的,都用「下载 → 转 webp → 传
page/」流程修。
本站自己在别人站里的信息
友链是双向的:别人挂你,你也得在自己页面放「本站信息」给别人抄——在 src/content/spec/friends.mdx 里维护 site 对象(站点名、网址、头像、邮箱、一句话介绍)。
二、导航书签页(src/config/booknavConfig.ts)
/booknav/ 页面是个收藏夹,两级结构:分组 → 组内书签。
export const booknavConfig = [ { id: "dev", // 分组锚点 id name: "开发", // 分组名 items: [ // 组内的书签 { title: "GitHub", url: "https://github.com" }, { title: "某文档", url: "https://example.com", icon: "fa7-brands:github", // 可选,留空自动取目标 favicon desc: "说明", weight: 1, enabled: true }, ], },];- 书签
icon留空会自动抓目标站 favicon weight越大排越前(默认 0);enabled: false可暂时隐藏一条- 增删书签 = 增删
items里的对象
三、顶部导航菜单(src/config/navBarConfig.ts)
页面顶部菜单项也在这里:
export const navBarConfig = { links: [ { name: "全览", url: "/posts/", icon: "…" }, { name: "外部链接", url: "https://example.com", external: true }, // 外部 { name: "带子菜单", url: "#", children: [ /* 子菜单项 */ ] }, ],};- 菜单项 =
links数组里的对象;children支持二级子菜单 external: true的项会在新窗口打开- 首页那几个「板块入口」若有独立配置在页面文件里,改动入口时会单独说明,不在这个文件
四、简介与社交链接(src/config/profileConfig.ts)
侧栏的「个人资料卡」内容在这:
export const profileConfig = { avatar: "/assets/xxx.webp", // 头像(本地放 public/assets/ 或图床链接) name: "站点主人", bio: "主页一句话简介", sidebarBio: "侧栏简介,留空则复用 bio", // 想主页和侧栏文案不同就填它 links: [ { name: "GitHub", url: "https://github.com/…", icon: "fa7-brands:github" }, { name: "Email", url: "mailto:…", icon: "…" }, ],};sidebarBio:主页 bio 和侧栏简介想显示不同文字时用(留空回退到bio)links:侧栏资料卡的图标链接。注意主页首屏的社交图标可能是另一处(主页背景配置里的 homeText 链接)——两处入口位置不同,都认name/url结构
改邮箱 / 社交号等个人资料后,记得
profileConfig.links、主页 hero 社交图标、以及friends.mdx里的本站信息是三处独立的,别只改一处。
五、页脚与音乐歌单
| 想改什么 | 文件 | 说明 |
|---|---|---|
| 页脚底部自定义(备案号等) | src/config/footerConfig.ts | customHtml 直接写 HTML |
| 换网易云歌单 | src/config/musicConfig.ts | 改歌单 id 即可(播放走第三方接口,主题负责拉取渲染) |
换歌单:在网易云把歌单设成公开 → 复制歌单 id → 填进 musicConfig 对应字段 → 本地预览确认能加载 → git 三连。
✅ 速记
- 友链、导航书签、顶部菜单、社交链接 = 四个配置文件里的数组,增删都是「加/减一个对象」
- 友链头像必须本地化:下载 → 转 webp → 传图床
page/ - 个人资料有多处副本(侧栏 profile / 主页 hero / friends.mdx),改一处记得核对其它
- 全部改完统一 git 三连上线
支持与分享
如果这篇文章对你有帮助,欢迎分享给更多人或打赏支持!
友链·导航书签·站点入口维护
https://hecloud.top/posts/guide/maintenance-links-nav/相关文章智能推荐
1
碎碎念(动态)维护指南
博客指南本站「碎碎念」短内容的发布方法:文件放哪、三个 frontmatter 字段怎么填、图片图集怎么写、如何发布/修改/删除。个人维护手册。
2
公告与固定页面文案维护
博客指南本站侧边栏公告和「关于/留言板/隐私政策/用户协议」等固定页面的维护方法:改字在哪、怎么显示/隐藏公告、spec 页面文件对应关系。个人维护手册。
3
相册与照片墙维护指南
博客指南本站相册系统的完整维护方法:一个相册由哪几部分组成、怎么新增/修改/删除相册、照片清单 urls.txt 怎么维护、封面规则、加密相册、主页照片墙绑定。个人维护手册。
4
内容发布全流程(写文章 + 推送上线)
博客指南本站内容维护的总纲:文章/碎碎念从哪里写、图片放哪、frontmatter 与系列字段怎么填、git 三步推送后如何自动上线。个人维护手册。
5
pnpm 常用指令速查(本地开发与构建)
博客指南本站本地开发要用到的所有 pnpm 指令:开发服务器、构建、脚手架、代码检查。附构建流水线到底做了什么、本地发布自检流程。个人维护手册。
随机文章随机推荐





