配置富文本编辑器插件

RTE功能通过一系列插件提供，每个插件都具有features属性。 您可以配置一个或多个RTE功能，以启用或禁用该功能属性。 本文介绍了如何具体配置RTE插件。

有关其他RTE配置的详细信息，请参阅配置富文本编辑器。

激活插件并配置功能属性

要激活插件，请执行以下步骤。 仅当您首次配置插件时，才需要执行某些步骤，因为相应的节点不存在。

默认情况下，RTE中会启用format、link、list、justify和control插件及其所有功能。

1. 使用CRXDE Lite，找到项目的文本组件。

2. 在配置任何RTE插件之前，创建<rtePlugins-node>的父节点（如果不存在）：

   • 根据您的组件，父节点包括：

     • config: .../text/cq:editConfig/cq:inplaceEditing/config
     • 备用配置节点：.../text/cq:editConfig/cq:inplaceEditing/inplaceEditingTextConfig
     • text: .../text/dialog/items/tab1/items/text

   • 类型为：jcr:primaryType cq:Widget

   • 这两者都具有以下属性：

     • 名称 name
     • 类型 String
     • 值 ./text

3. 根据您配置的接口，创建节点<rtePlugins-node>（如果不存在）：

   • 名称 rtePlugins
   • 类型 nt:unstructured

4. 在下面，为要激活的每个插件创建一个节点：

   • 类型 nt:unstructured
   • ​​命名所需插件的插件ID

激活插件后，请按照以下说明配置features属性。

了解findreplace插件

findreplace插件不需要任何配置。 它开箱即用。

使用替换功能时，应当与查找字符串同时输入要替换的替换字符串。 但是，在替换字符串之前，您仍可以单击“查找”以搜索该字符串。 如果在单击“查找”后输入替换字符串，则搜索将重置为文本的开头。

单击“查找”(Find)后，“查找和替换”(Find and Replace)对话框将变得透明，单击“替换”(Replace)后，对话框将变得不透明。 这允许作者查看作者将替换的文本。 如果用户单击“全部替换”，则对话框将关闭并显示已进行替换的数量。

配置粘贴模式

使用RTE时，作者可以以以下三种模式之一粘贴内容：

• 浏览器模式:使用浏览器的默认粘贴实施粘贴文本。它不是推荐的方法，因为它可能会引入不需要的标记。

• 纯文本模式:将剪贴板内容粘贴为纯文本。在Experience Manager组件中插入之前，会删除复制内容中的所有样式和格式元素。

• MS Word模式:从MS Word复制时，粘贴带格式的文本（包括表格）。不支持从其他源（如网页或MS Excel）复制和粘贴文本，并仅保留部分格式。

配置RTE工具栏上的粘贴选项

在RTE工具栏中，您可以为作者提供以下三个图标中的一些、全部或全部都不提供：

• 粘贴(Ctrl+V):可以预配置为与上述三种粘贴模式之一对应。

• 粘贴为文本:提供纯文本模式功能。

• 从Word粘贴:提供MS Word模式功能。

要配置RTE以显示所需的图标，请执行以下步骤。

1. 导航到您的组件，例如/apps/<myProject>/components/text。
2. 导航到节点rtePlugins/edit。 如果节点不存在，请参阅激活插件。
3. 在edit节点上创建features属性，并添加一个或多个功能。 保存所有更改。

配置“粘贴”(Ctrl+V)图标和快捷键的行为

可以使用以下步骤预配置​粘贴(Ctrl+V)​图标的行为。 此配置还定义作者用于粘贴内容的键盘快捷键Ctrl+V的行为。

配置允许使用以下三种类型的用例：

• 使用浏览器的默认粘贴实施粘贴文本。 它不是推荐的方法，因为它可能会引入不需要的标记。 使用下面的browser进行配置。

• 将剪贴板内容粘贴为纯文本。 在AEM组件中插入之前，它会删除复制内容中的所有样式和格式元素。 使用下面的plaintext进行配置。

• 从MS Word复制时，粘贴带格式的文本（包括表格）。 不支持从其他源（如网页或MS Excel）复制和粘贴文本，并仅保留部分格式。 使用下面的wordhtml进行配置。

1. 在组件中，导航到<rtePlugins-node>/edit节点。 如果节点不存在，请创建节点。 有关更多信息，请参阅激活插件。

2. 在edit节点中，使用以下详细信息创建属性：

   • 名称 defaultPasteMode
   • 类型 String
   • ​​Value所需粘贴模式之 browser一， plaintext或 wordhtml。

配置粘贴内容时允许的格式

