設定RTF編輯器外掛程式 configure-the-rich-text-editor-plug-ins

使用CRXDE Lite，找出專案的文字元件。

建立以下專案的父節點： <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

根據您設定的介面，建立節點 <rtePlugins-node>，如果它不存在：

• 名稱 rtePlugins
• 型別 nt:unstructured

在此節點底下，針對您要啟用的每個外掛程式建立一個節點：

• 型別 nt:unstructured
• 名稱 需要外掛程式的外掛程式ID

在您的元件中，導覽至 <rtePlugins-node>/edit 節點。 如果節點不存在，則建立節點。 如需詳細資訊，請參閱 啟動外掛程式.

在 edit 節點會使用下列詳細資料建立屬性：

• 名稱 defaultPasteMode
• 型別 String
• 值 是其中一個必要的貼上模式 browser， plaintext，或 wordhtml 模式。

在您的元件中，導覽至節點 <rtePlugins-node>/edit. 如果節點不存在，則建立節點。 如需詳細資訊，請參閱 啟動外掛程式.

在下建立節點 edit 節點以儲存HTML貼上規則：

• 名稱 htmlPasteRules
• 型別 nt:unstructured

在下建立節點 htmlPasteRules，以保留允許的基本格式的詳細資料：

• 名稱 allowBasics
• 型別 nt:unstructured

若要控制所接受的個別格式，請在 allowBasics 節點：

• 名稱 bold
• 名稱 italic
• 名稱 underline
• 名稱 anchor （適用於連結和已命名的錨點）
• 名稱 image

所有屬性都是 型別 Boolean，因此在適當的中 值 您可以選取或移除核取記號來啟用或停用該功能。

其他格式也可以使用其他屬性或節點範圍來定義，這些屬性或節點也會套用至 htmlPasteRules 節點：

在您的元件中，導覽至節點 <rtePlugins-node>/styles. 如果節點不存在，則建立節點。 如需詳細資訊，請參閱 啟動外掛程式.

建立 features 上的屬性 styles 節點：

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

儲存所有變更。

導覽至文字元件的根節點，例如， /apps/<myProject>/components/text.

新增屬性 externalStyleSheets 至的父節點 <rtePlugins-node>：

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

儲存所有變更。

在元件定義中，導覽至節點 <rtePlugins-node>/styles，在中建立 啟用樣式下拉式選取器.

在節點下 styles，建立節點(也稱為 styles)以保留可供使用的清單：

• 名稱 styles
• 型別 cq:WidgetCollection

在下建立節點 styles 代表個別樣式的節點：

• 名稱，您可以指定名稱，但名稱應適合樣式
• 型別 nt:unstructured

新增屬性 cssName 至此節點以參照CSS類別：

• 名稱 cssName
• 型別 String
• 值 CSS類別的名稱(沒有前置詞'.'；例如， cssClass 而非 .cssClass)

新增屬性 text 至相同節點，這會定義選取方塊中顯示的文字：

• 名稱 text
• 型別 String
• 值 樣式的說明；顯示在「樣式」下拉式選取方塊中。

儲存變更。

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

在styles節點下建立節點。 另請參閱 指定樣式.

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

新增屬性 cssName 到節點以參照CSS類別。 此類別名稱是日文自動換行功能的保留名稱。

• 名稱：cssName
• 類型：String
• 值： jpn-word-wrap (無前置詞 .)

將屬性文字新增至相同的節點。 值是作者在選取樣式時看到的樣式名稱。

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

建立樣式表並指定其路徑。 另請參閱 指定樣式表的位置. 將下列內容加入樣式表。 視需要變更背景顏色。

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

在您的元件中，導覽至節點 <rtePlugins-node>/paraformat. 如果節點不存在，則建立節點。 如需詳細資訊，請參閱 啟動外掛程式.

建立 features 上的屬性 paraformat 節點：

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

在元件定義中，導覽至節點 <rtePlugins-node>/paraformat，在中建立 啟用格式下拉式選取器.

在 paraformat 節點建立節點，以儲存格式清單：

• 名稱 formats
• 型別 cq:WidgetCollection

在下建立節點 formats 節點，這會保留個別格式的詳細資料：

• 名稱，您可以指定名稱，但應適合該格式（例如myparagraph、myheading1）。
• 型別 nt:unstructured

將屬性新增至此節點，以定義使用的區塊標籤：

• 名稱 tag

• 型別 String

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

  您不需要輸入分隔的角括弧。

若要讓描述文字出現在下拉式清單中，請新增屬性至相同節點：

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

儲存變更。

針對每種所需的格式重複這些步驟。

在您的元件中，導覽至節點 <rtePlugins-node>/misctools. 如果節點不存在，則建立節點。 如需詳細資訊，請參閱 啟動外掛程式.

建立 features 上的屬性 misctools 節點：

• 名稱 features

• 型別 String[]

• 值 specialchars

  (或 String / * 如果套用此外掛程式的所有功能)

在 misctools 建立節點以儲存特殊字元設定：

• 名稱 specialCharsConfig
• 型別 nt:unstructured

在 specialCharsConfig 建立另一個節點來儲存字元清單：

• 名稱 chars
• 型別 nt:unstructured

在 chars 新增節點以保留個別字元定義：

• 名稱 您可以指定名稱，但應反映字元；例如，一半。
• 型別 nt:unstructured

將下列屬性新增至此節點：

