Baklib 文档中心

创建 Wiki 应用

适用读者:需要搭建产品文档、帮助中心、内部 Wiki 的运营或文档工程师
前置条件:已登录组织工作台;建议已有一个知识库空间(可在向导中新建)
预计耗时:约 15 分钟

概述

Wiki 类应用负责将 知识库 中的文档以文档站形式对外呈现。正文在知识库用 文档编辑器 撰写与协作;应用负责主题、导航、域名与 发布同步。这与 CMS 类「在应用后台直接写页面」的路径不同,也是新手最容易混淆的一点。
若尚未理解三库分工,请先读 创建应用。本篇以 Docs 模板为例演示 Wiki 应用创建与知识库绑定。

Wiki 与 CMS、Community 有何不同?

维度 Wiki 类(本篇) CMS 类 Community 类
内容写在哪里 知识库 应用后台页面管理 应用后台 + 社区互动
创建向导关键步 选择数据源(知识库) 无知识库步骤 通常无知识库步骤
发布方式 知识库保存 → 应用发布 同步 页面保存即生效(可配合版本发布) 页面/话题发布 + 评论互动
代表模板 Docs、Help、Developers、Chat Blog、WWW、Events Community、Feedback
延伸阅读 发布到 Wiki 应用站点 创建 CMS 应用 创建 Community 应用

步骤一:进入应用市场并筛选 Wiki 模板

00-02-wiki-02-筛选Wiki模板.png
  1. 应用库 点击 通过模板创建,进入应用市场。
  2. 点击顶部分类 Wiki,仅显示 Wiki 类模板。
  3. 常见选型:
    • Docs:产品手册、技术文档
    • Help:帮助中心、FAQ
    • Developers:开发者文档、SDK 说明
    • Chat:接入 AI 问答的文档站
  4. 悬停于 Docs(或目标模板),点击 安装
预期结果:进入创建向导,且第一步会出现 数据源(知识库) 区域。

步骤二:绑定知识库并完成向导

00-02-wiki-03-绑定知识库向导.png
  1. 第一步 — 模板:确认 Docs(或所选 Wiki 模板)与版本策略。
  2. 数据源(知识库):点击 点击选择
  3. 第二步 / 第三步:填写应用名称、访问域名等,逐步 下一步完成
💡
提示:同一知识库可绑定多个 Wiki 应用(如中文站 + 英文站)。创建时选好数据源,后续亦可在应用 基本设置 中调整(见 应用基本设置)。
预期结果:应用库出现新 Wiki 应用卡片;知识库与应用已建立数据源关系。

步骤三:在知识库撰写并发布到 Wiki

  1. 打开左侧 知识库,进入已绑定的空间。
  2. 使用 文档编辑器撰写文档(见 文档编辑器)。
  3. 保存后,进入知识库 发布 页,对目标 Wiki 应用执行 立即同步(见 发布到 Wiki 应用站点)。
预期结果:前台 Wiki 站点可访问最新文档;应用库卡片 前台访问 可预览。

步骤四:认识应用卡片操作

00-02-wiki-04-应用卡片.png
按钮 作用
后台管理 配置主题、域名、权限等(非撰写正文的主路径)
前台访问 打开对外 Wiki 站点预览
Wiki 日常写作仍以 知识库 为主;应用后台用于站点级配置,见 栏目与页面 中与 Wiki 模板相关的导航说明。
预期结果:明确「知识库写、Wiki 应用看」的分工。

常见问题

Q:创建时忘记绑定知识库怎么办?
A:进入该应用 后台管理 → 基本设置,重新指定内容来源知识库,然后在知识库 发布 页同步。
Q:Wiki 应用里找不到页面编辑器?
A:Wiki 正文在知识库;应用后台主要是站点设置与部分模板定义的静态页,属正常现象。
Q:Docs 和 Help 怎么选?
A:二者均为 Wiki 类,Help 更偏 FAQ/自助支持场景;详见 20+ 应用站点模板Help

相关阅读