可以进一步配置粘贴为Microsoft-Word(paste-wordhtml)模式，以便您能够明确定义从其他程序（如Microsoft Word）在AEM中粘贴时允许使用的样式。

例如，如果在AEM中粘贴时只允许使用粗体格式和列表，则可以过滤掉其他格式。 这称为可配置粘贴过滤，可用于以下两项：

• 文本
• 链接

对于链接，您还可以定义自动接受的协议。

要配置将文本从其他程序粘贴到AEM中时允许使用的格式，请执行以下操作：

1. 在组件中，导航到节点<rtePlugins-node>/edit。 如果节点不存在，请创建节点。 有关更多详细信息，请参阅激活插件。

2. 在edit节点下创建一个节点以保存HTML粘贴规则：

   • 名称 htmlPasteRules
   • 类型 nt:unstructured

3. 在htmlPasteRules下创建一个节点，以保存所允许的基本格式的详细信息：

   • 名称 allowBasics
   • 类型 nt:unstructured

4. 要控制接受的各种格式，请在allowBasics节点上创建以下一个或多个属性：

   • 名称 bold
   • 名称 italic
   • 名称 underline
   • 名称 anchor （用于链接和命名锚点）
   • 名称 image

   所有属性都为​Type Boolean，因此在相应的​Value​中，您可以选择或删除复选标记以启用或禁用该功能。

   注意

   如果未明确定义，则使用默认值true，并接受格式。

5. 也可以使用一系列其他属性或节点来定义其他格式，这些属性或节点也应用于htmlPasteRules节点。 保存所有更改。

您可以将以下属性用于htmlPasteRules。

以下是有效htmlPasteRules结构的示例。

"htmlPasteRules": {
    "allowBasics": {
        "italic": true,
        "link": true
    },
    "allowBlockTags": [
        "p", "h1", "h2", "h3"
    ],
    "list": {
        "allow": false,
        "ignoreMode": "paragraph"
    },
    "table": {
        "allow": true,
        "ignoreMode": "paragraph"
    }
}

配置文本样式

作者可以应用样式来更改部分文本的外观。 样式基于您在CSS样式表中预定义的CSS类。 使用class属性将风格化内容包含在span标记中以引用CSS类。 例如，<span class=monospaced>Monospaced Text Here</span>。

首次启用“样式”插件后，没有可用的默认样式。 弹出列表为空。 要为作者提供样式，请执行以下操作：

• 启用样式下拉选择器。
• 指定样式表的位置。
• 指定可从“样式”下拉列表中选择的各个样式。

对于以后的配置，假设要添加更多样式，请仅按照说明引用新样式表并指定其他样式。

启用样式下拉选择器列表

这是通过启用样式插件来完成的。

1. 在组件中，导航到节点<rtePlugins-node>/styles。 如果节点不存在，请创建节点。 有关更多详细信息，请参阅激活插件。

2. 在styles节点上创建features属性：

   • 名称 features
   • 类型 String
   • 值 * （星号）

3. 保存所有更改。

指定样式表位置

然后，指定要引用的样式表的位置：

1. 导航到文本组件的根节点，例如/apps/<myProject>/components/text。

2. 将属性externalStyleSheets添加到<rtePlugins-node>的父节点：

   • 名称 externalStyleSheets
   • 类型 String[] (多字符串；单 ​​击Multiin CRXDE)
   • 值 要包含的每个样式表的路径和文件名。使用存储库路径。
   注意

   您可以在以后任何时间添加对其他样式表的引用。

3. 保存所有更改。

在对话框（经典UI）中使用RTE时，可以指定为富文本编辑而优化的样式表。 由于技术限制，编辑器中会丢失CSS上下文，因此您可以模拟此上下文以改进所见即所得(WYSIWYG)体验。 富文本编辑器使用ID为CQrte的容器DOM元素，该元素可用于提供不同的样式以用于查看和编辑：

#CQ td {
// defines the style for viewing }

#CQrte td {
// defines the style for editing }

在弹出列表中指定可用的样式

1. 在组件定义中，导航到在启用样式下拉选择器中创建的节点<rtePlugins-node>/styles。

2. 在节点styles下，创建新节点（也称为styles）以保存要提供的列表：

   • 名称 styles
   • 类型 cq:WidgetCollection

3. 在styles节点下创建新节点以表示单个样式：

   • 名称，您可以指定名称，但应该适合样式
   • 类型 nt:unstructured

4. 将属性cssName添加到此节点以引用CSS类：

   • 名称 cssName
   • 类型 String
   • ​​ValueCSS类的名称（不带前面的“。”）;例如，cssClass而不是.cssClass)

