Firefly 博客导航功能完整指南

1
src/
2
├── content/
3
│   ├── content.config.ts              # 内容集合定义（spec 集合）
4
│   ├── spec/                          # 特殊页面的 Markdown 内容
5
│   │   ├── about.md                   # 关于我
6
│   │   ├── friends.mdx                # 友链
7
│   │   ├── talks.md                   # 说说
8
│   │   ├── books.md                   # 书架
9
│   │   ├── movies-games.md            # 影视与游戏
10
│   │   ├── music.md                   # 音乐
11
│   │   ├── changelog.md               # 更新日志
12
│   │   ├── routines.md                # 规划
13
│   │   ├── places.md                  # 足迹
14
│   │   └── projects.md                # 网站导航
15
│   └── posts/                         # 博客文章
16
├── types/
17
│   └── config.ts                      # LinkPreset 枚举 + 类型定义
18
├── constants/
19
│   └── link-presets.ts                # LinkPreset → NavBarLink 映射表
20
├── config/
21
│   ├── siteConfig.ts                  # 站点配置（含页面开关）
22
│   └── navBarConfig.ts                # ⭐ 导航栏链接配置（核心文件）
23
├── pages/                             # 页面路由
24
│   ├── about.astro
25
│   ├── friends.astro
26
│   ├── talks.astro
27
│   ├── books.astro
28
│   ├── movies-games.astro
29
│   ├── music.astro
30
│   ├── changelog.astro
31
│   ├── projects.astro
32
│   └── life/
33
│       ├── routines.astro
34
│       └── places.astro
35
└── components/layout/
36
    └── Navbar.astro                   # 导航栏组件（通常无需修改）

1
主页 (/)                               ← LinkPreset.Home
2
分类 (/categories/)                    ← LinkPreset.Categories
3
归档 (/archive/)                       ← LinkPreset.Archive
4
网站导航 (/projects/)                   ← 自定义 NavBarLink
5
动态 (下拉菜单 icon:local-cafe)
6
  ├── 说说 (/talks/)                   ← LinkPreset.Talk（受开关控制）
7
  ├── 相册 (/gallery/)                 ← LinkPreset.Gallery（受开关控制）
8
  └── 留言板 (/guestbook/)             ← LinkPreset.Guestbook（受开关控制）
9
记录 (下拉菜单 icon:camera-outdoor)
10
  ├── 书架 (/books/)                   ← 自定义 NavBarLink
11
  ├── 影视与游戏 (/movies-games/)      ← 自定义 NavBarLink
12
  ├── 音乐 (/music/)                   ← 自定义 NavBarLink
13
  ├── 更新日志 (/changelog/)           ← 自定义 NavBarLink
14
  ├── 规划 (/life/routines/)           ← 自定义 NavBarLink
15
  └── 足迹 (/life/places/)             ← 自定义 NavBarLink
16
关于 (下拉菜单 icon:info)
17
  ├── 关于我 (/about/)                 ← LinkPreset.About
18
  ├── 友链 (/friends/)                 ← LinkPreset.Friends（受开关控制）
19
  └── 赞助 (/sponsor/)                ← LinkPreset.Sponsor（受开关控制）

1
---
2
import MainGridLayout from "@/layouts/MainGridLayout.astro";
3
import { getEntry, render } from "astro:content";
4
import Markdown from "@components/common/Markdown.astro";
5

6
const pagePost = await getEntry("spec", "xxx");
7
if (!pagePost) {
8
    throw new Error("Page content not found");
9
}
10
const { Content } = await render(pagePost);
11
---
12

13
<MainGridLayout title="页面标题" description="页面描述">
14
    <div class="flex w-full rounded-(--radius-large) overflow-hidden relative min-h-32">
15
        <div class="card-base z-10 px-9 py-6 relative w-full">
16
            <Markdown class="mt-2">
17
                <Content />
18
            </Markdown>
19
        </div>
20
    </div>
21
</MainGridLayout>

1
---
2
import MainGridLayout from "@/layouts/MainGridLayout.astro";
3
import { getEntry, render } from "astro:content";
4
import Markdown from "@components/common/Markdown.astro";
5

6
const booksPost = await getEntry("spec", "books");
7
if (!booksPost) {
8
    throw new Error("Books page content not found");
9
}
10
const { Content } = await render(booksPost);
11
---
12

13
<MainGridLayout title="书架" description="我读过的和正在读的书籍">
14
    <div class="flex w-full rounded-(--radius-large) overflow-hidden relative min-h-32">
15
        <div class="card-base z-10 px-9 py-6 relative w-full">
16
            <Markdown class="mt-2">
17
                <Content />
18
            </Markdown>
19
        </div>
20
    </div>
21
</MainGridLayout>

1
// 方式 A：作为顶级菜单
2
links.push({
3
    name: "书架",
4
    url: "/books/",
5
    icon: "material-symbols:book-5",
6
});
7

8
// 方式 B：作为下拉子菜单
9
links.push({
10
    name: "记录",
11
    url: "/records/",
12
    icon: "material-symbols:camera-outdoor",
13
    children: [
14
        { name: "书架", url: "/books/", icon: "material-symbols:book-5" },
15
        // ...其他子菜单
16
    ],
17
});

1
export const navigationConfig = {
2
  // 页面标题
3
  title: "网站导航",
4
  // 页面描述
5
  description: "我常用和推荐的网站",
6

7
  // 分类配置数组
8
  categories: [
9
    {
10
      id: "分类ID",           // 唯一标识符
11
      name: "分类名称",       // 显示名称
12
      icon: "图标名称",       // Iconify 图标
13
      color: "#颜色代码",     // 主题颜色
14
      dotColor: "#颜色代码",  // 标签圆点颜色（可选）
15
      sites: [                // 网站数组
16
        // ...网站配置
17
      ],
18
    },
19
    // ...更多分类
20
  ] as NavCategory[],
21
};

1
import type { MusicPlayerConfig } from "../types/config";
2

3
export const musicPlayerConfig: MusicPlayerConfig = {
4
    // 导航栏显示音乐入口
5
    showInNavbar: true,
6

7
    // 模式："meting" 用云端 API，"local" 用本地文件
8
    mode: "meting",
9

10
    // 默认音量
11
    volume: 0.7,
12

13
    // 播放模式：list / one / random
14
    playMode: "list",
15

16
    // 启用歌词
17
    showLyrics: true,
18

19
    // Meting API 配置
20
    meting: {
21
        api: "https://api.i-meto.com/meting/api?server=:server&type=:type&id=:id&r=:r",
22
        server: "netease",
23
        type: "playlist",
24
        id: "10046455237",
25
        auth: "",
26
        fallbackApis: [
27
            "https://api.injahow.cn/meting/?server=:server&type=:type&id=:id",
28
            "https://api.moeyao.cn/meting/?server=:server&type=:type&id=:id",
29
        ],
30
    },
31

32
    // 本地音乐配置
33
    local: {
34
        playlist: [
35
            {
36
                name: "歌曲名",
37
                artist: "歌手名",
38
                url: "/assets/music/歌曲.mp3",
39
                cover: "/assets/music/cover/封面.webp",
40
                lrc: "",
41
            },
42
        ],
43
    },
44
};