一、这个功能能做什么
文档的上下篇在编辑页「<瓜奇> 文档上下篇设置」中手动填写文档 ID。留空时对应方向不显示。
先认识这几个词
- 前端:访客实际打开和使用的网站;同一后台可以对应多个前端网址。
二、设置后会有什么效果
可以为文档安排手动的上一篇和下一篇,例如让读者按“安装 → 配置 → 使用”顺序阅读;复制到另一语言后要检查跳转目标。
三、怎么使用
设置步骤
- 确认当前文档所属语言、分类和前端。
- 找到相同语言、希望作为上一篇和下一篇的文档 ID。
- 分别填入「上一篇」「下一篇」,保存并发布。
- 在目标前端点击两侧链接,核对标题、目标文档和访问结果。
这里填写的是 ID,不是标题、排序号或网址。填写后不会自动把目标文档反向链接回来;需要双向导航时分别编辑对应文档。
复制文档后的重点检查
上下篇属于瓜奇元数据,复制时可能保留源文档里的 ID。当前读取链路直接按保存的 ID 生成链接,没有在这个字段处理中自动替换成目标语言文档 ID。
因此译文发布前应重新检查上下篇:不要让英文文档的按钮指向中文文档,或指向本前端分类范围外的文档。
四、常见问题
链接为空或打不开
为空先查是否填了 ID 和模板是否展示上下篇;打不开查 ID 是否正确、目标是否存在且已发布、语言与前端范围是否合适。
文档首页默认路径为 /doc,这是首页或面包屑入口,不能代替具体上下篇文档 ID。