了解编辑器功能 id176NC500V5Z

Cloud Services：如果您使用的是Cloud Services，则选择​ Assets ​选项会转到AEM导航页面。

内部部署软件：如果您使用的是Adobe Experience Manager Guides（4.2.1及更高版本），则选择​ Assets ​选项会将您转到Assets UI中的当前文件路径。

常规：“常规”设置允许您配置字典以与编辑器一起使用。 此选项卡包含四个部分：拼写检查、条件、创作 ​和​ 引用。

{width="650"}

• 拼写检查：有两个选项 — AEM拼写检查 ​和​ 浏览器拼写检查。 默认情况下，编辑器使用浏览器拼写检查功能，其中拼写检查使用浏览器的内置词典执行。 您可以切换到AEM拼写检查以使用Adobe Experience Manager的词典，也可以自定义该词典以添加自定义单词列表。 有关自定义AEM词典的详细信息，请在“安装和配置AEM as a Cloud Service”中查看自定义Adobe Experience Manager Guides的默认词典部分。

• 条件

  • 在作者视图中高亮显示条件文本：选择此项以在作者视图中高亮显示条件文本。 使用为条件定义的颜色突出显示条件内容。

  • 使用条件属性进行验证：选择此项以允许验证为属性定义的值。 这样可防止您添加任何不正确的值。

  • 在“主题方案”面板中显示带有标题的键：选择此项可显示主题方案中的键和标题。 如果不选择此选项，则只显示标题。 例如，此处“os”、“audience”和“other”键也会与标题一起显示。

    {width="550"}

  • 在条件面板中显示主题方案：选择此项可在条件面板中查看主题方案。 如果取消选择此选项，则定义的条件将显示在条件面板中。

• 创作

  • 启用全部替换：选择此项以查看​ 查找和替换 ​面板中的​ 全部替换 ​图标。

• 引用
  更改引文样式。 从要在项目中使用的下拉列表中选择引用样式。 有关更多详细信息，请查看更改引文样式。

• AI助手
  选择此项可在Experience Manager Guides中启用AI助手功能。 取消选择可禁用该功能。

元素列表：作为管理员，您可以控制作者可以插入到文件中的元素列表，还可以定义元素的显示名称。 利用元素列表设置，可根据DITA规范指定元素名称以及要使用的标签而不是DITA定义的元素名称：

{width="650"}

属性列表：与元素列表类似，您可以控制要在元素的属性列表中显示的属性列表及其显示名称。 在以下屏幕截图中，只有3个属性已配置为在元素的属性列表中显示：

{width="650"}

使用此设置，当尝试将属性添加到元素时，您只能查看列表中配置的属性列表。

{width="300"}

颜色：显示​ 条件 ​的预配置背景颜色列表。 将条件应用到主题时，用户可以选择背景颜色。 作为管理员，您还可以创建自定义背景颜色并将其添加到列表中。 若要添加新颜色，请在​ 颜色名称 ​字段中输入所需的名称，选择自定义颜色，然后选择​ + ​图标。 自定颜色将显示在颜色列表的末尾。

发布配置文件：这包含可用于发布​ 知识库 ​输出的配置文件。 您可以为目标知识库创建新的用户档案。 例如，Salesforce或ServiceNow。

• 创建Salesforce配置文件

  前提条件

  • 为Salesforce创建连接的应用程序。 有关更多详细信息，请参阅为API集成启用OAuth设置。

  • 配置连接的应用程序时，请确保满足以下条件：

    • 指定回调。

      URL: http://<server name>:<port>/bin/dxml/thirdparty/callback/salesforce

    • 选择以下OAuth范围：

      • 完全访问（完全）
      • 选择通过API (api)管理用户数据

  配置应用程序后，Salesforce会提供​ 使用者密钥 ​和​ 使用者密钥。 这些资源可用于创建Salesforce配置文件。

• 要创建Salesforce配置文件，请从​ 服务器类型 ​下拉列表中选择​ Salesforce ​知识库。 输入配置文件名称。 在​ 站点URL ​中，输入用于发布输出的使用者站点，然后添加由Salesforce使用者站点提供的​ 使用者密钥 ​和​ 使用者密钥。 然后，验证 ​和​ 保存 ​新创建的配置文件。

  在编辑器设置中 {width="550"}

  note note
  NOTE
  要在Experience Manager Guides中配置Salesforce的代理，请使用AEM中的Apache HTTP组件代理配置。 了解如何配置AEM Link Checker的代理。

