映射视图中的 键 {width="300"}

如果您对映射文件具有编辑权限，则也可以编辑这些文件。 有关通过DITA映射打开和编辑主题的详细信息，请查看通过DITA映射编辑主题。

以下选项可用于映射视图中的映射文件：

  • 在映射控制台中打开：在映射控制台中打开映射文件。
  • 编辑：打开映射文件进行编辑。
  • 选项：打开所选映射文件的上下文菜单。

您可以使用映射文件的“选项”菜单执行以下操作：

地图视图中的 选项菜单

  • 编辑：打开映射文件以在映射编辑器中编辑。

  • 全选：选择映射中的所有文件。

  • 清除选择：取消选择映射中的选定文件。

  • 锁定：获取对映射中所选文件的锁定。

  • 解锁：解锁映射文件并使其可用于编辑。 它不会将更改还原到早期版本。

  • 另存为新版本并解锁：创建较新版本并解除对映射中所选文件的锁定。

  • 预览：打开映射文件的预览。 在此视图中，映射中的所有主题文件都以单个统一的逐页视图显示。

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

    • 复制UUID：将映射文件的UUID复制到剪贴板。
    • 复制路径：将映射文件的完整路径复制到剪贴板。

  • 在存储库中定位：显示映射文件在存储库\（或DAM\）中的位置。

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

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

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

  • 属性：使用此项打开映射文件的属性页。 您还可以从Assets UI访问此属性页面，方法是选择文件并选择工具栏中的属性图标。

  • 打开地图仪表板：打开地图仪表板。

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

  • 下载映射：选择此选项可打开​ 下载映射 ​对话框。

    在​ 下载映射 ​对话框中，您可以选择以下选项：

    使用基线：选择此选项可获取为DITA映射创建的基线列表。 如果要根据特定基线下载映射文件及其内容，请从下拉列表中选择基线。 有关使用基线的更多详细信息，请查看使用基线。

    平面化文件层次结构：选择此选项可将所有引用的主题和媒体文件保存在单个文件夹中。

    您也可以在不选择任何选项的情况下下载映射文件。 在这种情况下，将下载引用的主题和媒体文件的最新保留版本。

    选择​ 下载 ​按钮后，映射导出包请求将排入队列。 如果包创建成功，将显示​ Success ​对话框。 您可以从​ 成功 ​对话框中选择​ 下载 ​按钮。

    如果地图可以下载，您将收到地图下载就绪通知。 如果下载失败，您将收到映射下载失败的通知。

    您可以从Adobe Experience Manager通知收件箱访问下载链接。 在收件箱中选择生成的映射通知，以.zip格式下载映射。

    note note
    NOTE
    默认情况下，下载的地图会在Adobe Experience Manager通知收件箱中保留五天。

  • 关闭映射上下文：关闭映射文件。

以下屏幕截图显示了映射视图中文件的“选项”菜单：

您可以使用“选项”菜单执行以下操作：

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

  • 锁定：锁定所选文件。 对于锁定的文件，此选项将更改为​ 解锁。

    note note
    NOTE
    • 如果用户锁定了文件，将鼠标指针悬停在锁定图标上会显示已锁定文件的用户(name)。
    • 签入文件时，会提示您保存更改。 如果不保存更改，则它仅签入文件。

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

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

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

  • 在存储库中定位：显示所选文件在存储库\（或DAM\）中的位置。

  • 全部展开：展开映射文件中的所有主题。

  • 全部折叠：折叠属于当前映射文件的所有主题。

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

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

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

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

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

  • 生成：为站点页面、内容片段或体验片段上的选定文件生成输出。

NOTE
您还可以从“引用”下的​ 更多选项 ​菜单打开和编辑DITA映射中选定主题的属性。

可重用内容

DITA的主要功能之一是能够重用内容。 可重用内容 ​面板可以存储您的DITA文件，通常可以从其中插入可重用内容。 添加后，DITA文件会保留在跨会话的可重用内容面板中。 这意味着您无需再次添加DITA文件即可稍后访问它们。

您只需将面板中的可重用内容拖放到当前主题上即可轻松快速地插入该主题。 您还可以在将内容插入文档之前获得该内容的预览。

默认情况下，您可以按标题查看文件。 当您将鼠标悬停在文件上时，您可以作为工具提示查看文件标题和文件路径。

NOTE
作为管理员，您还可以选择在编辑器中按文件名查看文件列表。 在​ 用户首选项 ​中选择​ 编辑器文件显示配置 ​节的​ 文件名 ​选项。

要将DITA文件添加到可重用内容面板，请使用以下任意方法：

  • 选择可重用内容旁边的​ + ​图标以打开浏览文件对话框。 选择要添加的文件，然后选择​ 添加 ​以完成该过程。

  • 在“存储库”视图中，选择所需文件的​ 选项 ​图标，然后从上下文菜单中选择​ 添加到 > 可重用内容。

  • 右键单击编辑器中的文件选项卡以打开上下文菜单，然后选择​ 添加到 > 可重用内容。

