diff --git a/Documentation/PageTsconfig/Rte.rst b/Documentation/PageTsconfig/Rte.rst index 847134a5..45735cd2 100644 --- a/Documentation/PageTsconfig/Rte.rst +++ b/Documentation/PageTsconfig/Rte.rst @@ -260,6 +260,49 @@ buttons.link.[ *type* ].properties.target.default Possible types are: page, file, url, mail, spec. More types may be provided by extensions. +.. index:: + RTE; Editor configuration +.. _page-ts-rte-properties-editor: + +editor +------ + +.. confval:: editor + :name: rte-editor + :type: array + + Changes or adds values of the `editor` section of the + `preset `_ + in use. TYPO3 hands `editor.config` to CKEditor as it is. The options + there belong to CKEditor: look them up in the + `CKEditor configuration reference `_ + and in the documentation of CKEditor. + + Keep the configuration of the editor in a preset where you can. Use page + TSconfig to select another preset, and to change single values only. + + TYPO3 merges page TSconfig into the preset key by key: + + * A value replaces the value with the same key in the preset. + * A key that the preset does not have is added. + * In a list of the preset, a key replaces the entry at the same position. + Use a higher key to add an entry. + + Page TSconfig cannot remove a value of the preset. Every value arrives + in CKEditor as a string, so a boolean cannot be switched off: `0` arrives + as the string `"0"`, which is not `false`. For both, use a preset of your + own. + + `RTE.config.[tableName].[fieldName]` replaces the values of + `RTE.default`, and `RTE.config.[tableName].[fieldName].types.[type]` + replaces both. + + The default preset loads one stylesheet into the editor, as the first + entry of `editor.config.contentsCss`. The key `10` adds a second one: + + .. literalinclude:: _codesnippets/_rteEditorContentsCss.tsconfig + :caption: EXT:my_sitepackage/Configuration/page.tsconfig + .. index:: RTE; Server processing RTE; proc diff --git a/Documentation/PageTsconfig/_codesnippets/_rteEditorContentsCss.tsconfig b/Documentation/PageTsconfig/_codesnippets/_rteEditorContentsCss.tsconfig new file mode 100644 index 00000000..c5d18390 --- /dev/null +++ b/Documentation/PageTsconfig/_codesnippets/_rteEditorContentsCss.tsconfig @@ -0,0 +1 @@ +RTE.default.editor.config.contentsCss.10 = EXT:my_sitepackage/Resources/Public/Css/rte.css