[BUGFIX] RTE: Multi-line lists in default PageTS configs cause problems
[Packages/TYPO3.CMS.git] / typo3 / sysext / rtehtmlarea / Documentation / DefaultConfigurations / Typical / Index.rst
1 .. ==================================================
2 .. FOR YOUR INFORMATION
3 .. --------------------------------------------------
4 .. -*- coding: utf-8 -*- with BOM.
5
6 .. include:: ../../Includes.txt
7
8
9
10 .. _typical-configuration:
11
12 Typical default configuration
13 -----------------------------
14
15 This default configuration establishes default settings in Page
16 TSconfig and User TSconfig with most commonly used features
17 representing a good start for typical sites.
18
19
20 .. _typical-page-tsconfig:
21
22 The following is inserted in Page TSconfig:
23 """""""""""""""""""""""""""""""""""""""""""
24
25 ## Define labels and styles to be applied to class selectors in the
26 interface of the RTE
27
28 ## The examples included here make partial re-use of color scheme and
29 frame scheme from CSS Styled Content extension
30
31 ::
32
33 RTE.classes {
34 align-left {
35 name = LLL:EXT:rtehtmlarea/htmlarea/locallang_tooltips.xml:justifyleft
36 value = text-align: left;
37 }
38 align-center {
39 name = LLL:EXT:rtehtmlarea/htmlarea/locallang_tooltips.xml:justifycenter
40 value = text-align: center;
41 }
42 align-right {
43 name = LLL:EXT:rtehtmlarea/htmlarea/locallang_tooltips.xml:justifyright
44 value = text-align: right;
45 }
46 csc-frame-frame1 {
47 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:frame-frame1
48 value = background-color: #EDEBF1; border: 1px solid #333333;
49 }
50 csc-frame-frame2 {
51 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:frame-frame2
52 value = background-color: #F5FFAA; border: 1px solid #333333;
53 }
54 important {
55 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:important
56 value = color: #8A0020;
57 }
58 name-of-person {
59 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:name-of-person
60 value = color: #10007B;
61 }
62 detail {
63 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:detail
64 value = color: #186900;
65 }
66 component-items {
67 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:component-items
68 value = color: #186900;
69 }
70 action-items {
71 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:action-items
72 value = color: #8A0020;
73 }
74 component-items-ordered {
75 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:component-items
76 value = color: #186900;
77 }
78 action-items-ordered {
79 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:action-items
80 value = color: #8A0020;
81 }
82 }
83
84 ## Anchor classes configuration for use by the anchor accesibility
85 feature
86
87 ::
88
89 RTE.classesAnchor {
90 externalLink {
91 class = external-link
92 type = url
93 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_titleText
94 }
95 externalLinkInNewWindow {
96 class = external-link-new-window
97 type = url
98 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_new_window_titleText
99 }
100 internalLink {
101 class = internal-link
102 type = page
103 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_titleText
104 }
105 internalLinkInNewWindow {
106 class = internal-link-new-window
107 type = page
108 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_new_window_titleText
109 }
110 download {
111 class = download
112 type = file
113 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:download_titleText
114 }
115 mail {
116 class = mail
117 type = mail
118 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:mail_titleText
119 }
120 }
121
122 ## Default RTE configuration
123
124 ::
125
126 RTE.default {
127
128 ## Markup options
129
130 ::
131
132 enableWordClean = 1
133 removeTrailingBR = 1
134 removeComments = 1
135 removeTags = center, font, o:p, sdfield, strike, u
136 removeTagsAndContents = link, meta, script, style, title
137
138 ## Toolbar options
139
140 ## The TCA configuration may add buttons to the toolbar
141
142 ::
143
144 showButtons = blockstylelabel, blockstyle, textstylelabel, textstyle
145 showButtons := addToList(formatblock, bold, italic, subscript, superscript)
146 showButtons := addToList(orderedlist, unorderedlist, outdent, indent, textindicator)
147 showButtons := addToList(insertcharacter, link, table, findreplace, chMode, removeformat, undo, redo, about)
148 showButtons := addToList(toggleborders, tableproperties)
149 showButtons := addToList(rowproperties, rowinsertabove, rowinsertunder, rowdelete, rowsplit)
150 showButtons := addToList(columninsertbefore, columninsertafter, columndelete, columnsplit)
151 showButtons := addToList(cellproperties, cellinsertbefore, cellinsertafter, celldelete, cellsplit, cellmerge)
152
153 ## More toolbar options
154
155 ::
156
157 keepButtonGroupTogether = 1
158
159 ## Enable status bar
160
161 ::
162
163 showStatusBar = 1
164
165 ## Hide infrequently used block types in the block formatting selector
166
167 ::
168
169 buttons.formatblock.removeItems = pre,address
170
171 ## List all class selectors that are allowed on the way to the
172 database
173
174 ::
175
176 proc.allowedClasses = external-link, external-link-new-window, internal-link, internal-link-new-window, download, mail
177 proc.allowedClasses := addToList(align-left, align-center, align-right, align-justify)
178 proc.allowedClasses := addToList(csc-frame-frame1, csc-frame-frame2)
179 proc.allowedClasses := addToList(component-items, action-items)
180 proc.allowedClasses := addToList(component-items-ordered, action-items-ordered)
181 proc.allowedClasses := addToList(important, name-of-person, detail)
182 proc.allowedClasses := addToList(indent)
183
184 ## Restrict the list of class selectors presented by the RTE to the
185 following for the specified tags:
186
187 ::
188
189 buttons.blockstyle.tags.div.allowedClasses = align-left, align-center, align-right
190 buttons.blockstyle.tags.div.allowedClasses := addToList(csc-frame-frame1, csc-frame-frame2)
191 buttons.blockstyle.tags.table.allowedClasses = csc-frame-frame1, csc-frame-frame2
192 buttons.blockstyle.tags.td.allowedClasses = align-left, align-center, align-right
193 buttons.textstyle.tags.span.allowedClasses = important, name-of-person, detail
194
195 ## Configuration of classes for links
196
197 ## These classes should also be in the list proc.allowedClasses
198
199 ::
200
201 buttons.link.properties.class.allowedClasses = external-link, external-link-new-window, internal-link, internal-link-new-window, download, mail
202 buttons.link.page.properties.class.default = internal-link
203 buttons.link.url.properties.class.default = external-link-new-window
204 buttons.link.file.properties.class.default = download
205 buttons.link.mail.properties.class.default = mail
206
207 ## Configuration specific to the TableOperations feature
208
209 ## Remove the following fieldsets from the properties popups
210
211 ::
212
213 disableAlignmentFieldsetInTableOperations = 1
214 disableSpacingFieldsetInTableOperations = 1
215 disableColorFieldsetInTableOperations = 1
216 disableLayoutFieldsetInTableOperations = 1
217
218 ## Show borders on table creation
219
220 ::
221
222 buttons.toggleborders.setOnTableCreation = 1
223
224 ## Configuration specific to the bold and italic buttons
225
226 ## Add hotkeys associated with bold and italic buttons
227
228 ::
229
230 buttons.bold.hotKey = b
231 buttons.italic.hotKey = i
232
233 ## Configuration of microdata schema
234
235 ::
236
237 schema {
238 sources {
239 schemaOrg = EXT:rtehtmlarea/extensions/MicrodataSchema/res/schemaOrgAll.rdf
240 }
241 }
242 }
243
244 ## front end RTE configuration for the general public
245
246 ::
247
248 RTE.default.FE < RTE.default
249 RTE.default.FE.showStatusBar = 0
250 RTE.default.FE.hideButtons = chMode, blockstyle, textstyle, underline, strikethrough, subscript, superscript, lefttoright, righttoleft, left, center, right, justifyfull, table, inserttag, findreplace, removeformat, copy, cut, paste
251 RTE.default.FE.userElements >
252 RTE.default.FE.userLinks >
253
254 ## tt\_content TCEFORM configuration
255
256 ## Let use all the space available for more comfort.
257
258 ::
259
260 TCEFORM.tt_content.bodytext.RTEfullScreenWidth = 100%
261
262
263 .. _typical-user-tsconfig:
264
265 The following is inserted in User TSconfig:
266 """""""""""""""""""""""""""""""""""""""""""
267
268 ## Enable the RTE by default for all users
269
270 ::
271
272 setup.default.edit_RTE = 1
273
274
275