• 创建ServiceNow配置文件

  前提条件

  配置ServiceNow服务器以上传资产。

  • 连接到​ ServiceNow ​服务器。

  • 导航到​ 系统属性 > 安全性。

  • 取消选中以下选项：

    必须设置此属性以激活用于上传的MIME类型检查（所有版本均为Eureka及更高版本）。 启用(true)或禁用(false)文件附件的mime类型验证。 上载期间将检查通过glide.attachment.extensions配置的文件扩展名是否为MIME类型。

  • 选择​ 保存。

  配置应用后，创建​ ServiceNow ​配置文件。

• 要创建配置文件，请从​ 服务器类型 ​下拉列表中选择ServiceNow知识库。 输入配置文件​ 名称。 在​ ServiceNow URL ​中，输入用于发布输出的使用者网站，然后添加由ServiceNow使用者网站提供的​ 用户名 ​和​ 密码。 然后，验证 ​和​ 保存 ​新创建的配置文件。

  {width="550"}

验证后，您可以在DITA Map的输出预设中选择发布配置文件，并使用它生成到您选择的​ Salesforce ​或​ ServiceNow ​服务器的输出。

了解有关知识库输出预设的更多信息。

验证：此选项卡包含用于在编辑器中配置Schematron验证的选项。 您可以启用以下功能：

• 在保存文件之前运行验证检查：选择此项可在任何保存操作之前使用选定的架构文件运行架构验证。 您可以通过选择+图标来添加Schematron文件。 将列出选定的架构文件。

  note note
  NOTE
  选定的架构文件将在选定的文件夹配置文件中保留。

  在编辑器设置中验证 {width="550"}

  这会阻止用户保存任何违反选定架构文件中定义的规则的文件。 如果未选择此选项，则在保存更改之前不会验证文件。

• 允许所有用户在验证面板中添加架构文件：选择此项可允许用户在编辑器的验证面板中添加任何架构文件。 这允许用户添加Schematron文件，然后针对Schematron文件验证主题。 如果未选择此选项，则编辑器​ 验证面板 ​中的用户无法使用添加模式文件​ 添加模式文件 ​按钮的选项。

显示属性：与“属性”列表一样，您可以控制要在元素的属性列表中显示的属性列表。 默认情况下，四个​ 显示属性 — audience、platform、product和prop已配置为显示在元素的属性列表中。 您还可以使用顶部的​ 添加 ​图标添加显示属性。 您还可以使用​ 删除 ​图标删除任何显示属性。

为元素定义的属性将显示在“布局”和“大纲”视图中。

{width="550"}

翻译：此选项卡包含用于创建语言组、将源标签传播到目标版本以及清理翻译项目的选项。

{width="550"}

• 语言组：作为管理员，您可以创建一组语言，并将它们作为一组用于翻译内容。

  执行以下步骤以创建新语言组：

  1. 选择​ 添加。

  2. 输入语言组名称。 每种语言都应该有一个唯一的名称。 如果名称字段为空或名称不唯一，则可以查看错误。

  3. 从下拉列表中选择语言。 您可以选择多种语言。

     键入语言的前几个字符或语言代码以筛选所需的语言。 例如，键入“en”可筛选名称或代码开头包含“en”的所有语言。

  4. 选择完成图标以将所选语言添加到组。 将显示语言。 添加三种或更多语言时，将显示​ 显示更多 ​选项。 您可以选择​ 显示更多 ​以查看该组中存在的所有语言。

     note tip
     TIP
     将​ 显示更多 ​切换为​ 显示更少 ​并只查看几种语言。

  5. 将鼠标悬停在组中的语言上以编辑 或删除 语言组。

  6. 保存​ 设置。

     note note
     NOTE
     作为用户，您可以查看为文件夹配置文件配置的语言组。

• 将源版本标签传播到目标版本：选择此选项可将源文件版本的标签传递到已翻译的文件。 默认情况下，该选项处于禁用状态。

• 完成后的翻译项目清理：选择此选项可将翻译项目配置为在翻译后自动禁用或删除。 默认情况下，选择​ 无，这样项目在翻译后就会存在。

  如果要稍后使用翻译项目，可以禁用这些项目。 删除项目将永久删除该项目中存在的所有文件和文件夹。

元数据：您可以控制主题的版本元数据及其值显示在​ 版本历史记录 ​对话框中。 在元数据路径中，指定要从中选取元数据的节点的位置。 您还可以将元数据的自定义名称定义为标签。 默认属性为“标题”、“文档状态”和“标记”。

可以从资产的/jcr:content节点下的任何属性中选取元数据，因此您可以将属性的路径添加为元数据路径。

如果元数据路径为空，则会显示错误。 如果将标签留空，则会选取最后一个元素作为标签。

