评论逐步操作
本指南介绍了与评论功能相关的各种功能。它还解释了评论功能如何与其他编辑器功能集成。
# 评论和评论线程
选择内容片段并按下工具栏按钮
在编辑器中显示注释。这表示已启动评论线程,但目前还没有任何评论。在添加第一个评论后提交线程,这可以通过单击“评论”按钮来完成。如果单击“取消”按钮,则会删除评论线程。评论线程是存储评论的实体。
在 实时协作 中,评论线程在提交第一个评论后与会话中的其他用户共享。
评论线程视图也称为“注释”或“气球”。您可以以三种不同的显示模式之一显示 注释
- 一个宽边栏
- 一个窄边栏(如本指南所示)
- 内联
您可以在 注释显示模式 指南中了解有关这些模式的更多信息。
# 评论线程视图
线程中的每条评论都显示其作者、他们的图片(头像)和评论创建时间。
每条评论的右上角显示了根据 用户权限 可用的操作。
第一个评论旁边的“解决”和“删除”按钮适用于**整个线程**。对任何后续评论使用“删除”操作只会删除选定的评论。
您可以向此下拉菜单添加自定义操作,并为评论线程视图创建其他 自定义设置。
在注释的底部,有一个输入字段。用户可以在其中键入以继续讨论。此输入的可用性取决于用户权限。
# 评论线程状态
创建的评论线程在其生命周期中可以处于各种状态。
# 打开
这是评论线程的默认状态。线程在文档中可用,其注释位于突出显示内容旁边。用户可以通过向线程添加更多评论(回复)来进行讨论。
# 已解决
单击“解决”按钮后,线程将被解决。它将被移至**评论存档**。
您可以通过专用下拉菜单
访问已解决的线程。单击已解决的线程会将您重定向到创建线程的突出显示内容元素。已解决的评论线程与打开的评论线程看起来不同。注释内有一个黄色条,其主要部分是**上下文**
- 对于文本内容 - 这是创建线程的文本。
- 对于图像 - 这将是其替代文本。
- 对于没有文本信息的块元素 - 该条将显示默认上下文信息“评论是在元素上做出的”。
您可以通过以下方式重新打开已解决的评论线程
- 在评论存档中回复它。
- 点击上下文旁边的“重新打开”按钮。
在评论列表的末尾,您可以看到关于何时以及由谁解决该主题的详细信息。当您重新打开该主题时,此信息将消失。
上下文是在创建评论主题时设置的,并且不会修改。它在整个评论主题的生命周期中保持一致,即使内容发生更改。
# 未链接
当您从文档中删除与评论主题相关的文档内容时,评论主题将变得未链接。然后它将被移到评论存档。由于它没有被技术上解决,因此不会显示通常的相关信息。
您仍然可以在评论存档中与未链接的主题进行交互。但是,由于相关内容已被删除,它不会在编辑器中突出显示。添加新评论后,该主题也不会重新打开。
您可以解决并重新打开未链接的主题,因为这两个状态是单独处理的。
当其相关内容在文档中恢复时,未链接的主题将被恢复。这可能发生在使用撤消、恢复旧修订版(通过 {@features/revision-history 修订历史功能})或加载包含相关内容的早期(旧版)文档数据后。
# 未链接且已解决
主题也可以存在于未链接和已解决的组合状态中,继承两种状态的行为。
这意味着在这种主题中,您可以继续讨论,这将重新打开主题。但是,除非您恢复相关内容(如上所述),否则主题不会显示在文档中。
由于编辑器分别处理这两个状态,因此评论主题可能会按任何顺序变得已解决、未链接,然后重新打开并链接。
# 已删除
处于此状态的主题已永久删除,您无法恢复它们。您只能使用 UI 删除评论主题。您必须在永久删除评论主题之前确认此操作。
通过按钮执行的操作(解决、删除和重新打开)无法使用撤消功能撤消。
# 状态的关系和流程
如果您更喜欢视觉表示,下图说明了评论主题的各种状态
# 与其他功能的集成
某些功能以非明显的方式与评论主题集成。此类情况将在以下部分中介绍。
# 修订历史
在使用修订历史时,了解未链接和已解决或已删除的评论主题之间的区别很重要。
- 恢复修订版将重新打开未链接的评论主题。这是因为评论内容在编辑器中再次可用。
- 恢复修订版不会恢复已解决或已删除的评论主题。修订历史功能不会恢复评论主题状态。
这是用户期望的行为。当用户解决或删除评论主题时,他们的动机是讨论已完成或无效。即使您恢复评论内容,讨论仍然已结束。因此,评论主题应该保留在存档中(或保留已删除且无法访问)。
当评论主题被存档是因为其相关内容丢失时,情况就不同了。在这种情况下,当删除的内容被恢复时,讨论仍然是相关的。
# 从 Word 导入
评论功能还与从 Word 导入功能集成。从导入的 Word 文档中显示的所有评论都显示为批注,但标记为“外部”。这样做是为了将它们与在编辑器中创建的评论区分开来。它还可以防止对评论作者身份的混淆,并阐明评论的来源。
您可以在 Word 中将评论主题标记为已解决。导入文档后,此类主题将在编辑器的评论存档中显示为已解决。但是,不会显示关于谁解决了它们的详细信息,因为此信息在 Word 文件中不可用。
# 导出到 Word
使用导出到 Word功能将编辑器内容导出到 .docx
文件后
- 将保留所有打开和已解决的评论主题。
- 未链接和已删除的主题将不可用。
# 剪贴板
当您在文档周围剪切和粘贴评论内容时,评论标记将保留在剪贴板中。同样,如果您拖放编辑器内容的一部分,评论将相应地一起移动。这也适用于已解决的评论主题。
请注意,仅当移动整个评论内容时,才会移动评论标记。如果只剪切和粘贴或拖放评论的一部分,评论标记将保留在原始内容上。这是为了防止重复评论造成的混淆。
如果您希望为复制和粘贴也保留评论标记,则需要在编辑器配置中添加适当的设置。
我们每天都在努力使我们的文档保持完整。您是否发现过时信息?有什么遗漏吗?请通过我们的问题跟踪器报告。
随着 42.0.0 版的发布,我们重写了大部分文档以反映新的导入路径和功能。感谢您的反馈,帮助我们确保文档的准确性和完整性。