添加文件后，您可以在可重用内容面板中查看文件中的所有可重用内容元素。 可重用内容及其ID和元素名称一起显示。

将文件添加到可重用内容列表时，将显示文件的标题而不是文件的UUID。 要检查文件的UUID，请将鼠标悬停在文件的标题上，文件的UUID将显示在工具提示中。

{width="400"}

NOTE
您可以将多个文件添加到可重用内容列表。 然后，您可以将可重用内容面板中的所需内容插入到文档中。

刷新：重新检查所有可重用内容，并显示可重用内容的新列表。

要从“可重用内容”面板插入内容，请使用以下任意方法：

  • 将鼠标指针悬停在要插入的元素上，选择​ 选项 ​图标，然后从下拉列表中选择​ 插入可重用内容。

    {width="400"}

    note note
    NOTE
    选择一个文件，然后从​ 选项 ​菜单中选择​ 预览 ​以预览文件而不打开它。 也可以预览主题中显示的引用。 参照ID会显示在窗口中。
    预览 ​选项也可在元素的​ 选项 ​菜单中使用，该选项可在插入元素之前快速预览该元素。

  • 从面板中将可重用内容项拖放到文档中的所需位置。

大纲

当您选择​ 大纲 ​图标时，您将获得文档中所用元素的分层视图。

{width="300"}

“大纲”视图提供以下功能：

  • 文档中使用的所有元素的树视图。

  • 如果元素具有ID、属性和文本，则可以在查看元素的同时查看它们。

  • 在创作视图和Source视图中访问“大纲”视图。

  • 使用筛选器下拉列表显示所有元素或仅显示损坏的引用：

  • 在“大纲”视图中选择元素时，会在“创作”或“Source”视图中选择该元素的内容。 “大纲”视图与“创作”视图和“Source”视图保持同步。 如果在任何视图中进行了任何更改，则可以在“大纲”视图中查看这些更改。 例如，如果在“创作”视图中添加段落或更新元素，则它将显示在“大纲”视图中。

    {width="650"}

  • 拖放元素。 您可以通过将另一个元素拖放到元素上来轻松替换元素。 如果将元素拖放到另一个元素上，并查看元素周围的虚线矩形框，则表示元素将被替换。 它会替换元素被放置到的元素。

    如果拖放元素，则虚线矩形表示元素可以放置在当前位置。 如果拖放无效，则会显示一条错误消息，指示不允许执行该操作。

  • 大纲 ​视图中的​ 选项 ​菜单允许您执行常规操作，例如，剪切、复制、删除、生成ID、在当前元素之前或之后插入元素、重命名或替换元素、包装元素、取消包装元素，以及从所选元素创建代码片段。

NOTE
有关生成ID、在当前元素之前或之后插入元素以及取消元素包装的详细信息，请查看编辑器中的其他功能。

查看配置

使用​ 查看配置 ​选项，您可以选择查看以下内容：

  • 显示ID：显示元素的ID。
  • 显示属性：显示该属性及其值。
  • 显示文本：显示文本。 如果文本长度超过20个字符，则会显示省略号。

如果块元素具有其自身的文本，则该文本将与该块元素一起显示。 如果它没有自己的文本，则第一个子元素的文本将与该块元素一起显示。

{width="550"}

如果管理员为属性创建了配置文件，则您将获得这些属性及其配置的值。 您还可以在​ 设置 ​的​ 显示属性 ​选项卡下分配管理员配置的显示属性。 为元素定义的属性将显示在“布局”和“大纲”视图中。

有关更多详细信息，请在左侧面板部分中查看​ 设置 ​功能描述中的​ 显示属性。

搜索功能

使用搜索功能，您可以按元素的名称、ID、文本或属性值搜索元素。

搜索不区分大小写，并完全匹配字符串。 搜索结果根据元素在文档中的位置排序。

如果字符串显示在​ 大纲 ​视图中，则可以搜索元素中的字符串。 例如，如果字符串“Adobe”出现在元素的文本中，并且显示在“大纲视图”面板中（因为您已从“视图选项”下拉列表中选择​ 显示文本），则筛选包含的元素。 但是，如果“大纲视图”面板中未显示文本（因为您尚未从“视图选项”下拉列表中选择​ 显示文本），则不会过滤包含的元素。 同样，如果您已选择ID或属性，则您将在ID或属性中找到字符串。

术语表

通过Experience Manager Guides，您可以轻松创建和使用术语表类型文档。 您可以创建术语表主题文件，然后将其包含在通用术语表映射中。 将此映射添加为根映射后，术语表条目将显示在“术语表”面板中。