编辑器设置中的 {width="550"}

为​ 版本历史记录 ​对话框配置元数据。

您还可以定义这些元数据标记的显示顺序。 要更改这些标记的默认顺序，请选择虚线将标记拖放到所需位置。
元数据标签在编辑器的​ 版本历史记录 ​对话框中以相同的顺序显示。

合并主题文件

要合并主题中的更改，请执行以下步骤：

1. 在编辑器中打开主题。

2. 选择​ 合并。

   此时将显示“合并”对话框。

   {width="550"}

3. \（可选\） ​您还可以浏览并从存储库中的其他位置选择新文件。

4. 选择要与文件的当前版本进行比较的文件版本。

5. 从“选项”中选择：

   • 跟踪选定版本中的更改：此选项以跟踪的更改形式显示所有内容更新。 然后，您可以选择一次接受或拒绝文档中的更改，或者一次接受或拒绝全部更改。

   • 还原到所选版本：此选项将文档的当前版本还原到所选版本。 此选项不会向您提供对接受或拒绝哪些内容的任何控制。

6. 选择​ 完成。

7. 如果您选择了​ 跟踪来自所选版本 ​的更改选项，则来自所选版本的所有更改将显示在右侧面板的跟踪更改功能中。

   您可以从“跟踪的更改”面板中选择接受或拒绝所有注释，或者接受或拒绝单个注释。

合并映射文件

要合并映射文件中的更改，请执行以下步骤：

1. 在编辑器中打开映射。

2. 选择​ 合并。

   将出现“合并”对话框。

   {width="550"}

3. \（可选\） ​您还可以浏览并从存储库中的其他位置选择新文件。

4. 选择要与文件的当前版本进行比较的文件版本。

5. 从“选项”中选择：

   • 跟踪选定版本中的更改：此选项以跟踪更改的形式显示所有内容更新。 然后，您可以选择一次接受或拒绝文档中的更改，或者一次接受或拒绝全部更改。

   • 还原到所选版本：此选项将文档的当前版本还原到所选版本。 此选项不会向您提供对接受或拒绝哪些内容的任何控制。

6. 选择​ 完成。

7. 如果您选择了​ 跟踪选定版本 ​中的更改选项，则选定版本中的所有更改将显示在“跟踪的更改”面板\（位于右侧\）中。

   您可以从“跟踪的更改”面板中选择接受或拒绝所有更改，或者接受或拒绝映射文件中的单个更改。

选择元素：选择元素的开始或结束标记以选择其内容。

展开或折叠标记：选择标记中的+或 — 符号以展开或折叠标记。

使用上下文菜单：上下文菜单提供剪切、复制或粘贴选定元素的选项。 您还可以在所选元素之前或之后插入元素。 其他选项允许您生成ID或打开选定元素的“属性”面板。

拖放元素：选择元素的标记并将其轻松拖放到文档上。 如果放置位置是允许元素的有效位置，则元素将放置在放置的位置。

当前位置上的有效元素：此列表显示可在当前光标位置本身插入的元素。

当前位置之外的有效元素：列表显示可在元素层次结构中当前元素的任何父元素之后插入的元素。

插入单元格、行或列

在右侧和向下合并单元格

水平或垂直拆分单元格

删除单元格、行或列

生成Id

版本信息显示主题或映射的当前版本。 版本号旁边会显示一个星号(*)，表示未保存的更改。

版本号会随为主题或映射文件创建的每个新版本而更改。 如果您正在处理新创建的文档，则版本信息显示为​ none。

另存为新版本 ​是一个按钮，用于保存您在主题中所做的更改，并创建主题的新版本。

导航到“存储库”视图中所需的文件或文件夹，选择​ 选项 ​图标以打开上下文菜单，然后选择​ 添加到 > 收藏集。 在​ 添加到收藏集 ​对话框中，您可以选择将文件/文件夹添加到现有收藏夹或创建新收藏夹。

{width="300"}

在编辑器中右键单击文件的选项卡以打开上下文菜单。 选择​ 添加到 > 收藏集 ​以将文件添加到收藏夹列表。

DITA文件：您可以查找所选路径中存在的所有​ DITA主题 ​和​ DITA映射。 默认情况下，将选择这些选项。

非DITA文件：您可以在所选路径中搜索​ Ditaval文件、图像文件、多媒体、文档 ​和​ JSON。

{width="300"}

使用快速过滤器搜索 DITA 和非 DITA 文件。

DITA元素：您还可以搜索指定DITA元素的属性中的特定值。

• 选择​ 添加元素 ​以添加元素、属性和值。
• 应用已选择的过滤器。

