发布到 Wiki 应用站点

巴克励步

概述

知识库中的文档保存在 内容源;访客在前台 Wiki 站点看到的内容,须通过 发布 将知识库同步到已绑定该库的 Wiki 应用。一篇知识库可绑定多个 Wiki 应用(如中文站、英文站、内网预览站),应用发布 页会列出所有引用本库的应用及其同步状态。
「保存」只更新知识库草稿;「立即同步」才将变更推送到应用数据源并可在前台访问。撰写流程见 文档编辑器发文;应用创建与绑定见 创建您的第一个应用创建与管理知识库空间

操作步骤

步骤一:保存知识库文档

  1. 在 文档编辑器中完成撰写或修改。
  2. 点击右上角 保存,或等待自动保存成功提示。
  3. 可选:切换 阅读模式 预览渲染效果(见 文档编辑器功能参考)。
预期结果:文章已写入知识库;此时前台 Wiki 尚未 必然更新。

步骤二:进入应用发布页

  1. 在知识库左侧边栏底部点击 发布
  2. 进入 应用发布 页面。
11-01-应用发布.png
页面自上而下包括:
  • 顶部 绿色引导区:标题为「应用发布:让知识库对外可访问」,说明可将本知识库同步到一个或多个 Wiki 站点,对外提供文档、FAQ、帮助中心等访问。
  • 下方 已发布的站点:列出当前已绑定本知识库为内容来源的 Wiki 应用卡片。
预期结果:若已有绑定应用,已发布的站点 中显示各 Wiki 卡片;若尚无应用,主要见引导区与 前往应用市场创建 Wiki 站点 按钮。

步骤三:首次绑定 Wiki 应用

已发布的站点 为空,需按页内引导完成首次绑定。
  1. 阅读绿色引导区 第一步 说明:先在 应用市场 创建一个 Wiki 站点并选择模板,然后在站点中将 本知识库 选为内容来源。
  2. 点击引导区右侧 前往应用市场创建 Wiki 站点,进入应用库安装 Wiki 模板(亦见 创建您的第一个应用)。
  3. 创建应用时选择 数据源 为本知识库,或于应用 基本设置 中指定知识库(见 应用基本设置)。
  4. 配置应用 域名访问控制 等,见 域名管理访问控制与授权
  5. 返回知识库 应用发布 页,已发布的站点 中应出现新创建的 Wiki 应用卡片。
💡
提示:一个 Wiki 应用通常对应一个对外站点;中文与英文可分别创建两个应用并绑定不同知识库空间,见 多语言多站点配置
预期结果已发布的站点 至少有一条 Wiki 应用记录。

步骤四:查看已发布站点与同步状态

已发布的站点 列表中,每张卡片通常展示:
信息
说明
应用名称与 WIKI 标签
如 AI Chat、Product Wiki V3.0
最近同步于
上次成功同步的时间;知识库有变更未推送时,可能显示为数月前
数据已过期(红色)
知识库内容已更新但尚未同步到该 Wiki 应用
立即同步
卡片底部按钮,将知识库内容推送到该应用
可点击卡片进入对应站点后台,查看访问情况或调整站点设置。
预期结果:能识别哪些站点 数据已过期、各自 最近同步于 何时;无过期提示表示该站点与知识库内容一致(以界面状态为准)。

步骤五:立即同步

  1. 在目标 Wiki 应用卡片上点击 立即同步
  2. 等待任务完成;数据量大时可在后台继续,稍后刷新 应用发布 页查看 最近同步于 是否更新。
  3. 同步成功后,数据已过期 提示应消失;通过应用 前台访问 或已绑域名验证页面内容。
预期结果最近同步于 更新为近期时间;前台 Wiki 可见最新目录与正文。

步骤六:验证前台与预览

  1. 在应用后台打开 前台访问(见 访问与预览),或访问已绑定的自定义域名。
  2. 抽检刚修改的页面:标题、正文、图片、内链是否正常。
  3. 若站点启用了 访问控制,用访客账号或无登录状态分别验证授权逻辑(见 访问控制与授权)。
预期结果:前台内容与知识库一致;未同步前的草稿不会泄露到公开站点(以访问控制配置为准)。

步骤七:多应用与变更管理

同一知识库绑定多个 Wiki 应用时,每次内容变更后需对 各应用分别点击立即同步(或按产品当前支持的批量操作),方可使所有站点同步。
场景
建议
仅内网预览站更新
只同步绑定内网域名的应用
生产与 staging 双应用
先在 staging 同步验证,再同步生产
大规模目录调整
同步前 导出备份,见 导入与导出
AI 翻译后的语言站
译文保存后,同步对应语言的 Wiki 应用,见 AI 翻译
预期结果:各站点内容与预期环境一致;重大变更可追溯操作日志(应用侧见 事件统计与操作日志)。

常见问题

Q:保存了为什么前台没变?
A:保存 只更新知识库;必须完成 立即同步 且目标 Wiki 应用绑定的是该知识库,前台才会更新。若卡片显示 数据已过期,说明尚未同步。
Q:「数据已过期」是什么意思?
A:表示知识库内容比该 Wiki 应用上的数据新,访客看到的仍是旧版;点击 立即同步 即可更新。
Q:发布会影响 URL 吗?
A:多数 Wiki 模板按文档 ID 路由,移动目录树通常不改变 URL;换模板或改 slug 规则时请以当前主题为准,同步后务必点验链接。
Q:CMS 应用也需要从知识库发布吗?
A:CMS 类应用 在应用后台直接管理页面,不经过知识库发布流;本章仅适用于 Wiki 类应用
Q:同步失败怎么办?
A:查看页面错误提示;常见原因包括应用已删除、域名未就绪、权限不足。确认应用状态与成员角色(见 成员与权限管理知识库设置)。
Q:与「应用后台发布」有何区别?
A:知识库 应用发布 是将内容 推送到 已绑定 Wiki 应用的数据源;部分模板在应用侧还有缓存刷新或静态化步骤,以应用文档为准。

相关阅读