{width="650"}

要从术语表中插入术语，只需将该条目从面板拖放到主题中的所需位置即可。 通过词汇表术语的“选项”菜单，您可以快速获取条目术语的​ 预览、条目术语文件的​ 复制路径 ​或在存储库中查找条目术语文件。

执行以下步骤以搜索文本词并将其替换为术语表缩写：

  1. 打开要在其中搜索和转换文本或术语的DITA主题或映射。
  2. 选择术语表面板以查看根映射中存在的术语表。 您可以拖放这些术语以将其添加到打开的主题。
  3. 在“术语表”面板中选择​ 热点 ​工具( )以搜索特定文本术语并将它们转换为链接的术语表缩写。 此外，您也可以使用它来搜索词汇表缩写并将它们转换为文本术语，反之亦然。

您可以配置“热点”工具的以下设置：

{width="300"}

  • 词汇表键：从选定主题中要用于搜索的DITA映射中选择词汇表键。 选定的键将显示如下。 您可以通过选择​ 删除 ​图标来删除选定的键。

  • 主题：选择在编辑器中打开的​ 当前主题、当前映射中的所有​ 打开的主题 ​或在映射编辑器中编辑的​ 当前映射 ​以搜索术语。

  • 按状态筛选主题：您可以选择将搜索限制在具有选定文档状态的主题。 主题可以处于“草稿”、“编辑”、“正在审阅”、“已批准”、“已审阅”、“已完成”状态或组织配置的任何一种状态。

  • 操作：您可以选择手动搜索每个主题的词汇键​ 或 ​自动搜索所有主题​ 。 ​如果您为每个主题选择​ 手动，它会提示您先确认，然后再转换每个主题中的每个术语。 如果您为所有主题选择​ 自动，它将自动转换所有主题中的所有术语。

  • 转换：您可以将搜索的​ 文本转换为术语表 ​或​ 术语表转换为文本。

  • 选项：您可以从以下选项中进行选择：

    • 区分大小写的匹配项：搜索词以查找大小写相同的匹配项。 例如，“USB”与“usb”不匹配。
    • 仅转换第一个实例：如果某个主题中存在搜索词的多个实例，则仅转换第一个实例。
    • 在转换之前锁定文件：搜索的文件在转换术语之前被锁定。
    • 在转换后创建新版本：在术语转换完成之后创建主题的新版本。

  • 如果您为每个主题​ 选项选择 ​手动，则会显示​ 下一步 ​按钮。 选择​ 下一步 ​以根据所选设置转换每个主题的术语。 它会提示您转换每个主题中的术语并移到下一个文件。 您可以选择转换术语或跳过它并移到下一个术语。

    {width="300"}

  • 如果选择​ 自动为所有主题 ​选项，将显示​ 转换 ​按钮。 选择​ 转换 ​以将文档中找到的所有术语转换为链接的术语缩写。

显示已更新的​ 主题 ​的列表，其中包含已转换的术语和​ 出错的主题。 将鼠标悬停在有错误的主题旁边的信息图标上，以查看错误的详细信息。

NOTE
刷新主题以查看转换后的术语。

条件

“条件”面板显示管理员在全局或文件夹级别配置文件中定义的条件属性。 只需将所需条件拖放到内容中，即可将条件添加到内容中。 为便于识别，使用为条件定义的颜色突出显示条件内容。

您还可以通过在元素上拖放多个条件来对元素应用多个条件。 对一个元素应用多个条件时，“属性”面板显示应用的条件（以逗号分隔）。

但是，在代码视图中，使用空格分隔符分隔条件。 在代码视图中添加或编辑条件时，请确保使用空格分隔多个条件。

IMPORTANT
以下屏幕截图显示具有管理权限的用户。 作为具有管理权限的用户，您可以添加、编辑和删除条件。 否则，作为普通作者，您将只能选择应用条件。

要添加或定义条件，请选择“条件”面板旁边的+图标以显示“定义条件”对话框：

{width="400"}

从“属性”列表中，选择要定义的条件属性，输入条件的值，然后指定在“条件”面板中显示的标签。 为条件定义组。 您可以将多个条件添加到组。 您还可以定义条件的颜色。 此颜色将设置为应用条件的内容的背景颜色。

您可以将条件分组并在嵌套文件夹中对其进行结构。 群组可帮助您在多个级别创建条件，并更好地组织这些条件以用于内容。

例如，您可以创建产品的条件组，如​ Acrobat ​和​ AEM Guides。 可以为两个组选择条件属性。 在每个组下，您可以具有特定值，如​ User、Admin、Reviewer ​和​ Author。

NOTE
键入以创建新组，或为特定属性选择现有组。

您可以使用/并定义子组，如AEM Guides/Cloud Service。

以嵌套层次结构组织的 条件 {width="300"}

