配置富文本编辑器插件

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

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

激活插件并配置功能属性

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

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

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属性。

	启用所有功能	启用一些特定功能	禁用所有功能
名称	特征	特征	特征
类型	字符串	String[] (多字符串；将类型设置为“字符串”并单击“多”(在CRXDE Lite中)	字符串
值	*（星号）	设置为一个或多个功能值	-

了解findreplace插件

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

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

单击“查找并替换”对话框时，该对话框变得透明，单击“替换”时变得不透明。 这允许作者查看作者将替换的文本。 如果用户单击“全部替换”，对话框将关闭并显示所做替换的数量。

配置粘贴模式

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

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

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

• 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
   • 值 所需的粘贴模式 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

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

   注意

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

5. 也可以使用一系列其他属性或节点来定义其他格式，这些属性或节点也应用于htmlPasteRules节点：

属性	类型	描述
allowBlockTags	String[]	定义允许的块标记列表。 可能的块标记包括（其中包括）: 标题(h1、h2、h3) (p)段 列表语(ol, ul) 表（表）
fallbackBlockTag	字符串	定义用于任何包含allowBlockTags中未包含的块标记的块标记。 p在大多数情况下都足够。
表	nt:unstructured	定义粘贴表时的行为。 此节点必须具有属性allow（类型Boolean），以定义是否允许粘贴表。 如果allow设置为false，则必须指定属性ignoreMode（类型 String）以定义如何处理粘贴的表内容。 ignoreMode的有效值为： remove:删除表内容。 paragraph:将表单元格转换为段落。
列表	nt：非结构化	定义粘贴列表时的行为。 必须具有属性allow（类型Boolean）来定义是否允许粘贴列表。 如果allow设置为false，则必须指定属性ignoreMode（类型String）以定义如何处理粘贴的任何列表内容。 ignoreMode的有效值为： remove:删除列表内容。 paragraph:将列表项转换为段落。

有效htmlPasteRules结构的示例：

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

1. 保存所有更改。

配置文本样式

作者可以应用样式来更改部分文本的外观。 样式基于您在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
   • Type String[] (多字符串；单击 ​​多重CRXDE)
   • 值要包 括的每个样式表的路径和文件名。使用存储库路径。
   注意

   以后可以随时添加对其他样式表的引用。

3. 保存所有更改。

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

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

2. 在节点styles下，创建一个新节点（也称为styles），以保留列表可用：

   • 名称 styles
   • 类型 cq:WidgetCollection

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

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

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

   • 名称 cssName
   • 类型 String
   • 值 CSS类的名称（没有前面的“.”）;例如，cssClass而不是.cssClass

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

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

6. 保存更改。

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

配置段落格式

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

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

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

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

启用“格式”下拉选择器

首先启用参数格式插件：

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显示所表示的字符。 请参阅下面的“一半”示例。 重复上述步骤，使作者能够使用更多特殊字符。

在CRXDE中，添加一个字符以便在RTE工具栏中使用

定义字符范围

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

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

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

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

   • 名称 rangeStart

     类型 Long
     评 估 范围中第一个字符的Unicoderepresentation(decimal)

   • 名称 rangeEnd

     类型 Long
     评 估 范围中最后一个字符的Unicoderepresentation(decimal)

4. 保存更改。

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

   

   在CRXDE中，定义要在RTE​中使用的字符范围

   

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

配置表样式

样式通常应用于文本，但也可以对表或几个表单元格应用一组单独的样式。 从“单元格属性”或“表属性”对话框的“样式”选择器框中，作者可以使用这种样式。 当在文本组件（或衍生组件）中编辑表时，样式可用，而在标准表组件中则不可用。

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

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

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

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

   • 类型 String[]
   • 根据​需要，以下各项的值之一或两者：
     • table 允许编辑表属性；包括样式。
     • cellprops 以允许编辑单元格属性，包括样式。

3. 定义CSS样式表的位置以引用这些样式表。 请参阅指定样式表的位置，因为这与为文本](#textstyles)定义[样式时的位置相同。 如果您定义了其他样式，则可以定义位置。

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

   • 定义整个表的样式（可在​表属性​下找到）:

     • 名称 tableStyles
     • 类型 cq:WidgetCollection

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

     • 名称 cellStyles
     • 类型 cq:WidgetCollection

5. 创建一个新节点（在tableStyles或cellStyles节点下，视情况而定）以表示单个样式：

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

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

   • 定义要引用的CSS样式

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

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

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

7. 保存所有更改。

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

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

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

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

• hiddenHeaderEditingCSS:指定在编辑RTE时应用于隐藏标题单元格的CSS类的名称。
• hiddenHeaderEditingStyle:指定在编辑RTE时应用于隐藏标题单元格的样式字符串。

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

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

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

如果在代码中指定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. 下载包含拼写定义的存档。 解压文件系统上的存档内容。

   注意

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

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节点上创建属性：

   • 名称 tabSize
   • 类型 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 (String类型的 属性):在用户未明确指定协议时使用的协议。

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

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

     • 名称 targetConfig
     • 类型 nt:unstructured

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

     • 指定目标模式：

       • 名称 mode

       • 类型 String)

       • 值:

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

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

         • manual:不适用于此上下文

         • blank:不适用于此上下文

     • 内部链接的目标:

       • 名称 targetInternal
       • 类型 String
       • 评 估内部链接的目标(仅在“模式”为 auto)

     • 外部链接的目标:

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

5. 保存所有更改。