8b2128626acd85a8db2ba7dd6614228108dbd690
[Packages/TYPO3.CMS.git] / typo3 / sysext / rtehtmlarea / Documentation / DefaultConfigurations / Demo / Index.rst
1 .. ==================================================
2 .. FOR YOUR INFORMATION
3 .. --------------------------------------------------
4 .. -*- coding: utf-8 -*- with BOM.
5
6 .. include:: ../../Includes.txt
7
8
9
10 .. _demo-configuration:
11
12 Demo default configuration
13 --------------------------
14
15 This default configuration sets Page TSconfig and User TSconfig with
16 as many features as possible for users who want to explore the
17 features of the RTE. This is **not** recommended for production
18 environments.
19
20
21 .. _demo-page-tsconfig:
22
23 The following is inserted in Page TSconfig:
24 """""""""""""""""""""""""""""""""""""""""""
25
26 ## Define labels and styles to be applied to class selectors in the
27 interface of the RTE
28
29 ## Partial re-use of color scheme and frame scheme from CSS Styled
30 Content extension
31
32 ::
33
34 RTE.classes {
35 align-left {
36 name = LLL:EXT:rtehtmlarea/htmlarea/locallang_tooltips.xml:justifyleft
37 value = text-align: left;
38 }
39 align-center {
40 name = LLL:EXT:rtehtmlarea/htmlarea/locallang_tooltips.xml:justifycenter
41 value = text-align: center;
42 }
43 align-right {
44 name = LLL:EXT:rtehtmlarea/htmlarea/locallang_tooltips.xml:justifyright
45 value = text-align: right;
46 }
47 csc-frame-frame1 {
48 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:frame-frame1
49 value = background-color: #EDEBF1; border: 1px solid #333333;
50 }
51 csc-frame-frame2 {
52 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:frame-frame2
53 value = background-color: #F5FFAA; border: 1px solid #333333;
54 }
55 important {
56 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:important
57 value = color: #8A0020;
58 }
59 name-of-person {
60 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:name-of-person
61 value = color: #10007B;
62 }
63 detail {
64 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:detail
65 value = color: #186900;
66 }
67 component-items {
68 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:component-items
69 value = color: #186900;
70 }
71 action-items {
72 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:action-items
73 value = color: #8A0020;
74 }
75 component-items-ordered {
76 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:component-items
77 value = color: #186900;
78 }
79 action-items-ordered {
80 name = LLL:EXT:rtehtmlarea/res/contentcss/locallang.xml:action-items
81 value = color: #8A0020;
82 }
83 }
84
85 ## Anchor classes configuration for use by the anchor accessibility
86 feature
87
88 ::
89
90 RTE.classesAnchor {
91 externalLink {
92 class = external-link
93 type = url
94 image = EXT:rtehtmlarea/res/accessibilityicons/img/external_link.gif
95 altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_altText
96 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_titleText
97 }
98 externalLinkInNewWindow {
99 class = external-link-new-window
100 type = url
101 image = EXT:rtehtmlarea/res/accessibilityicons/img/external_link_new_window.gif
102 altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_new_window_altText
103 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:external_link_new_window_titleText
104 }
105 internalLink {
106 class = internal-link
107 type = page
108 image = EXT:rtehtmlarea/res/accessibilityicons/img/internal_link.gif
109 altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_altText
110 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_titleText
111 }
112 internalLinkInNewWindow {
113 class = internal-link-new-window
114 type = page
115 image = EXT:rtehtmlarea/res/accessibilityicons/img/internal_link_new_window.gif
116 altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_new_window_altText
117 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:internal_link_new_window_titleText
118 }
119 download {
120 class = download
121 type = file
122 image = EXT:rtehtmlarea/res/accessibilityicons/img/download.gif
123 altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:download_altText
124 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:download_titleText
125 }
126 mail {
127 class = mail
128 type = mail
129 image = EXT:rtehtmlarea/res/accessibilityicons/img/mail.gif
130 altText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:mail_altText
131 titleText = LLL:EXT:rtehtmlarea/res/accessibilityicons/locallang.xml:mail_titleText
132 }
133 }
134
135 ## Default RTE configuration
136
137 ::
138
139 RTE.default {
140
141 ## Markup options
142
143 ::
144
145 enableWordClean = 1
146 removeTrailingBR = 1
147 removeComments = 1
148 removeTags = center, o:p, sdfield
149 removeTagsAndContents = link, meta, script, style, title
150
151 ## Allow img tags
152
153 ::
154
155 proc.entryHTMLparser_db.tags.img >
156
157 ## Allow style attributes on p and span tags
158
159 ::
160
161 proc.entryHTMLparser_db.tags {
162 p.allowedAttribs := addToList(style)
163 span.fixAttrib.style.unset >
164 }
165
166 ## Toolbar options
167
168 ::
169
170 showButtons = *
171
172 ## More toolbar options
173
174 ::
175
176 keepButtonGroupTogether = 1
177
178 ## Enable status bar
179
180 ::
181
182 showStatusBar = 1
183
184 )
185
186 ## For this demo, do not remove font, strike and u tags
187
188 ::
189
190 proc.entryHTMLparser_db.removeTags := removeFromList(font,strike,u)
191
192
193 ## List all class selectors that are allowed on the way to the
194 database
195
196 ::
197
198 proc.allowedClasses (
199 external-link, external-link-new-window, internal-link, internal-link-new-window, download, mail,
200 align-left, align-center, align-right, align-justify,
201 csc-frame-frame1, csc-frame-frame2,
202 component-items, action-items,
203 component-items-ordered, action-items-ordered,
204 important, name-of-person, detail,
205 indent
206 )
207
208 ## Restrict the list of class selectors presented by the RTE to the
209 following for the specified tags:
210
211 ::
212
213 buttons.blockstyle.tags.div.allowedClasses (
214 align-left, align-center, align-right,
215 csc-frame-frame1, csc-frame-frame2
216 )
217 buttons.blockstyle.tags.table.allowedClasses = csc-frame-frame1, csc-frame-frame2
218 buttons.blockstyle.tags.td.allowedClasses = align-left, align-center, align-right
219 buttons.textstyle.tags.span.allowedClasses = important, name-of-person, detail
220
221 ## Configuration of classes for links
222
223 ## These classes should also be in the list proc.allowedClasses
224
225 ::
226
227 buttons.link.properties.class.allowedClasses = external-link, external-link-new-window, internal-link, internal-link-new-window, download, mail
228 buttons.link.page.properties.class.default = internal-link
229 buttons.link.url.properties.class.default = external-link-new-window
230 buttons.link.file.properties.class.default = download
231 buttons.link.mail.properties.class.default = mail
232
233 ## Show all applicable class selectors available in the style sheet
234 file
235
236 ::
237
238 buttons.blockstyle.showTagFreeClasses = 1
239 buttons.textstyle.showTagFreeClasses = 1
240
241 ## Configuration specific to the table button or TableOperations
242 feature
243
244 ## Use the context menu instead of the toolbar for table operations,
245 but keep toggleborders button in toolbar
246
247 ## Show borders on table creation
248
249 ::
250
251 hideTableOperationsInToolbar = 1
252 buttons.toggleborders.keepInToolbar = 1
253 buttons.toggleborders.setOnTableCreation = 1
254
255 ## Configuration specific to the inserttag button or QuickTag feature
256
257 ## Do not allow insertion of the following tags
258
259 ::
260
261 buttons.inserttag.denyTags = font, underline, strike, table
262
263 ## Configuration specific to the bold and italic buttons
264
265 ## Add hotkeys associated with bold, italic, strikethrough and
266 underline buttons
267
268 ::
269
270 buttons.bold.hotKey = b
271 buttons.italic.hotKey = i
272 buttons.strikethrough.hotKey = s
273 buttons.underline.hotkey = u
274
275 ## Configuration specific to the spellcheck button or SpellCheck
276 feature
277
278 ## Enable the use of personal dictionaries
279
280 ::
281
282 buttons.spellcheck.enablePersonalDictionaries = 1
283
284 ## Configuration of microdata schema
285
286 ::
287
288 schema {
289 sources {
290 schemaOrg = EXT:rtehtmlarea/extensions/MicrodataSchema/res/schemaOrgAll.rdf
291 }
292 }
293 }
294
295 ## Use same processing as on entry to database to clean content pasted
296 into the editor
297
298 ::
299
300 RTE.default.enableWordClean.HTMLparser < RTE.default.proc.entryHTMLparser_db
301
302 ## front end RTE configuration
303
304 ::
305
306 RTE.default.FE < RTE.default
307 RTE.default.FE.userElements >
308 RTE.default.FE.userLinks >
309
310 ## tt\_content TCEFORM configuration
311
312 ## Let use all the space available for more comfort.
313
314 ::
315
316 TCEFORM.tt_content.bodytext.RTEfullScreenWidth = 100%
317
318
319 .. _the-following-is-inserted-in-user-tsconfig:
320
321 The following is inserted in User TSconfig:
322 """""""""""""""""""""""""""""""""""""""""""
323
324 ## Enable the RTE by default for all users
325
326 ::
327
328 setup.default.edit_RTE = 1
329
330 ## Enable the file upload feature of the element browser by default
331 for all users
332
333 ::
334
335 options.uploadFieldsInTopOfEB = 1
336
337 ## Set the default spelling ability of the check speller for all users
338
339 ::
340
341 options.HTMLAreaPspellMode = bad-spellers
342
343 ## Enable the personal dictionary feature of the check speller by
344 default for all users
345
346 ::
347
348 options.enablePersonalDicts = 1
349
350
351