选择​ 全部清除 ​以清除所有应用的筛选器。

选择​ 关闭筛选器 图标以关闭筛选器并返回到存储库的树视图。

新建：创建新的DITA主题、DITA映射或文件夹。

创建新主题的步骤：

1. 选择​ 新建 > 主题。

2. 显示​ 新建主题 ​对话框。

   {width="300"}

3. 在​ 新建主题 ​对话框中，提供以下详细信息：

   • 主题的标题。

   • \（可选\）*主题的文件名。 根据主题“标题”自动建议文件名。 如果管理员启用了基于UUID设置的自动文件名，则您将不会查看名称字段。

   • 主题所基于的模板。 例如，对于现成的设置，您可以从空白、概念、DITAVAL、引用、任务、主题、Markdown、术语表和故障排除模板中进行选择。 如果您的文件夹配置了文件夹配置文件，则您将仅查看在文件夹配置文件中配置的主题模板。

   • 要保存主题文件的路径。 默认情况下，存储库中当前选定文件夹的路径将显示在路径字段中。

4. 选择​ 创建。该主题在指定的路径中创建。 此外，该主题将在编辑器中打开以进行编辑。

创建新DITA映射的步骤：

1. 选择​ 新建 > DITA映射。

2. 显示​ 新建映射 ​对话框。

   {width="300"}

3. 在​ 新建映射 ​对话框中，提供以下详细信息：

   • 地图的标题。
   • \（可选\） ​映射的文件名。 根据地图标题自动建议文件名。 如果管理员启用了基于UUID设置的自动文件名，则您将不会查看名称字段。
   • 映射所基于的模板。 例如，对于现成的设置，您可以从Bookmap或DITA映射模板中进行选择。
   • 保存映射文件的路径。 默认情况下，存储库中当前选定文件夹的路径将显示在路径字段中。

4. 选择​ 创建。将在路径字段中指定的文件夹中创建并添加映射。 此外，该映射将在“映射”视图中打开。 可以在映射编辑器中打开映射文件并向其中添加主题。 有关将主题添加到映射文件的详细信息，请查看创建映射。 或者，选择​ 在地图控制台中打开 ​以在地图控制台中打开该地图。

创建新文件夹的步骤：

1. 选择​ 新建 > 文件夹。

2. 将显示​ 新文件夹 ​对话框。

   {width="300"}

3. 在​ 新建文件夹 ​对话框中，提供以下详细信息：

   • 文件夹的标题，将自动转换为文件夹名称。
   • 要保存文件夹的路径。 默认情况下，存储库中当前选定文件夹的路径将显示在路径字段中。

4. 选择​ 创建。将在执行“创建文件夹”选项的文件夹中创建并添加文件夹。

上传Assets：将文件从本地系统上传到Adobe Experience Manager存储库中的选定文件夹。 您还可以将文件从本地系统拖放到当前工作主题上。 如果要将本地系统中的图像插入主题，这非常有用。

{width="300"}

您可以选择要上载文件的文件夹，并且还会显示图像预览。 如果要重命名文件，可以在“文件名”文本框中执行此操作。 选择​ 上传 ​以完成文件上传过程。 如果您在某个主题上拖放了图像文件，则该图像文件会添加到文章中，并且也会上传。

如果您的管理员在​ XMLEditorConfig ​中启用了UUID选项，则您将在​ Source ​属性中查看已上传图像的UUID。

在文件夹中查找文件：将焦点转移到可在其中输入搜索词的存储库搜索。 搜索在存储库中的选定文件夹下执行。 也可以应用过滤器返回DITA文件和/或图像文件。

{width="300"}

您也可以使用文件的UUID进行搜索。 在这种情况下，搜索结果显示DITA/XML文件的标题，如果文件是图像文件，则显示文件的UUID。 在下面的搜索示例中，搜索图像文件的UUID，搜索结果显示原始图像文件的UUID和引用该图像的文件的主题标题。

{width="300"}

折叠：折叠存储库中的选定文件夹。

添加到收藏集：将选定的文件夹添加到收藏夹。 您可以选择将其添加到现有收藏集或新收藏集。

刷新：从存储库中获取新的文件和文件夹列表。

在Assets UI中查看：在Assets UI中显示文件夹内容。

编辑：打开文件进行编辑。 对于.ditamap/.bookmap文件，将在映射编辑器中打开该文件以进行编辑。

重复：使用此选项创建所选文件的重复或副本。 您还可以选择在重复资产提示符下重命名重复的文件。 默认情况下，创建文件时使用的后缀\（如filename_1.extension\）。 文件的标题与源文件相同，新文件从版本1.0开始。复制所有引用、标记和元数据，但基线不会复制到重复文件中。