5. 将属性text添加到同一节点；这定义了选择框中显示的文本：

   • 名称 text
   • 类型 String
   • ​​值样式的描述；显示在“样式”下拉选择框中。

6. 保存更改。

   对每个必需的样式重复上述步骤。

配置段落格式

在RTE中创作的任何文本都放置在块标记中，默认值为<p>。 通过启用paraformat插件，您可以使用下拉选择列表指定可分配给段落的其他块标记。 段落格式通过分配正确的块标记来确定段落类型。 作者可以使用格式选择器选择和分配它们。 示例块标记包括标准段落<p>和标题<h1>、<h2>等。

首次启用“段落格式”插件后，不提供默认的“段落格式”。 弹出列表为空。 要为作者提供段落格式，请执行以下操作：

• 启用“格式”下拉选择器列表。
• 指定可从下拉列表中选择为段落格式的块标记。

对于以后（重新）的配置，例如要添加更多格式，请仅按照说明的相关部分操作。

启用“格式”下拉选择器

首先启用paraformat插件：

1. 在组件中，导航到节点<rtePlugins-node>/paraformat。 如果节点不存在，请创建节点。 有关更多详细信息，请参阅激活插件。

2. 在paraformat节点上创建features属性：

   • 名称 features
   • 类型 String
   • 值 * （星号）

指定可用的段落格式

段落格式可通过以下方式供选择：

1. 在组件定义中，导航到在启用格式下拉选择器中创建的节点<rtePlugins-node>/paraformat。

2. 在paraformat节点下创建新节点，以保存格式列表：

   • 名称 formats
   • 类型 cq:WidgetCollection

3. 在formats节点下创建新节点，该节点保存单个格式的详细信息：

   • 名称，您可以指定名称，但该名称应适用于格式（例如，myparagraph、myheading1）。
   • 类型 nt:unstructured

4. 对于此节点，添加属性以定义使用的块标记：

   • 名称 tag

   • 类型 String

   • ​​值格式的块标记；例如：p、h1、h2等

     您无需输入分隔尖括号。

5. 对于同一节点，添加另一个属性，以便描述性文本显示在下拉列表中：

   • 名称 description
   • 类型 String
   • ​​值此格式的描述性文本；例如，段落、标题1、标题2，等等。此文本显示在“格式”选择列表中。

6. 保存更改。

   对每种所需的格式重复这些步骤。

配置特殊字符

在标准AEM安装中，当为特殊字符(specialchars)启用misctools插件时，会立即提供默认选项供使用；例如，版权和商标符号。

可以配置RTE以使自己选择的字符可用；通过定义不同的字符或整个序列。

定义单个字符

1. 在组件中，导航到节点<rtePlugins-node>/misctools。 如果节点不存在，请创建节点。 有关更多详细信息，请参阅激活插件。

2. 在misctools节点上创建features属性：

   • 名称 features

   • 类型 String[]

   • 值 specialchars

     （或String / *，如果为此插件应用了所有功能）

3. 在misctools下创建一个节点以保存特殊字符配置：

   • 名称 specialCharsConfig
   • 类型 nt:unstructured

4. 在specialCharsConfig下创建另一个节点以保存字符列表：

   • 名称 chars
   • 类型 nt:unstructured

5. 在chars下，添加新节点以保存单个字符定义：

   • ​​名称可以指定名称，但应反映字符；例如，一半。
   • 类型 nt:unstructured

6. 向此节点添加以下属性：

   • 名称 entity
   • 类型 String
   • ​​值所需字符的HTML表示形式；例如， &189; 部分半部分。

7. 保存更改。

保存属性后，表示的字符将显示在CRXDE中。 请参阅下面的“一半”示例。 重复上述步骤，为作者提供更多特殊字符。

定义字符范围

1. 使用定义单个字符中的步骤1至3。

2. 在chars下，添加一个新节点以保存字符范围的定义：

   • ​​名称可以指定名称，但应反映字符范围；例如，铅笔。
   • 类型 nt:unstructured

3. 在此节点下（根据您的特殊字符范围命名），添加以下两个属性：

   • 名称 rangeStart

     类型 Long
     ​​值 🔗 范围中第一个字符的Unicoderepresentation（小数）

   • 名称 rangeEnd

     类型 Long
     ​​值 🔗 范围中最后一个字符的Unicoderepresentation（小数）

4. 保存更改。

   例如，定义范围为9998 - 10000时，将提供以下字符。

   

   在CRXDE中，定义要在RTE​中提供的字符范围

   

   RTE中提供的特殊字符会在弹出窗口中向作者显示