要编辑条件，请从“选项”菜单中选择​ 编辑。 此时将显示“编辑条件”对话框：

{width="400"}

以定义新条件时配置的方式指定详细信息。

主题方案

主题方案映射是一种特殊形式的DITA映射，用于定义分类主题和控制值。 根据要求，您可以创建一个主题方案映射，并在根映射文件中引用它。 Experience Manager Guides允许您定义主题方案中主题定义的嵌套级别层次结构。

您可以轻松地创建主题方案，然后在主题方案图中使用主题方案。 将此映射添加为根映射后，主题方案将显示在“主题方案”面板中。 “主题方案”面板以嵌套或分层方式显示可用的主题方案。

Experience Manager Guides还支持嵌套级别主题方案映射，并且您可以在根主题方案映射下定义多个主题方案。

以下示例演示了如何在Experience Manager Guides中使用主题方案。

  1. 在您选择的工具中创建主题方案文件。 以下XML代码创建绑定platform属性的值的主题方案。
<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "subjectScheme.dtd">
    <subjectScheme id="GUID-4f942f63-9a20-4355-999f-eab7c6273270">
        <title>rw</title>
        <!-- Define new OS values that are merged with those in the unixOS scheme -->
        <subjectdef keys="os">
            <subjectdef keys="linux">    </subjectdef>
            <subjectdef keys="mswin">    </subjectdef>
            <subjectdef keys="zos">    </subjectdef>
        </subjectdef>
        <!-- Define application values -->
        <subjectdef keys="app" navtitle="Applications">
            <subjectdef keys="apacheserv">    </subjectdef>
            <subjectdef keys="mysql">    </subjectdef>
        </subjectdef>
        <!-- Define an enumeration of the platform attribute, equal to       each value in the OS subject. This makes the following values       valid for the platform attribute: linux, mswin, zos -->
        <enumerationdef>
            <attributedef name="platform">    </attributedef>
            <subjectdef keyref="os">    </subjectdef>
        </enumerationdef>
        <!-- Define an enumeration of the otherprops attribute, equal to       each value in the application subjects.       This makes the following values valid for the otherprops attribute:       apacheserv, mysql -->
        <enumerationdef>
            <attributedef name="otherprops">    </attributedef>
            <subjectdef keyref="app">    </subjectdef>
        </enumerationdef>
    </subjectScheme>

{width="300"}

  1. 保存扩展名为a.ditamap的文件，并将其上传到DAM中的任何文件夹。

    note note
    NOTE
    可以在父DITA映射中添加对主题方案文件的引用。

    {width="550"}

  2. 在​ 用户首选项 ​中将父映射设置为根映射。 将此映射添加为根映射后，主题方案将显示在“主题方案”面板中。

    {width="650"}

  3. 在编辑器中，打开要使用主题方案定义的文件。

  4. 只需将所需的主题方案拖放到内容上，即可将主题方案应用于您的内容。 然后，内容会以定义的颜色突出显示。

处理主题定义和枚举的分层定义

除了处理同一映射中存在的枚举和主题定义外，Experience Manager Guides还提供了在两个单独的映射中定义枚举和主题定义的功能。 您可以在映射中定义一个或多个主题定义，在另一个映射中定义枚举定义，然后添加映射引用。 例如，以下XML代码在两个单独的映射中创建主题定义和枚举定义。

在subject_scheme_map_1.ditamap中定义了主题定义

<?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "../dtd/libs/fmdita/dita_resources/DITA-1.3/dtd/subjectScheme/dtd/subjectScheme.dtd">
    <subjectScheme id="subject-scheme.ditamap_f0bfda58-377b-446f-bf49-e31bc87792b3">

    <title>subject_scheme_map_1</title>

    <subjectdef keys="os" navtitle="Operating system">
        <subjectdef keys="linux" navtitle="Linux">
        <subjectdef keys="redhat" navtitle="RedHat Linux">
        </subjectdef>
        <subjectdef keys="suse" navtitle="SuSE Linux">
        </subjectdef>
        </subjectdef>
        <subjectdef keys="windows" navtitle="Windows">
        </subjectdef>
        <subjectdef keys="zos" navtitle="z/OS">
        </subjectdef>
        </subjectdef>
        <subjectdef keys="deliveryTargetValues">
        <subjectdef keys="print">
        </subjectdef>
        <subjectdef keys="online">
        </subjectdef>
    </subjectdef>
    <subjectdef keys="mobile" navtitle="Mobile">
        <subjectdef keys="android" navtitle="Android">
        </subjectdef>
        <subjectdef keys="ios" navtitle="iOS">
    </subjectdef>
    </subjectdef>
    <subjectdef keys="cloud" navtitle="Cloud">
        <subjectdef keys="aws" navtitle="Amazon Web Services">
        </subjectdef>
        <subjectdef keys="azure" navtitle="Microsoft Azure">
        </subjectdef>
        <subjectdef keys="gcp" navtitle="Google Cloud Platform">
        </subjectdef>
    </subjectdef>
    </subjectScheme>

