28c5de7486f839d739c9af07cfea490b281ed02b
[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 (
145 blockstylelabel, blockstyle, textstylelabel, textstyle,
146 formatblock, bold, italic, subscript, superscript,
147 orderedlist, unorderedlist, outdent, indent, textindicator,
148 insertcharacter, link, table, findreplace, chMode, removeformat, undo, redo, about,
149 toggleborders, tableproperties,
150 rowproperties, rowinsertabove, rowinsertunder, rowdelete, rowsplit,
151 columninsertbefore, columninsertafter, columndelete, columnsplit,
152 cellproperties, cellinsertbefore, cellinsertafter, celldelete, cellsplit, cellmerge
153 )
154
155 ## More toolbar options
156
157 ::
158
159 keepButtonGroupTogether = 1
160
161 ## Enable status bar
162
163 ::
164
165 showStatusBar = 1
166
167 ## Hide infrequently used block types in the block formatting selector
168
169 ::
170
171 buttons.formatblock.removeItems = pre,address
172
173 ## List all class selectors that are allowed on the way to the
174 database
175
176 ::
177
178 proc.allowedClasses (
179 external-link, external-link-new-window, internal-link, internal-link-new-window, download, mail,
180 align-left, align-center, align-right, align-justify,
181 csc-frame-frame1, csc-frame-frame2,
182 component-items, action-items,
183 component-items-ordered, action-items-ordered,
184 important, name-of-person, detail,
185 indent
186 )
187
188 ## Restrict the list of class selectors presented by the RTE to the
189 following for the specified tags:
190
191 ::
192
193 buttons.blockstyle.tags.div.allowedClasses (
194 align-left, align-center, align-right,
195 csc-frame-frame1, csc-frame-frame2
196 )
197 buttons.blockstyle.tags.table.allowedClasses = csc-frame-frame1, csc-frame-frame2
198 buttons.blockstyle.tags.td.allowedClasses = align-left, align-center, align-right
199 buttons.textstyle.tags.span.allowedClasses = important, name-of-person, detail
200
201 ## Configuration of classes for links
202
203 ## These classes should also be in the list proc.allowedClasses
204
205 ::
206
207 buttons.link.properties.class.allowedClasses = external-link, external-link-new-window, internal-link, internal-link-new-window, download, mail
208 buttons.link.page.properties.class.default = internal-link
209 buttons.link.url.properties.class.default = external-link-new-window
210 buttons.link.file.properties.class.default = download
211 buttons.link.mail.properties.class.default = mail
212
213 ## Configuration specific to the TableOperations feature
214
215 ## Remove the following fieldsets from the properties popups
216
217 ::
218
219 disableAlignmentFieldsetInTableOperations = 1
220 disableSpacingFieldsetInTableOperations = 1
221 disableColorFieldsetInTableOperations = 1
222 disableLayoutFieldsetInTableOperations = 1
223
224 ## Show borders on table creation
225
226 ::
227
228 buttons.toggleborders.setOnTableCreation = 1
229
230 ## Configuration specific to the bold and italic buttons
231
232 ## Add hotkeys associated with bold and italic buttons
233
234 ::
235
236 buttons.bold.hotKey = b
237 buttons.italic.hotKey = i
238
239 ## Configuration of microdata schema
240
241 ::
242
243 schema {
244 sources {
245 schemaOrg = EXT:rtehtmlarea/extensions/MicrodataSchema/res/schemaOrgAll.rdf
246 }
247 }
248 }
249
250 ## front end RTE configuration for the general public
251
252 ::
253
254 RTE.default.FE < RTE.default
255 RTE.default.FE.showStatusBar = 0
256 RTE.default.FE.hideButtons = chMode, blockstyle, textstyle, underline, strikethrough, subscript, superscript, lefttoright, righttoleft, left, center, right, justifyfull, table, inserttag, findreplace, removeformat, copy, cut, paste
257 RTE.default.FE.userElements >
258 RTE.default.FE.userLinks >
259
260 ## tt\_content TCEFORM configuration
261
262 ## Let use all the space available for more comfort.
263
264 ::
265
266 TCEFORM.tt_content.bodytext.RTEfullScreenWidth = 100%
267
268
269 .. _typical-user-tsconfig:
270
271 The following is inserted in User TSconfig:
272 """""""""""""""""""""""""""""""""""""""""""
273
274 ## Enable the RTE by default for all users
275
276 ::
277
278 setup.default.edit_RTE = 1
279
280
281