配置RTF編輯器插件

RTE功能可通過一系列插件提供，每個插件都具有features屬性。 可以配置features屬性以啟用或禁用一個或多個RTE功能。 本文介紹如何具體配置RTE插件。

有關其他RTE配置的詳細資訊，請參見 配置RTF編輯器。

激活插件並配置features屬性

要激活插件，請執行以下步驟。 只有在首次配置插件時才需要一些步驟，因為相應的節點不存在。

預設情況下， format。 link。 list。 justify, control 插件及其所有功能都在RTE中啟用。

1. 使用CRXDE Lite，查找項目的文本元件。

2. 建立的父節點 <rtePlugins-node> 如果不存在，則在配置任何RTE插件之前：

   • 根據元件，父節點為：

     • 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)和「替換」(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. 建立 features 屬性 edit 並添加一個或多個功能。 保存所有更改。

配置「貼上」(Ctrl+V)表徵圖和快捷方式的行為

可以預配置 貼上(Ctrl+V) 表徵圖。 此配置還定義了作者用於貼上內容的鍵盤快捷鍵Ctrl+V的行為。

配置允許以下三種類型的使用案例：

• 使用瀏覽器的預設貼上實現貼上文本。 它不是推薦的方法，因為它可能會引入不需要的標籤。 配置使用 browser 下。

• 將剪貼簿內容貼上為純文字檔案。 它在插入之前從複製的內容中刪除所有樣式和格式元素 Experience Manager 元件。 配置使用 plaintext 下。

• 從MS Word複製時，使用格式貼上文本（包括表）。 不支援從其他源（如網頁或MS Excel）複製和貼上文本，並且只保留部分格式。 配置使用 wordhtml 下。

1. 在元件中，導航到 <rtePlugins-node>/edit 的下界。 如果節點不存在，則建立節點。 有關詳細資訊，請參見 激活插件。

2. 在 edit 節點使用以下詳細資訊建立屬性：

   • 名稱 defaultPasteMode
   • 類型 String
   • 值 是所需的貼上模式之一 browser。 plaintext或 wordhtml 模式。

配置貼上內容時允許的格式

貼上為Microsoft詞(paste-wordhtml)模式，以便在貼上時顯式允許一些樣式 Experience Manager 從另一個程式，例如 Microsoft Word。

例如，如果貼上時僅允許使用粗體格式和清單 Experience Manager，可以過濾其它格式。 這稱為可配置的貼上過濾，可以同時執行以下兩項：

• 文字
• 連結

對於連結，您還可以定義自動接受的協定。

配置將文本貼上到時允許使用的格式 Experience Manager 從另一個程式：

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 節點：

有效示例 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類。 程式化內容封入 span 標籤使用 class 屬性，以引用CSS類。 例如：

<span class=monospaced>Monospaced Text Here</span>

首次啟用「樣式」插件時，不提供預設的「樣式」。 彈出清單為空。 要向作者提供「樣式」，請執行以下操作：

• 啟用「樣式」(Style)下拉選擇器。
• 指定樣式表的一個或多個位置。
• 指定可從樣式彈出式清單中選擇的單個樣式。

對於以後的重新配置，例如要添加更多樣式，請僅按照說明參考新樣式表並指定其他樣式。

啟用「樣式」下拉選擇器清單

這是通過啟用樣式插件來完成的。

1. 在元件中，導航到該節點 <rtePlugins-node>/styles。 如果節點不存在，則建立節點。 有關詳細資訊，請參閱 激活插件。

2. 建立 features 屬性 styles 節點：

   • 名稱 features
   • 類型 String
   • 值 * （星號）

3. 保存所有更改。

指定樣式表位置

然後，指定要參照的樣式表的位置：

1. 導航到文本元件的根節點，例如 /apps/<myProject>/components/text。

2. 添加屬性 externalStyleSheets 到的父節點 <rtePlugins-node>:

   • 名稱 externalStyleSheets
   • 類型 String[] (多字串；按一下 多 在CRXDE中)
   • 值 要包括的每個樣式表的路徑和檔案名。 使用儲存庫路徑。
   注意

   可以隨時添加對附加樣式表的參照。

3. 保存所有更改。

在對話框（經典UI）中使用RTE時，可以指定為富格文本編輯而優化的樣式表。 由於技術限制，CSS上下文在編輯器中丟失，因此您可以模擬此上下文以改進WYSIWYG體驗。

富格文本編輯器使用ID為 CQrte 提供不同樣式的視圖和編輯：

#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
   • 值 CSS類的名稱(前面沒有「。」;比如說， cssClass 而不是 .cssClass)

5. 添加屬性 text 到同一節點；這定義了選擇框中顯示的文本：

   • 名稱 text
   • 類型 String
   • 值 樣式描述；的子菜單。

6. 儲存變更。

   對每個所需樣式重複上述步驟。

配置RTE以便在日語中使用最佳換詞符

作者使用 Experience Manager 要創作日語內容，可以將樣式應用於字元以避免在不需要分段時換行。 這允許作者在期望的位置讓句子中斷。 此功能的樣式基於CSS樣式表中預定義的CSS類。

要建立作者可以應用於日文文本的樣式，請執行以下步驟：

1. 在「樣式」節點下建立節點。 請參閱 指定樣式。

   • 名稱: jpn-word-wrap
   • 類型: nt:unstructure

2. 添加屬性 cssName 以引用CSS類。 此類名是日文換行功能的保留名稱。

   • 名稱: cssName
   • 類型: String
   • 值： jpn-word-wrap (沒有前面的 .)

3. 將屬性文本添加到同一節點。 值是作者在選擇樣式時看到的樣式的名稱。

   • 名稱： text
     *類型：
     String
   • 值: Japanese word-wrap

4. 建立樣式表並指定其路徑。 請參閱 指定樣式表的位置。 將以下內容添加到樣式表。 根據需要更改背景顏色。

   .text span.jpn-word-wrap {
       display:inline-block;
   }
   .is-edited span.jpn-word-wrap {
       background-color: #ffddff;
   }
   

   

配置段落格式

在RTE中創作的任何文本都放置在塊標籤中，預設值為 <p>。 通過啟用 paraformat 插件，您可以使用下拉選擇清單指定可分配給段落的其他塊標籤。 段落格式通過分配正確的塊標籤來確定段落類型。 作者可以使用「格式」(Format)選擇器選擇並分配它們。 示例塊標籤包括標準段落 <p> 和標題 <h1>。 <h2>等等。

首次啟用「段落格式」插件時，不提供預設的段落格式。 彈出清單為空。 要向作者提供段落格式，請執行以下操作：

• 啟用 格式 彈出式選擇器清單。
• 指定可從彈出菜單中選擇為段落格式的塊標籤。

對於以後的重新配置，例如要添加更多格式，請只遵循說明的相關部分。

啟用「格式」下拉選擇器

啟用 paraformat 插件，請執行以下步驟：

1. 在元件中，導航到該節點 <rtePlugins-node>/paraformat。 如果節點不存在，則建立節點。 有關詳細資訊，請參閱 激活插件。

2. 建立 features 屬性 paraformat 節點：

   • 名稱 features
   • 類型 String
   • 值 * （星號）

指定可用的段落格式

段落格式可供以下人選選擇：

1. 在元件定義中，導航到節點 <rtePlugins-node>/paraformat，在中建立 啟用格式下拉選擇器。

2. 在 paraformat 節點建立節點，以保存格式清單：

   • 名稱 formats
   • 類型 cq:WidgetCollection

3. 在 formats 節點，它保存單個格式的詳細資訊：

   • 名稱，可以指定名稱，但它應適用於格式（例如myparaph、myheading1）。
   • 類型 nt:unstructured

4. 向此節點添加屬性以定義使用的塊標籤：

   • 名稱 tag

   • 類型 String

   • 值 格式的塊標籤；例如：p、h1、h2等。

     不需要輸入定界尖括弧。

5. 在同一節點中添加另一個屬性，以便說明性文本顯示在下拉清單中：

   • 名稱 description
   • 類型 String
   • 值 此格式的描述性文本；例如，段落、標題1、標題2等。 此文本顯示在「格式」選擇清單中。

6. 儲存變更。

   對每個所需格式重複步驟。

配置特殊字元

在標準中 Experience Manager 安裝，當 misctools 為特殊字元啟用插件(specialchars)預設選擇立即可用；例如，版權和商標符號。

您可以配置RTE，使您選擇的字元可用；要麼定義不同的字元，要麼定義整個序列。

定義單個字元

1. 在元件中，導航到該節點 <rtePlugins-node>/misctools。 如果節點不存在，則建立節點。 有關詳細資訊，請參閱 激活插件。

2. 建立 features 屬性 misctools 節點：

   • 名稱 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
     值 這樣 Unicode 表示（小數）

   • 名稱 rangeEnd

     類型 Long
     值 這樣 Unicode 範圍中最後一個字元的表示（小數）

4. 儲存變更。

   例如，定義介於9998 - 10000之間的範圍時，將提供以下字元。

   

   圖：在CRXDE中，定義要在RTE中提供的字元範圍

   

配置表樣式

樣式通常應用於文本，但也可以在表格或幾個表格單元格上應用一組單獨的樣式。 在「單元格屬性」或「表格屬性」對話框的「樣式」選擇器框中，作者可使用此類樣式。 當編輯文本元件（或衍生）中的表，而不是標準的「表」元件中的表時，這些樣式可用。

1. 在元件中導航到節點 <rtePlugins-node>/table。 如果節點不存在，則建立節點。 有關詳細資訊，請參閱 激活插件。

2. 建立 features 屬性 table 節點：

   • 名稱 features
   • 類型 String
   • 值 *
   注意

   如果不想啟用所有表功能，可以建立 features 屬性：

   • 類型 String[]
   • 值(s)下列其中一項或兩者：
   * `table` 允許編輯表格屬性；包括樣式。 * `cellprops` 允許編輯單元格屬性，包括樣式。

3. 定義CSS樣式表的位置以引用這些樣式表。 請參閱 指定樣式表的位置 與定義 文本樣式。 如果定義了其它樣式，則可以定義位置。

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/ 德語。

標準Experience Manager安裝包括用於以下目的的詞典：

• 美國英語(en_us)
• 英語(en_gb)

若要添加更多詞典，請執行以下步驟。

1. 導航到該頁 https://extensions.openoffice.org/。

2. 選擇所需語言並下載包含拼寫定義的ZIP檔案。 提取檔案系統上的存檔內容。

   注意

   僅字典 MySpell 支援OpenOffice.org v2.0.1或更低版本的格式。 由於字典現在是存檔檔案，建議在下載後驗證存檔檔案。

3. 找到.aff和.dic檔案。 將檔案名保留為小寫。 比如說， de_de.aff 和 de_de.dic。

4. 將.aff和.dic檔案載入到儲存庫中，位於 /apps/cq/spellchecker/dictionaries。

配置撤消和重做操作的歷史記錄大小

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
   • 值:縮進邊距所需的像素數。

配置可編輯空間的高度

可定義元件對話框中顯示的可編輯空間的高度。 僅當在對話框中使用RTE時，此配置才適用。 配置不會更改對話框窗口的高度。

1. 在 ../items/text 節點，在元件的對話框定義中，建立一個屬性：

   • 名稱 height
   • 類型 Long
   • 值 編輯畫布的高度（以像素為單位）。

2. 儲存變更。

配置連結的樣式和協定

在中添加連結時 Experience Manager，可以定義要使用的CSS樣式和自動接受的協定。 配置連結的添加方式 Experience Manager 從另一個程式中定義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)

   • 有效陣列 協定 包括 https://。 https://。 file://。 mailto:等，

     • 名稱 protocols
     • 類型 String[]
     • 值(s)一個或多個協定

   • 預設協定 （類型屬性） 字串):用戶未顯式指定協定時使用的協定。

     • 名稱 defaultProtocol
     • 類型 String
     • 值​一個或多個預設協定

   • 如何處理連結的目標屬性的定義。 建立節點：

     • 名稱 targetConfig
     • 類型 nt:unstructured

     在節點上 targetConfig:定義所需屬性：

     • 指定目標模式：

       • 名稱 mode

       • 類型 String)

       • 值(s):

         • auto:意味著選擇了自動目標

           (由 targetExternal 外部連結或 targetInternal )。

         • manual:不適用於此上下文

         • blank:不適用於此上下文

     • 內部連結的目標：

       • 名稱 targetInternal
       • 類型 String
       • 值 內部連結的目標(僅在模式為 auto)

     • 外部連結的目標：

       • 名稱 targetExternal
       • 類型 String
       • 值 外部連結的目標(僅在模式為 auto)。

5. 保存所有更改。