### [03.06.010 设置文档上一篇和下一篇](https://guaqi.com/docs/77557)

**Published:** 2026-09-11T02:23:36

**Author:** 二丿小青年

**Excerpt:** 一、这个功能能做什么 文档的上下篇在编辑页「 文档上下篇设置」中手动填写文档 ID。留空时对应方向不显示。 先…

[03 文章与内容](/docs-archive/1231) / [03.06 文档与导航](/docs-archive/1237)

## 一、这个功能能做什么

文档的上下篇在编辑页「＜瓜奇＞ 文档上下篇设置」中手动填写文档 ID。留空时对应方向不显示。

### 先认识这几个词

-   **前端**：访客实际打开和使用的网站；同一后台可以对应多个前端网址。

## 二、设置后会有什么效果

可以为文档安排手动的上一篇和下一篇，例如让读者按“安装 → 配置 → 使用”顺序阅读；复制到另一语言后要检查跳转目标。

## 三、怎么使用

### 设置步骤

1.  确认当前文档所属语言、分类和前端。
2.  找到相同语言、希望作为上一篇和下一篇的文档 ID。
3.  分别填入「上一篇」「下一篇」，保存并发布。
4.  在目标前端点击两侧链接，核对标题、目标文档和访问结果。

这里填写的是 ID，不是标题、排序号或网址。填写后不会自动把目标文档反向链接回来；需要双向导航时分别编辑对应文档。

### 复制文档后的重点检查

上下篇属于瓜奇元数据，复制时可能保留源文档里的 ID。当前读取链路直接按保存的 ID 生成链接，没有在这个字段处理中自动替换成目标语言文档 ID。

因此译文发布前应重新检查上下篇：不要让英文文档的按钮指向中文文档，或指向本前端分类范围外的文档。

## 四、常见问题

### 链接为空或打不开

为空先查是否填了 ID 和模板是否展示上下篇；打不开查 ID 是否正确、目标是否存在且已发布、语言与前端范围是否合适。

文档首页默认路径为 `/doc`，这是首页或面包屑入口，不能代替具体上下篇文档 ID。



---