枚举定义存在于中 subject_scheme_map_2.ditamap。

<?xml version="1.0" encoding="UTF-8"?>
        <!DOCTYPE subjectScheme PUBLIC "-//OASIS//DTD DITA Subject Scheme Map//EN" "../dtd/libs/fmdita/dita_resources/DITA-1.3/dtd/subjectScheme/dtd/subjectScheme.dtd">
        <subjectScheme id="subject-scheme.ditamap_17c433d9-0558-44d4-826e-3a3373a4c5ae">
        <title>subject_scheme_map_2</title>
        <mapref format="ditamap" href="subject_scheme_map_1.ditamap" type="subjectScheme">
        </mapref>
        <enumerationdef>
        <attributedef name="platform">
        </attributedef>
        <subjectdef keyref="mobile">
        </subjectdef>
        <subjectdef keyref="cloud">
        </subjectdef>
        </enumerationdef>
        </subjectScheme>

此处主题定义是在subject_scheme_map_1.ditamap中定义的，而枚举定义则存在于subject_scheme_map_2.ditamap中。 对subject_scheme_map_1.ditamap的引用也已添加到subject_scheme_map_2.ditamap中。

NOTE
由于subject_scheme_map_1.ditamap和subject_scheme_map_2.ditamap相互引用，因此主题方案已解析。

主题枚举引用按以下优先级顺序解析：

  1. 相同映射
  2. 引用的映射

如果在同一映射和引用的映射中未找到枚举，则不会解析引用。

将值限制为特定元素

您也可以将条件限制为主题中的某些元素。 使用<elementdef>标记定义元素，使用<attributedef>标记定义可以应用于元素的条件。 如果不添加<elementdef>标记，则可以将条件应用于所有元素。
例如，使用以下枚举将@platform属性限制为<shortdesc>元素。 其他条件对于所有元素均可见。

<enumerationdef>
    <elementdef name="shortdesc">
    </elementdef>
    <attributedef name="platform">
    </attributedef>
    <subjectdef keyref="deliveryTargetValues">
    </subjectdef>
    <subjectdef keyref="os">
    </subjectdef>
  </enumerationdef>

属性 ​下拉列表

您还可以使用​ 作者 ​视图中​ 内容属性 ​面板的​ 属性 ​下拉菜单更改主题方案的值。

执行以下步骤以更改值：

  1. 从​ 属性 ​下拉列表中选择一个属性。
  2. 选择​ 编辑。
  3. 从​ 值 ​下拉列表中选择所需的值。
  4. 选择​ 更新。

您还可以通过从下拉列表中选择多个值来应用属性的值。

Source视图

您还可以从Source视图中的属性下拉列表中更改值。 Source视图还可防止您添加任何不正确的值。

{width="550"}

从条件面板查看并应用主题方案

您还可以从“条件”面板查看和应用主题方案。

若要从“条件”面板查看主题方案，系统管理员必须在“设置”的“常规”选项卡下选择​ 在条件面板中显示主题方案 ​选项。 有关更多详细信息，请查看选项卡栏中的​ 设置 ​部分。

“条件”面板显示主题方案中的主题定义的扁平垂直结构。

通过将所需条件拖放到内容中，可以向内容添加条件。 使用为条件定义的颜色突出显示条件内容。

代码片段

片段是小型内容片段，可在文档项目的各种主题中重复使用。 “代码片段”面板会显示您已创建的内容代码片段的集合。 要插入代码片段，请将面板中的代码片段拖放到主题中的所需位置。 “代码片段”面板允许您添加、编辑、删除、预览和插入代码片段。

IMPORTANT
以下屏幕截图显示具有管理权限的用户。 作为具有管理权限的用户，您可以添加、编辑和删除代码片段。 否则，作为普通作者，您将只获得预览和插入代码片段的选项。

要添加代码片段，请使用以下任一方法：

  • 选择代码片段旁边的​ + ​图标以打开​ 新建代码片段 ​对话框。

    {width="300"}

    在“新建代码片段”对话框中，提供显示在“代码片段”面板中的标题、说明以及要创建的代码片段内容的XML代码。 选择​ 创建 ​以保存并创建代码片段。

  • 在内容编辑区域中，右键单击要用作代码片段的元素的痕迹导航，然后从上下文菜单中选择​ 创建代码片段。 此时将显示“新建代码片段”对话框，并在​ Content ​字段中填充了选定元素的XML代码。 输入该代码片段的​ Title ​和​ Description，然后选择​ Create ​保存该代码片段。

  • 在内容编辑区域中，右键单击要用作代码片段的内容的任意位置，然后从上下文菜单中选择​ 创建代码片段。 此时将显示“新建代码片段”对话框，并在​ Content ​字段中填充了选定元素的XML代码。 输入该代码片段的​ Title ​和​ Description，然后选择​ Create ​保存该代码片段。

    以下屏幕截图突出显示痕迹导航和内容区域，您可以从中调用上下文菜单。

    {width="350"}