• 名稱 entity
• 型別 String
• 值 所需字元的HTML表示；例如， &189; 分數的一半。

儲存變更。

使用中的步驟1到3 定義單一字元.

在 chars 新增節點以保留字元範圍的定義：

• 名稱 您可以指定名稱，但應反映字元範圍；例如，鉛筆。
• 型別 nt:unstructured

在此節點下（根據特殊字元範圍命名）新增以下兩個屬性：

• 名稱 rangeStart

  型別 Long
  值 此 Unicode 表示範圍（十進位）中第一個字元

• 名稱 rangeEnd

  型別 Long
  值 此 Unicode 表示範圍（十進位）中最後一個字元

儲存變更。

例如，定義從9998到10000的範圍，可提供下列字元。

圖：在CRXDE中，定義在RTE中可用的字元範圍

在您的元件內導覽至節點 <rtePlugins-node>/table. 如果節點不存在，則建立節點。 如需詳細資訊，請參閱 啟動外掛程式.

建立 features 上的屬性 table 節點：

• 名稱 features
• 型別 String
• 值 *

定義CSS樣式表的位置以參照這些樣式表。 另請參閱 指定樣式表的位置 因為這與定義 文字樣式. 如果您定義了其他樣式，則可定義位置。

在 table 節點會視需要建立下列節點：

• 定義整個表格的樣式(可在 表格屬性)：

  • 名稱 tableStyles
  • 型別 cq:WidgetCollection

• 定義個別儲存格的樣式(可在 儲存格屬性)，

  • 名稱 cellStyles
  • 型別 cq:WidgetCollection

建立節點(在 tableStyles 或 cellStyles 節點)，以代表個別樣式，

• 名稱 您可以指定名稱，但應反映樣式。
• 型別 nt:unstructured

在此節點上建立屬性：

• 若要定義參考的CSS樣式，

  • 名稱 cssName
  • 型別 String
  • 值 CSS類別的名稱（不含前置詞） .例如， cssClass 而非 .cssClass)

• 若要定義要在彈出式選取器中顯示的描述文字，

  • 名稱 text
  • 型別 String
  • 值 要顯示在選取專案清單中的文字

儲存所有變更。

導覽至頁面 https://extensions.openoffice.org/.

選取所需的語言並下載含有拼字定義的ZIP檔案。 擷取檔案系統上封存的內容。

找到.aff和.dic檔案。 將檔案名稱保留為小寫。 例如， de_de.aff 和 de_de.dic.

將.aff和.dic檔案載入存放庫的 /apps/cq/spellchecker/dictionaries.

在您的元件內導覽至節點 <rtePlugins-node>/undo. 如果節點不存在，請建立這些節點。 如需詳細資訊，請參閱 啟動外掛程式.

在 undo 節點建立屬性：

• 名稱 maxUndoSteps
• 型別 Long
• 值 您想要儲存在記錄中的復原步驟數。 預設值為50。 使用 0 以完全停用還原/重做。

儲存變更。

在您的元件中，導覽至節點 <rtePlugins-node>/keys. 如果節點不存在，則建立節點。 如需詳細資訊，請參閱 啟動外掛程式.

在 keys 節點建立屬性：

• 名稱 tabSize
• 型別 String
• 值 用於製表器的空格字元數。

儲存變更。

在您的元件內導覽至節點 <rtePlugins-node>/lists. 如果節點不存在，請建立這些節點。 如需詳細資訊，請參閱 啟動外掛程式.

在 lists 節點建立 identSize 引數：

• 名稱：identSize
• 類型：Long
• 值：縮排邊界所需的畫素數。

在 ../items/text 節點，在元件的對話方塊定義中，建立屬性：

• 名稱 height
• 型別 Long
• 值 編輯畫布的高度（畫素）。

儲存變更。

使用CRXDE Lite，找出專案的文字元件。

在與相同的層級建立節點 <rtePlugins-node>，也就是在的父項節點底下建立節點 <rtePlugins-node>：

• 名稱 htmlRules
• 型別 nt:unstructured

在 htmlRules，建立節點。

• 名稱 links
• 型別 nt:unstructured

在 links 節點會視需要定義屬性：

• 內部連結的CSS樣式：

  • 名稱 cssInternal
  • 型別 String
  • 值 CSS類別的名稱(沒有前置詞'.'；例如， cssClass 而非 .cssClass)

• 外部連結的CSS樣式

  • 名稱 cssExternal
  • 型別 String
  • 值 CSS類別的名稱(沒有前置詞'.'；例如， cssClass 而非 .cssClass)

• 有效陣列 通訊協定 包含 https://， https://， file://， mailto:和其他，

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

• defaultprotocol (型別的屬性 字串)：使用者未明確指定時所要使用的通訊協定。

  • 名稱 defaultProtocol
  • 型別 String
  • 值(s)一或多個預設通訊協定

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

  • 名稱 targetConfig
  • 型別 nt:unstructured

  在節點上 targetConfig：定義必要的屬性：

  • 指定目標模式：

    • 名稱 mode

    • 型別 String)

    • 值(s) ：

      • auto：表示選擇自動目標

        (由 targetExternal 外部連結或的屬性 targetInternal 內部連結使用)。

      • manual：不適用於此內容

      • blank：不適用於此內容

  • 內部連結的目標：

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

  • 外部連結的目標：

    • 名稱 targetExternal
    • 型別 String
    • 值 外部連結的目標（僅在模式為下列專案時使用） auto)。

儲存所有變更。