配置表样式

样式通常应用于文本，但样式集也可以应用于表格或几个表格单元格。 此类样式可供作者从单元格属性或表属性对话框的样式选择器框中创建。 在文本组件（或衍生组件）内编辑表时（而不是在标准的表组件中编辑表时），可以使用样式。

1. 在组件中，导航到节点<rtePlugins-node>/table。 如果节点不存在，请创建节点。 有关更多详细信息，请参阅激活插件。

2. 在table节点上创建features属性：

   • 名称 features
   • 类型 String
   • 值 * （星号）
   注意

   如果不想启用所有表功能，可以创建features属性，如下所示：

   • 类型 String[]
   • 值（一个或多个）以下项之一或两者兼有：
     • table 允许编辑表属性；包括样式。
     • cellprops 以允许编辑单元格属性，包括样式。

3. 定义CSS样式表的位置以引用它们。 请参阅指定样式表的位置，因为这与定义文本🔗的样式时的位置相同。 如果您定义了其他样式，则可以定义该位置。

4. 在table节点下，创建新节点（根据需要）：

   • 要定义整个表的样式（位于​表属性​下）：

     • 名称 table-styles
     • 类型 cq:WidgetCollection

   • 要定义单个单元格的样式（位于​单元格属性​下）：

     • 名称 cellStyles
     • 类型 cq:WidgetCollection

