Report an issue

指南评论逐步操作

本指南介绍了与评论功能相关的各种功能。它还解释了评论功能如何与其他编辑器功能集成。

# 评论和评论线程

选择内容片段并按下工具栏按钮 评论 在编辑器中显示注释。这表示已启动评论线程,但目前还没有任何评论。在添加第一个评论后提交线程,这可以通过单击“评论”按钮来完成。如果单击“取消”按钮,则会删除评论线程。

评论线程是存储评论的实体。

实时协作 中,评论线程在提交第一个评论后与会话中的其他用户共享。

A comment annotation in CKEditor 5 WYSIWYG editor.

评论线程视图也称为“注释”或“气球”。您可以以三种不同的显示模式之一显示 注释

  • 一个宽边栏
  • 一个窄边栏(如本指南所示)
  • 内联

您可以在 注释显示模式 指南中了解有关这些模式的更多信息。

# 评论线程视图

线程中的每条评论都显示其作者、他们的图片(头像)和评论创建时间。

Comment thread view inside the editor.

每条评论的右上角显示了根据 用户权限 可用的操作。

第一个评论旁边的“解决”和“删除”按钮适用于**整个线程**。对任何后续评论使用“删除”操作只会删除选定的评论。

您可以向此下拉菜单添加自定义操作,并为评论线程视图创建其他 自定义设置

在注释的底部,有一个输入字段。用户可以在其中键入以继续讨论。此输入的可用性取决于用户权限。

# 评论线程状态

创建的评论线程在其生命周期中可以处于各种状态。

# 打开

这是评论线程的默认状态。线程在文档中可用,其注释位于突出显示内容旁边。用户可以通过向线程添加更多评论(回复)来进行讨论。

# 已解决

单击“解决”按钮后,线程将被解决。它将被移至**评论存档**。

Resolving a comment.

您可以通过专用下拉菜单 评论存档 访问已解决的线程。单击已解决的线程会将您重定向到创建线程的突出显示内容元素。

已解决的评论线程与打开的评论线程看起来不同。注释内有一个黄色条,其主要部分是**上下文**

  • 对于文本内容 - 这是创建线程的文本。
  • 对于图像 - 这将是其替代文本。
  • 对于没有文本信息的块元素 - 该条将显示默认上下文信息“评论是在元素上做出的”。

您可以通过以下方式重新打开已解决的评论线程

  • 在评论存档中回复它。
  • 点击上下文旁边的“重新打开”按钮。

Comments archive.

在评论列表的末尾,您可以看到关于何时以及由谁解决该主题的详细信息。当您重新打开该主题时,此信息将消失。

上下文是在创建评论主题时设置的,并且不会修改。它在整个评论主题的生命周期中保持一致,即使内容发生更改。

# 未链接

当您从文档中删除与评论主题相关的文档内容时,评论主题将变得未链接。然后它将被移到评论存档。由于它没有被技术上解决,因此不会显示通常的相关信息。

您仍然可以在评论存档中与未链接的主题进行交互。但是,由于相关内容已被删除,它不会在编辑器中突出显示。添加新评论后,该主题也不会重新打开。

您可以解决并重新打开未链接的主题,因为这两个状态是单独处理的。

当其相关内容在文档中恢复时,未链接的主题将被恢复。这可能发生在使用撤消、恢复旧修订版(通过 {@features/revision-history 修订历史功能})或加载包含相关内容的早期(旧版)文档数据后。

Comments archive.

# 未链接且已解决

主题也可以存在于未链接和已解决的组合状态中,继承两种状态的行为。

这意味着在这种主题中,您可以继续讨论,这将重新打开主题。但是,除非您恢复相关内容(如上所述),否则主题不会显示在文档中。

由于编辑器分别处理这两个状态,因此评论主题可能会按任何顺序变得已解决、未链接,然后重新打开并链接。

# 已删除

处于此状态的主题已永久删除,您无法恢复它们。您只能使用 UI 删除评论主题。您必须在永久删除评论主题之前确认此操作。

Deleting a comment thread.

通过按钮执行的操作(解决、删除和重新打开)无法使用撤消功能撤消。

# 状态的关系和流程

如果您更喜欢视觉表示,下图说明了评论主题的各种状态

Comment states and point of action.

# 与其他功能的集成

某些功能以非明显的方式与评论主题集成。此类情况将在以下部分中介绍。

# 修订历史

在使用修订历史时,了解未链接和已解决或已删除的评论主题之间的区别很重要。

  1. 恢复修订版将重新打开未链接的评论主题。这是因为评论内容在编辑器中再次可用。
  2. 恢复修订版不会恢复已解决或已删除的评论主题。修订历史功能不会恢复评论主题状态。

这是用户期望的行为。当用户解决或删除评论主题时,他们的动机是讨论已完成或无效。即使您恢复评论内容,讨论仍然已结束。因此,评论主题应该保留在存档中(或保留已删除且无法访问)。

当评论主题被存档是因为其相关内容丢失时,情况就不同了。在这种情况下,当删除的内容被恢复时,讨论仍然是相关的。

# 从 Word 导入

评论功能还与从 Word 导入功能集成。从导入的 Word 文档中显示的所有评论都显示为批注,但标记为“外部”。这样做是为了将它们与在编辑器中创建的评论区分开来。它还可以防止对评论作者身份的混淆,并阐明评论的来源。

Comments imported from Word.

您可以在 Word 中将评论主题标记为已解决。导入文档后,此类主题将在编辑器的评论存档中显示为已解决。但是,不会显示关于谁解决了它们的详细信息,因为此信息在 Word 文件中不可用。

Comments imported from Word.

# 导出到 Word

使用导出到 Word功能将编辑器内容导出到 .docx 文件后

  • 将保留所有打开和已解决的评论主题。
  • 未链接和已删除的主题将不可用。

# 剪贴板

当您在文档周围剪切和粘贴评论内容时,评论标记将保留在剪贴板中。同样,如果您拖放编辑器内容的一部分,评论将相应地一起移动。这也适用于已解决的评论主题。

请注意,仅当移动整个评论内容时,才会移动评论标记。如果只剪切和粘贴或拖放评论的一部分,评论标记将保留在原始内容上。这是为了防止重复评论造成的混淆。

如果您希望为复制和粘贴也保留评论标记,则需要在编辑器配置中添加适当的设置