要插入代码片段，请使用以下任一方法：

  • 从“代码片段”面板中选择一个代码片段，并将其拖放到主题中的所需位置。

  • 将插入点放置在要插入代码片段的位置，从所需代码片段的“选项”菜单中选择“插入代码片段”。

NOTE
从代码片段条目的上下文菜单中，您还可以选择编辑、删除、获取预览或插入代码片段。

模板

“模板”面板仅对管理员可用。 使用此面板，管理员可以轻松创建和管理随后可供作者使用的模板。 默认情况下，模板在​ 映射 ​和​ 主题 ​类型模板下分类。

{width="300"}

默认情况下，您可以按标题查看文件。 当您将鼠标悬停在模板上时，可以像工具提示一样查看文件标题和文件名。

NOTE
作为管理员，您还可以选择在编辑器中查看文件列表。 在​ 用户首选项 ​中选择​ 编辑器文件显示配置 ​节的​ 文件名 ​选项。

要了解如何创建自定义模板，请查看基于自定义模板创建映射。

引用

在Experience Manager Guides中，您可以添加和导入引用，并将它们应用于您的内容。 您可以从任何书籍、网站和日记帐来源添加这些引文。

有关详细信息，请查看添加和管理内容中的引文。

语言变量

Experience Manager Guides提供了在本机PDF输出中使用语言变量的功能。 您可以使用语言变量在PDF输出中定义本地化字符串，或在输出模板中本地化任何静态文本。 您可以使用CSS样式将来自CSS的字符串本地化。

有关详细信息，请查看对语言变量的支持。

变量

Experience Manager Guides允许您创建和管理变量以供本机PDF发布。 有关详细信息，请在PDF输出🔗中查看变量。

查找并替换

查找和替换图标位于左侧面板的底部。 “查找和替换”面板允许您在映射或存储库内的文件夹中的文件间搜索和替换文本。 您可以查找和替换地图的所有主题以及地图内子地图中存在的主题。

默认情况下，您可以按标题查看文件。 当您将鼠标悬停在文件上时，您可以作为工具提示查看文件标题和文件路径。

NOTE
作为管理员，您还可以选择在编辑器中查看文件名列表。 在​ 用户首选项 ​中选择​ 编辑器文件显示配置 ​节的​ 文件名 ​选项。

要执行全局搜索和替换，请执行以下步骤：

  1. 打开全局​ 查找和替换 ​面板。

  2. 选择​ 查找 ​下拉列表并选择以下选项之一来执行搜索。

    • 当前映射：要在当前打开的映射中搜索

      note note
      NOTE
      如果已打开映射进行编辑，则会显示此选项。

    • 路径：要在所选路径上搜索

    • 选择映射：要在所选映射中搜索

  3. 您可以使用​ 选项 ​下拉菜单并从以下选项中进行选择：

    • 在替换前锁定文件：如果要在替换搜索词前自动锁定文件，请选择此选项。 如果您的管理员启用了配置以在编辑之前锁定文件，则此设置更相关。 启用后端设置后，您应该选择此选项。 它将阻止文件锁定对话框在做出任何更改之前提示您锁定每个文件。 如果不选择此选项，则在打开文件进行编辑之前将显示提示。

    • 仅限全字：如果要搜索整个搜索字符串，请选择此选项。 例如，如果在搜索字符串中输入over，则搜索结果将返回包含单词（如over和overview）的所有文件。 如果要限制搜索以返回输入的确切搜索词，请选择此选项。

    • 在替换后创建新版本：如果要创建主题的新版本，并且选择替换文本，请选择此选项。 您还可以提供版本注释，这些注释将随每个更新的文件一起添加。

      如果不选择此选项，则更改将保存在主题的当前版本中，并且不会创建新版本。

    • 包括间接引用：如果要同时在DITA映射中搜索间接引用中的字符串，请选择此选项。 默认情况下，这是禁用的，因此仅对直接引用执行搜索。

  4. 输入要查找的搜索词或文本。

  5. 输入要替换搜索词的文本。

  6. 按Enter或选择​ 搜索 ​图标( )以执行搜索。

  7. 从搜索结果列表中选择文件。 文件在内容编辑区域中打开，搜索词在内容中突出显示。

  8. 选择​ 替换单个匹配项 ( )以替换主题中当前突出显示的搜索词，或者选择“下一个匹配项 ”或“上一个匹配项 ”以移动到文本的下一个或上一个匹配项。

  9. 选择​ 全部替换 ( )可在单击时使用替换项替换单个文件中搜索项的所有匹配项。 替换选定文件中的所有匹配项后，您将看到通知。

