添加主题（Add a Topic)

主题（Topic） 是一个预配置的容器，由多个内容单元组成。每个主题都是可重复使用的内容集合，内部内容已按照标准格式进行预设，包括标题、正文、列表、警告、表格或其他格式样式。

当您添加主题时，Pergamon 会根据主题的预定义结构，将其内容插入为新的内容块。这样可提供一套完整且已设置样式的内容块序列，有助于保持文档一致性，并减少手动创建或格式化内容的需要。

开始之前

• 您需要拥有该文档的访问权限。

  • 如果您不是文档作者，请向作者请求访问权限。

  • 如果文档显示为“锁定”状态，请联系文档作者解除编辑锁定。

• 在编辑器中打开一个现有文档。

• 确保已启用单会话编辑模式（single-session editing mode）。

添加主题

• 选择您希望插入主题的位置所属的内容块。
  1.选择的内容块会决定主题在文档结构中的放置方式。

• 在编辑器右侧工具栏中点击 “Add a Topic / 添加主题”。
  

• （可选）使用 分类（Category） 下拉菜单或搜索栏查找目标主题。
  

• 点击主题右侧的 “+” 图标将其插入文档。
  

• （可选）勾选 “Place at document start / 置于文档开头”，将主题插入文档最前方。
  
  
  当你添加一个主题时，Pergamon 会将一组预配置的内容作为新的内容块插入到你的文档中。这些块以 共享内容 的形式插入，保持其原始结构和样式。共享内容包括：

  • 灰色背景

  • 链接/链接图标

  • 在内容属性面板中设置 级别 为共享

  • 一个显示主题ID的源字段
    （例如：“从主题 IT01582 手动添加的共享内容”）

Pergamon 如何根据语言选择要插入的主题

主题通常包含多个内容单元，每个单元可能支持不同语言。
当您添加主题时，Pergamon 只会插入与当前文档语言匹配的内容单元。

工作机制

1. Pergamon 会检查当前文档的语言（例如：PL）。

2. 系统会遍历主题中的每个内容单元。

3. 如果某个内容单元包含与文档语言相同的语言版本 → 该内容单元会被插入文档。

4. 如果内容单元没有匹配语言 → 该内容单元会被跳过。

5. 如果所有内容单元都没有匹配的语言版本 → 主题无法插入，并会显示错误提示。

示例（Example）

场景 1：文档语言为 PL

主题包含 3 个内容单元，但只有 IC00002 具有 PL 版本
→ 仅 IC00002 会被插入

场景 2：文档语言为 PL

所有内容单元均无 PL 版本
→ 显示错误提示
 

主题如何根据所选内容块进行放置

Pergamon 文档结构由 父级标题块（H1–H5） 与其下属的 子内容块 组成。
您在步骤 1 中选定的内容块会决定主题的嵌入方式。

当您选择父级标题块（H1）时

• 如果主题以 非标题类型内容 开始（如正文、列表、警告等）：
  → 所有主题将作为 选定 H1 标题下的子内容块 插入。

• 如果主题也以 H1 标题 开始：
  → 系统会在选定内容块 下方 插入一个新的 H1 标题块，而不是作为其子级内容。

当您选择子级标题块（H2–H5）时

• 所有主题将作为 所选标题的子内容块 插入。

编辑主题

编辑主题指的是编辑作为主题一部分插入到文档中的内容。
主题中的内容单元会以 共享内容块（Global Content Blocks） 的形式插入文档。在解锁之前，这些内容块无法编辑。

将共享内容转换为本地内容

• **macOS：**Shift + Command (⌘) + L

• **Windows：**Shift + Ctrl + L

转换后：

• 内容块背景变为白色

• 锁链图标消失

• 内容块变为本地内容（Local），可自由编辑

故障排查

问题

主题在当前文档语言中没有内容（Topic has no content in the document’s language）

原因

该主题不包含与当前文档语言匹配的任何内容单元。由于主题缺少对应语言版本，Pergamon 无法将其插入文档。

解决方法

请联系您组织内指定的 知识工程（Knowledge Engineering）团队 以获取支持。