企业官网建设流程全解析

LeafWiki 是一个自托管 Wiki（Self-hosted wiki），单个 Go 二进制 + SQLite + 磁盘上的 Markdown，无需外部数据库。它的页面排序是显式手动控制的——不跟文件名走、也不自动按字母排，本文带你用 3 种手动排序操作，把侧边栏的顺序安排得明明白白。

为什么 LeafWiki 页面排序不跟文件名走？

很多 Wiki 或笔记工具按文件名字母序排列，但 LeafWiki 的设计哲学是：它不是文件浏览器，而是你定义的结构的忠实呈现。

• 默认顺序 = 创建顺序：页面刚创建时按先后出现，不会自动重排
• 页面身份与文件名解耦：LeafWiki 在 frontmatter 中用leafwiki_id标识页面，重命名或移动文件后身份不变，排序自然也不依赖文件名
• 你设置的顺序 = 读者看到的顺序：对团队文档来说，"入门 → 进阶 → 参考"的逻辑顺序，往往比字母序更有价值

这个设计让排序必须手动完成——好消息是，LeafWiki 提供了 3 种非常顺手的方式。📌

如何打开 LeafWiki 页面排序对话框：3 步操作

1. 在左侧侧边栏树中，悬停到目标章节（Section）或页面（Page）上，会出现操作按钮
2. 点击⋮（Open more actions，更多操作）按钮
3. 选择Sort Section Children（排序章节子项）或Sort Page Children（排序页面子项）

打开后就是核心的排序对话框。注意：只有拥有编辑器（Editor）或管理员（Admin）权限的账号才能保存排序，排序请求会发送到PUT /api/pages/:id/sort接口。

对话框顶部有说明文字："拖拽排序、使用箭头，或选择排序方式。点击'保存'后生效。"——这正是接下来 3 种操作的出处。

操作 1：拖拽排序，直接摆到你想要的位置

对话框中每个条目的左侧有 ⠿ 拖拽把手，按住它上下拖动，条目会实时让位，松手即完成换位。

• 支持指针拖拽，也支持键盘操作（Tab 聚焦后按方向键微调）
• 拖拽列表最大高度 400px，子项很多时列表内可滚动，不影响拖拽
• 同样的拖拽逻辑也用在侧边栏树本身：直接拖动树节点可以调整兄弟顺序，甚至跨章节移动（跨父级移动走的是移动 + 链接重写流程，拖到同父级下则是一次纯排序）

💡 想快速调整多个条目的大顺序？先拖拽定个大概，再用下面两种方式精修。

操作 2：上下箭头按钮，精确微调相邻位置

每个条目右侧有↑ / ↓ 两个箭头按钮，点击一次就与相邻条目交换位置，适合精细调整：

• 首位条目的 ↑ 按钮自动禁用，末位条目的 ↓ 按钮自动禁用，不会点空
• 连续点击可让某个条目逐步"上浮"或"下沉"
• 不依赖鼠标精确度，小屏幕或触屏设备上尤其好用

操作 3：一键字母排序 A→Z / Z→A，批量整队

对话框顶部的工具栏提供两组快捷排序，点击立即重排整个列表（仍需在最后点 Save 保存）：

混合内容（既有章节又有页面）时，两个功能可以组合使用：先点 A → Z 统一字母方向，再点"章节优先"让目录结构更清晰。✅

LeafWiki 页面排序的 3 个细节提醒

1. 排序是"按级"生效的：你排的只是某个章节（或页面）的直接子项顺序，不影响更深层嵌套项。想让整个目录有序，需要逐层设置。
2. 点 Save 才真正生效：拖拽、箭头、字母排序都只是本地预览，点Save（保存）后调用后端接口持久化，成功会提示"子项排序成功"。
3. 排序与重命名互不干扰：因为页面身份靠leafwiki_id而非文件名，之后无论怎么改标题，手动排好的顺序都会保留。

小结

LeafWiki 把"顺序"的定义权完全交给你：默认创建顺序打底，拖拽定大局、箭头精微调、A→Z 一键整队救急，三种操作覆盖从零星调整到批量整理的所有场景。

相关源码与文档位置：

• 官方文档排序章节：README.md
• 排序对话框前端实现：SortPagesDialog.tsx
• 侧边栏树拖拽排序：TreeDnd.tsx
• 前端 API 客户端sortPages：pages.ts
• 后端排序路由PUT /pages/:id/sort：routes.go