要启用​ 全部替换 ​图标，系统管理员必须在​ 设置 ​的​ 常规 ​选项卡下选择选项​ 启用全部替换。

NOTE
将鼠标悬停在搜索结果列表中的文件上，可在文件右侧查看全部替换文件图标。 您还可以获得“忽略文件”图标以从搜索结果中删除文件。 您忽略的文件将从列表中删除，搜索词不会替换在其中。

在整个系统中，一次只能执行一项“全部替换”操作，并且在执行操作之前，您将看到“全部替换”状态。 您还可以中止之间的替换所有操作或查看日志报告。 如果中止该操作，您将在收件箱中收到关于该操作的通知。 替换选定文件中的所有匹配项后，您将看到成功通知。

{width="300"}

您还可以使用映射的​ 选项 ​菜单中的​ 在映射中查找 ​选项来查找和替换映射中的文本。 对于在存储库面板或映射视图中打开的映射，将显示此选项。

{width="550"}

PDF模板

使您能够使用各种PDF模板。 有关详细信息，请查看PDF模板。

审查

Experience Manager Guides提供用于显示项目中所有审阅任务的功能。 您可以在​ 审阅 ​面板中查看您所属的审阅项目中的所有审阅项目和活动审阅任务。 然后，可打开审阅任务以查看各种审阅人的注释。

审阅面板显示审阅任务。 默认情况下，您可以按标题查看文件。 当您将鼠标悬停在文件上时，您可以作为工具提示查看文件标题和文件路径。

NOTE
作为管理员，您还可以选择在编辑器中按文件名查看文件列表。 在​ 用户首选项 ​中选择​ 编辑器文件显示配置 ​节的​ 文件名 ​选项。

作为作者，您可以使用编辑器在主题中处理注释。

要在项目中存在的活动审阅任务中查看审阅注释，请执行以下步骤：

  1. 在左侧面板中选择审阅。 将打开​ 审阅 ​面板。 系统将显示您所属的审阅项目中的所有审阅项目和活动审阅任务。

    {width="300"}

  2. 选择一个审阅项目，然后从列表中选择一个审阅任务以将其打开。

  3. 您还可以按以下方式筛选项目：

    • 在项目标题中输入要查找的搜索词或文本。 然后按Enter键执行搜索。 例如，您可以搜索标题中包含“空间”一词的所有项目。

    • 选择 以打开​ 筛选器 ​对话框。 您可以选择所有项目，也可以仅选择特定项目。 选定的项目列在​ 审核 ​面板中。

      {width="300"}

      启用​ 由我启动的任务 ​选项以仅查看您已启动的任务。 即使在刷新页面后，此选项的切换状态也会保持不变。 启用​ 仅显示活动任务 ​选项以筛选项目列表以显示当前活动的任务。

  4. 默认情况下，在审阅项目中，您将查看包含与其关联的注释的主题平面列表。 应用左边栏中的必需过滤器，以根据主题中显示的审核注释过滤主题：

    • 查看所有主题：列出项目中存在的所有主题。
    • 查看包含评论的主题：仅列出包含评论的主题。

  5. 您还可以输入要在主题标题或文件路径中查找的搜索词或文本。 标题或文件路径中包含术语的主题将列出。

  6. 双击任何主题以在创作视图中将其打开。 您可以在​ 注释 ​面板中查看注释。

    note note
    NOTE
    审阅 ​面板和​ 评论 ​面板始终同步。 在“注释”面板中，会根据“审阅”面板中加载的审阅任务来加载注释。
    您可以在审核面板的左边栏中查看已关闭的审核任务以及活动的审核任务。
    此外，对于已关闭的审阅任务，您可以在右侧的“注释”面板中查看审阅注释，但​ 导入注释 ​和​ 还原版本 ​按钮已禁用。
    有关如何处理评论的详细信息，请查看地址审核评论。

内容编辑区域

内容编辑区域是显示主题或地图内容的地方。 在此区域中进行所有内容编辑。 它为您正在编辑的内容提供WYSIWYG视图。

在内容编辑区域的左下方，您有当前光标位置处的元素的痕迹导航。 在右下角，将显示可用的编辑器视图。

要了解有关内容编辑区域中主题文件可用的编辑器视图的详细信息，请查看编辑器视图。

NOTE
如果您正在处理映射文件，则内容编辑区域将显示不同的选项或视图，包括映射文件的​ 布局 ​视图。 有关详细信息，请查看映射编辑器功能。

右面板

右侧面板包含有关当前选定文档的信息。

NOTE
右侧面板的大小可调。 要调整面板的大小，将光标置于面板边界上，光标将变为双向箭头，选择并拖动以调整面板宽度。