5. 创建新节点(在table-styles或cellStyles节点下（视情况而定）以表示单个样式：

   • ​​您可以指定名称，但名称应反映样式。
   • 类型 nt:unstructured

6. 在此节点上，创建属性：

   • 定义要引用的CSS样式

     • 名称 cssName
     • 类型 String
     • ​​值CSS类的名称(例如，不带 .前面的， cssClass 而不 .cssClass带)

   • 定义要在下拉选择器中显示的描述性文本

     • 名称 text
     • 类型 String
     • ​​值要在选择列表中显示的文本

7. 保存所有更改。

对每个必需的样式重复上述步骤。

在表中配置隐藏的标题以辅助功能

有时，您可能会创建列标题中不带可视文本的数据表，这假定列与其他列的可视关系暗示了标题的用途。 在这种情况下，必须在标题单元格的单元格内提供隐藏的内部文本，以允许屏幕阅读器和其他辅助技术帮助具有各种需求的读者了解列的用途。

为了增强此类情况下的辅助功能，RTE支持隐藏的标头单元格。 此外，它还提供与表中隐藏标题相关的配置设置。 这些设置允许您在编辑和预览模式下对隐藏的标题应用CSS样式。 要帮助作者在编辑模式下识别隐藏的标题，请在代码中包含以下参数：

• hidden-headerEditingCSS:指定编辑RTE时，在隐藏标题单元格中应用的CSS类的名称。
• hidden-headerEditingStyle:指定编辑RTE时对隐藏标题单元格应用的样式字符串。

如果您在代码中同时指定CSS和样式字符串，则CSS类将优先于样式字符串，并可能会覆盖样式字符串所做的任何配置更改。

要帮助作者在预览模式下对隐藏的标题应用CSS，您可以在代码中包含以下参数：

• hidden-headerClassName:指定在预览模式下对隐藏的标题单元格应用的CSS类的名称。
• hidden-headerStyle:指定在预览模式下应用于隐藏标题单元格的样式字符串。

如果您在代码中同时指定CSS和样式字符串，则CSS类将优先于样式字符串，并可能会覆盖样式字符串所做的任何配置更改。

为拼写检查程序添加字典

激活拼写检查插件后，RTE会对每种相应语言使用字典。 然后，根据网站的语言选择子树的语言属性或从URL中提取语言；例如。 将/en/分支检查为英语，将/de/分支检查为德语。

标准AEM安装包括美式英语(en_us)和英式英语(en_gb)的字典。 要添加更多字典，请执行以下步骤。

1. 导航到页面https://extensions.openoffice.org/。

2. 执行下列操作之一，以查找您选择的语言的字典：

   • 搜索您选择的语言的字典。 在词典页面上，找到指向原始源或作者网页的链接。 在此类页面上找到v2.x的字典文件。
   • 在https://wiki.openoffice.org/wiki/User:Khirano/Dictionaries中搜索v2.x词典文件。

3. 下载包含拼写定义的存档。 提取文件系统上存档的内容。

   注意

   仅支持MySpell格式的OpenOffice.org v2.0.1或更早版本的字典。 由于字典现在是存档文件，因此建议您在下载后验证存档文件。

4. 找到.aff和.dic文件。 将文件名保留为小写。 例如，de_de.aff和de_de.dic。

5. 在/apps/cq/spellchecker/dictionaries的存储库中加载.aff和.dic文件。

为撤消和重做操作配置历史记录大小

RTE允许作者撤消或重做上次所做的一些编辑。 默认情况下，历史记录中会存储50个编辑内容。 您可以根据需要配置此值。

1. 在组件中，导航到节点<rtePlugins-node>/undo。 如果这些节点不存在，请创建它们。 有关更多详细信息，请参阅激活插件。

2. 在undo节点上创建属性：

   • 名称 maxUndoSteps

   • 类型 Long

   • ​​值您希望在历史记录中保存的撤消步骤数。

     • 默认为 50。
     • 使用0可完全禁用撤消/重做。

3. 保存更改。

配置选项卡大小

当在任何文本中按制表符时，会插入预定义的空格数；默认情况下，这是三个非中断空格和一个空格。 要定义制表符大小，请执行以下操作：

1. 在组件中，导航到节点<rtePlugins-node>/keys。 如果节点不存在，请创建节点。 有关更多详细信息，请参阅激活插件。

2. 在keys节点上创建属性：

   • 名称 tab-size
   • 类型 String
   • ​​值要用于制表符的空格字符数

3. 保存更改。

设置缩进边距

启用缩进（默认）后，您可以定义缩进大小：

1. 在组件中，导航到节点<rtePlugins-node>/lists。 如果这些节点不存在，请创建它们。 有关更多详细信息，请参阅激活插件。

2. 在lists节点上创建identSize参数：

   • 名称: identSize
   • 类型: Long
   • 值:缩进边距所需的像素数

配置可编辑空间的高度

您可以定义组件对话框中显示的可编辑空间的高度：

1. 在组件对话框定义的../items/text节点上，创建新属性：

   • 名称 height
   • 类型 Long
   • ​​以像素为单位值编辑画布的高度
   注意

   这不会更改对话框窗口的高度。

2. 保存更改。

配置链接的样式和协议

在AEM中添加链接时，您可以定义：

• 要使用的CSS样式
• 自动接受协议

要配置如何从其他程序在AEM中添加链接，请定义HTML规则。

1. 使用CRXDE Lite，找到项目的文本组件。

2. 在与<rtePlugins-node>相同的级别创建新节点，即在<rtePlugins-node>的父节点下创建该节点：

   • 名称 htmlRules
   • 类型 nt:unstructured
   注意

   ../items/text节点具有以下属性：

   • 名称 xtype
   • 类型 String
   • 值 richtext

   ../items/text节点的位置可能因对话框的结构而异；两个示例包括：

   • /apps/myProject>/components/text/dialog/items/text
   • /apps/<myProject>/components/text/dialog/items/panel/items/text

3. 在htmlRules下，创建新节点。

   • 名称 links
   • 类型 nt:unstructured

4. 在links节点下，根据需要定义属性：

   • 内部链接的CSS样式：

     • 名称 cssInternal
     • 类型 String
     • ​​值CSS类的名称（不带前面的“。”）;例如，cssClass而不是.cssClass)

   • 外部链接的CSS样式

     • 名称 cssExternal
     • 类型 String
     • ​​值CSS类的名称（不带前面的“。”）;例如，cssClass而不是.cssClass)

   • 有效​协议的数组。 支持的协议有http://、https://、file://和mailto:。

     • 名称 protocols
     • 类型 String[]
     • 值​一个或多个协议

   • defaultProtocol (字符串类型 的属性):用户未明确指定协议时使用的协议。

     • 名称 defaultProtocol
     • 类型 String
     • 值​一个或多个默认协议

   • 如何处理链接的目标属性的定义。 创建新节点：

     • 名称 targetConfig
     • 类型 nt:unstructured

     在节点targetConfig上：定义所需的属性：

     • 指定目标模式：

       • 名称 mode

       • 类型 String)

       • 值:

         • auto:表示选择了自动目标

           （由targetExternal属性为外部链接指定，或targetInternal为内部链接指定）。

         • manual:不适用于此环境

         • blank:不适用于此环境

     • 内部链接的目标：

       • 名称 targetInternal
       • 类型 String
       • ​​值内部链接的目标(仅在模式为时使 auto用)

     • 外部链接的目标：

       • 名称 targetExternal
       • 类型 String
       • ​​值外部链接的目标(仅在模式为时 auto使用)。

5. 保存所有更改。