锁定：获取选定文件的锁定以进行编辑。 如果文件已锁定，将鼠标指针悬停在锁定图标上会显示锁定文件​ 。如果您已锁定文件，则显示锁定文件；如果其他用户已锁定文件，则显示锁定文件​ 。锁定文件[用户名]。

预览：获取文件（.dita、.xml、音频、视频或图像）的快速预览而不打开它。 您可以调整预览窗格的大小。 如果内容包含任何<xref>或<conref>，您可以选择它以在新选项卡中打开它。 文件的标题将显示在窗口中。 如果不存在标题，则会显示文件名。 要关闭​ 预览 ​面板，您可以选择关闭图标，也可以选择窗格之外的任意位置。

重命名：使用此选项重命名所选文件。 在​ 重命名资源 ​对话框中输入新文件的名称。

• 您可以重命名任何类型的文件。
• 无法更改文件的扩展名。
• 两个文件的名称不能相同。 因此，不能将文件重命名为已存在的名称。 显示错误。

移动到：使用此选项将所选文件移动到其他文件夹。

• 您可以键入目标文件夹的名称，或选择​ 选择路径 ​以选择目标文件夹。
• 您可以将任何类型的文件移动到“内容”文件夹中的任何目标。
• 两个文件的名称不能相同。 因此，您不能将文件移动到具有相同名称的文件已存在的文件夹中。

如果您尝试将文件移动到某个文件夹，而该文件夹中存在具有相同名称但标题不同的文件，则会显示“重命名和移动文件”对话框，并且您需要在移动文件之前重命名该文件。 目标文件夹中移动的文件具有新文件名。

{width="550"}

排除方案

在以下情况下，Experience Manager Guides不允许重命名或移动文件：

• 如果文件是审阅或翻译工作流的一部分，则无法移动或重命名该文件。

• 如果有任何其他用户锁定该文件，则无法重命名或移动该文件，则不会查看该文件的“重命名”或“移至”选项。

删除：使用此选项删除所选文件。 删除文件之前会显示确认提示。

• 删除文件之前会显示确认提示。

• 如果文件未从任何其他文件引用，则会将其删除，并显示一条成功消息。

• 如果文件被锁定，则无法删除该文件，并会显示一条错误消息。

  note note
  NOTE
  如果管理员阻止删除锁定的文件，则只会显示错误消息。 有关更多详细信息，请参阅安装和配置Adobe Experience Manager Guides as a Cloud Service中的​ 阻止删除签出的文件 ​部分。

• 如果文件已添加到收藏集，则会显示​ 强制删除 ​对话框，您可以强制删除它。

• 如果该文件是从任何其他文件引用的，则会显示带有确认消息的​ 强制删除 ​对话框，您可以强制删除该文件：

  {width="300"}

  note note
  NOTE
  如果管理员已授予文件删除权限，则启用​ 强制删除。 否则，强制删除 ​已禁用，并显示一条消息，指出您无权删除引用的文件。 有关更多详细信息，请参阅安装和配置Adobe Experience Manager Guides as a Cloud Service中的​ 阻止删除引用的文件 ​部分。

• 如果删除了引用的主题并且打开了包含要编辑的引用的文件，则将显示被引用文件的断开链接。

复制：您可以选择以下选项：

• 复制UUID：将所选文件的UUID复制到剪贴板。

• 复制路径：将所选文件的完整路径复制到剪贴板。

添加到：您可以从以下选项中进行选择：

• 收藏集：将选定的文件添加到收藏集。 您可以选择将其添加到现有收藏集或新收藏集。

• 可重用内容：将所选文件添加到左侧面板中的“可重用内容”列表。

属性：使用此项可打开所选文件的属性页。 也可以从Assets UI访问此属性页面，方法是选择文件，然后选择工具栏中的属性图标。

在映射仪表板中打开：如果所选文件是DITA映射，则此选项将打开映射仪表板。

在映射控制台中打开：如果所选文件是DITA映射，则此选项将打开映射控制台。

在氧气中编辑：选择此选项可在氧气连接器插件中编辑所选文件。 将打开文件以进行编辑。

在Assets UI中查看：使用此项在Assets UI中显示.dita/.xml文件的预览。 对于.ditamap/.bookmap文件，映射中的所有主题文件都以单个统一的逐页视图显示。

下载为PDF：使用选项生成并下载PDF输出。

生成：使用选项将映射或映射中的主题发布到站点页面、内容片段或体验片段。