通过右侧面板，可访问以下功能：

内容属性

通过选择右侧面板中的​ 内容属性 ​图标，可以访问​ 内容属性 ​功能。 内容属性 ​面板包含有关文档中当前选定元素的类型及其属性的信息。

类型：您可以查看并从下拉列表中为当前标记选择完整层次结构的标记。

属性： 属性 ​下拉面板在布局、创作和Source视图中可用。 您可以轻松地添加、编辑或删除属性。

  1. 选择​ 添加。

    内容属性中的 属性 {width="300"}

  2. 在​ 属性 ​下拉面板中，从下拉列表中选择属性并指定属性的值。 然后选择​ 添加。

    具有多个属性的 属性面板 {width="300"}

  3. 要编辑属性，请将鼠标悬停在它上并选择​ 编辑 编辑图标 。

  4. 要删除属性，请将鼠标悬停在该属性上并选择​ 删除 删除图标 。

NOTE
即使您的主题包含引用的内容，也可以使用属性面板在主题中添加属性。

如果管理员为属性创建了配置文件，则您将获得这些属性及其配置值。 使用“内容属性”面板，您可以选择这些属性，并将它们分配给主题中的相关内容。 这样您也可以创建条件内容，然后将其用于创建条件输出。 有关使用条件预设生成输出的详细信息，请查看使用条件预设。

文件属性

选择右侧面板中的“文件属性”图标，查看所选文件的属性。 “文件属性”功能在所有四种模式或视图中均可用：“布局”、“创作”、“Source”和“预览”。

“文件”属性包含以下两个部分：

常规

通过“一般信息”部分可以访问以下功能：

file-properties {width="300"}

  • 文件名：显示所选主题的文件名。 文件名超链接至选定文件的属性页。
  • ID：显示所选主题的ID。
  • 标记：这些是主题的元数据标记。 它们是从属性页面中的标记字段设置的。 您可以键入或从下拉菜单中选择它们。 标记显示在下拉列表下方。 要删除标记，请选择标记旁边的交叉图标。
  • 编辑更多属性：您可以从文件属性页面编辑更多属性。
  • 语言：显示主题的语言。 在属性页面的语言字段中设置。
  • 创建日期：显示创建主题的日期和时间。
  • 修改日期：显示修改主题的日期和时间。
  • 锁定者：显示锁定主题的用户。
  • 文档状态：您可以选择并更新当前已打开主题的文档状态。 有关详细信息，请查看文档状态。
NOTE
您可以将“文件”属性中各个字段的属性值复制到剪贴板。

引用

利用“参照”部分，可访问以下功能：

{width="300"}

  • 用于： Used in references列出引用或使用当前文件的文档。
  • 传出链接： ​传出链接列出当前文档中引用的文档。

默认情况下，您可以按标题查看文件。 当您将鼠标悬停在文件上时，您可以作为工具提示查看文件标题和文件路径。

NOTE
作为管理员，您还可以选择在编辑器中按文件名查看文件列表。 在​ 用户首选项 ​中选择​ 编辑器文件显示配置 ​节的​ 文件名 ​选项。
NOTE
所有“在中使用”和“传出”引用均超链接到文档。 您可以轻松打开和编辑链接的文档。

除了打开文件之外，您还可以使用“引用”部分中的​ 选项 ​菜单执行许多操作。 您可以执行的某些操作包括编辑、预览、复制UUID、复制路径、添加到收藏集、属性。

审查

选择“审阅”图标将打开审阅面板，您可以在其中为当前打开的文档选择审阅任务并查看注释。

{width="300"}

如果创建了多个“审阅”项目，则可以从下拉列表中选择一个项目并访问审阅注释。

使用“审阅”面板，您可以查看和发布对主题评论的回复。 您可以逐一接受或拒绝注释。

NOTE
注释框和回复框支持多行条目，允许用户根据需要扩展注释框，以提供全面的注释以及对注释的详细回复。 在撰写评论或回复时，您可以使用​ Shift + Enter ​转到下一行。

有关详细信息，请查看地址审核注释。

跟踪更改

使用右侧面板的跟踪更改功能，可以查看文档中所做所有更新的信息。 您还可以搜索对文档所做的任何特定更新。

NOTE
跟踪更改功能显示已使用选项卡栏的启用/禁用跟踪更改功能跟踪的所有更新。

模式管

“架构”是指用于定义XML文件测试的基于规则的验证语言。 该编辑器支持Schematron文件。 您可以导入Schematron文件，也可以在编辑器中编辑它们。 使用Schematron文件，您可以定义某些规则，然后针对DITA主题或映射验证这些规则。

了解如何在Experience Manager Guides中使用Schematron文件，请参阅支持Schematron文件。

父主题： 编辑器简介

recommendation-more-help