1myblog/
 2├── hugo.toml                                    # [taxonomies] 添加 series = "series"
 3├── content/
 4│   └── series/
 5│       └── lumin-blog-dev/
 6│           └── _index.md                        # 系列元数据（标题、描述）
 7
 8themes/hugo-theme-lumin/
 9├── layouts/
10│   ├── _default/
11│   │   └── single.html                          # 集成系列导航
12│   └── partials/
13│       ├── series-nav.html                      # 顶部系列横幅（Banner + 目录）
14│       └── series-nav-bottom.html               # 底部前后篇导航
15└── assets/
16    └── css/
17        └── main.css                             # 系列相关样式

 1文章 frontmatter                              Hugo Taxonomy 引擎
 2series: ["lumin-blog-dev"]   ──────────►      收集所有标记了 series 的文章
 3按 series term 分组
 4                                             ┌─────────────────────────────────┐
 5                    series-nav.html           │  lumin-blog-dev:                │
 6                    按 series_order 排序       │    order 1: 评论系统            │
 7                    渲染目录 + 高亮当前篇      │    order 2: 时区配置            │
 8                                             │    order 3: 鼠标特效 ← 当前     │
 9                                             │    ...                          │
10                                             └─────────────────────────────────┘
11                                                     │
12                                                     ▼
13                                              series-nav-bottom.html
14                                              计算上一篇 (order 2) / 下一篇 (order 4)
15                                              渲染导航卡片

1[taxonomies]
2  category = "categories"
3  tag = "tags"
4  topic = "topics"
5  series = "series"          # 新增：文章系列

1---
2title: "Lumin Blog 开发文档"
3description: "Lumin Blog 主题功能开发系列文档"
4---

 1---
 2title: "某篇文章"
 3categories:
 4  - "code"
 5tags:
 6  - "Hugo"
 7topics:
 8  - "lumin-blog"
 9# 系列内排序（数字越小越靠前）
10---

1┌──────────────────────────────────────────────┐
2│ 📖  文章系列  Lumin Blog 开发文档     3 / 12 │  ← 紫色渐变 Banner
3├──────────────────────────────────────────────┤
4│  1  评论系统完全指南                          │
5│  2  时区配置指南                              │
6│  3  鼠标特效与指针样式完全指南  ← 当前高亮    │  ← 系列目录
7│  4  阅读进度条与返回顶部功能完全指南           │
8│  ...                                         │
9└──────────────────────────────────────────────┘

1┌───────────────────────┬───────────────────────┐
2│ ← 上一篇              │ 下一篇 →              │
3│ 时区配置指南           │ 阅读进度条与返回顶部   │  ← 紫色主题
4└───────────────────────┴───────────────────────┘

 1{{- if .Params.series -}}
 2{{- $seriesName := index .Params.series 0 -}}
 3{{- $seriesPage := site.GetPage (printf "/series/%s" $seriesName) -}}
 4
 5{{- $allPages := slice -}}
 6{{- if $seriesPage -}}
 7  {{- range $seriesPage.Pages -}}
 8    {{- $order := .Params.series_order | default 9999 -}}
 9    {{- $allPages = $allPages | append (dict "page" . "order" $order) -}}
10  {{- end -}}
11{{- end -}}
12
13{{- $sorted := sort $allPages "order" -}}

1{{- range $idx, $item := $sorted -}}
2  {{- if eq $item.page.RelPermalink $.RelPermalink -}}
3    {{- $currentIndex = add $idx 1 -}}
4  {{- end -}}
5{{- end -}}

 1{{- range $idx, $item := $sorted -}}
 2  {{- if eq $item.page.RelPermalink $.RelPermalink -}}
 3    {{- if gt $idx 0 -}}
 4      {{- $prevItem := index $sorted (sub $idx 1) -}}
 5      {{- $prevPage = $prevItem.page -}}
 6    {{- end -}}
 7    {{- if lt $idx (sub $total 1) -}}
 8      {{- $nextItem := index $sorted (add $idx 1) -}}
 9      {{- $nextPage = $nextItem.page -}}
10    {{- end -}}
11  {{- end -}}
12{{- end -}}

 1<footer class="post-footer">
 2  {{ partial "series-nav.html" . }}     ← 系列横幅（版权声明上方）
 3
 4  {{ if site.Params.article.showLicense }}
 5  <div class="post-license">...</div>
 6  {{ end }}
 7
 8  {{ partial "reward.html" . }}
 9</footer>
10
11{{ if .Params.series }}
12{{ partial "series-nav-bottom.html" . }}  ← 系列导航（替代 post-nav）
13{{ else if not .Params.excludeFromList }}
14<nav class="post-nav">...</nav>           ← 普通文章导航
15{{ end }}

1[data-theme="dark"] .article-series {
2  background: linear-gradient(135deg, rgba(30,41,59,.7) 0%, rgba(15,23,42,.6) 100%);
3  border-color: rgba(148,163,184,.12);
4}
5[data-theme="dark"] .series-toc-item.current {
6  background: linear-gradient(135deg, rgba(99,102,241,.2) 0%, rgba(139,92,246,.12) 100%);
7  color: #a5b4fc;
8}