b3a948f293927487963d04f46481d35a4a57bbd2
[Packages/TYPO3.CMS.git] / typo3 / sysext / rtehtmlarea / Documentation / DefaultConfigurations / Default / Index.rst
1 .. ==================================================
2 .. FOR YOUR INFORMATION
3 .. --------------------------------------------------
4 .. -*- coding: utf-8 -*- with BOM.
5
6 .. include:: ../../Includes.txt
7
8
9
10 .. _default-configuration:
11
12 Default configuration of RTE content transformation
13 ---------------------------------------------------
14
15 This default configuration establishes default settings in Page
16 TSconfig for RTE content transformation.
17
18 For documentation of RTE tranformations, see:
19 `http://typo3.org/documentation/document-library/core-
20 documentation/doc\_core\_api/4.1.0/view/5/2/
21 <http://typo3.org/documentation/document-library/core-
22 documentation/doc_core_api/current/view/5/2/>`_
23
24 For documentation of Page TSconfig configuration of RTE processing,
25 see: `http://typo3.org/documentation/document-
26 library/references/doc\_core\_tsconfig/current/view/1/3/
27 <http://typo3.org/documentation/document-
28 library/references/doc_core_tsconfig/current/view/1/3/>`_
29
30 For documentation of the HTMLparser, see:
31 `http://typo3.org/documentation/document-
32 library/references/doc\_core\_tsref/current/view/5/17/
33 <http://typo3.org/documentation/document-
34 library/references/doc_core_tsref/current/view/5/17/>`_
35
36 For documentation of RTE settings in TCA, see:
37 `http://typo3.org/documentation/document-library/core-
38 documentation/doc\_core\_api/4.1.0/view/4/3/#id3665895
39 <http://typo3.org/documentation/document-library/core-
40 documentation/doc_core_api/current/view/4/3/>`_
41
42
43 .. _default-configuration-page-tsconfig:
44
45 The following is inserted in Page TSconfig:
46 """""""""""""""""""""""""""""""""""""""""""
47
48 ## Default RTE processing rules
49
50 ::
51
52 RTE.default.proc {
53
54 ## TRANSFORMATION METHOD
55
56 ## We assume that CSS Styled Content is used.
57
58 ::
59
60 overruleMode = ts_css
61
62 ## DO NOT CONVERT BR TAGS INTO LINEBREAKS
63
64 ## br tags in the content are assumed to be intentional.
65
66 ::
67
68 dontConvBRtoParagraph = 1
69
70 ## PRESERVE DIV SECTIONS - DO NOT REMAP TO P
71
72 ::
73
74 preserveDIVSections = 1
75
76 ## TAGS ALLOWED OUTSIDE P & DIV
77
78 ::
79
80 allowTagsOutside = address, article, aside, blockquote, footer, header, hr, nav, section
81
82 ## TAGS ALLOWED
83
84 ## Added to the default internal list: b,i,u,a,img,br,div,center,pre,f
85 ont,hr,sub,sup,p,strong,em,li,ul,ol,blockquote,strike,span
86
87 ## But, for the sake of clarity, we use a complete list in alphabetic
88 order.
89
90 ## center, font, link, meta, o:p, strike, sdfield, style, title and u
91 will be removed on entry (see below).
92
93 ## b and i will be remapped on exit (see below).
94
95 ## Note that the link accessibility feature of htmlArea RTE does
96 insert img tags.
97
98 ::
99
100 allowTags (
101 a, abbr, acronym, address, article, aside, b, bdo, big, blockquote, br, caption, center, cite, code, col, colgroup, dd, del, dfn, dl, div, dt, em, font, footer,
102 header, h1, h2, h3, h4, h5, h6, hr, i, img, ins, kbd, label, li, link, meta, nav, ol, p, pre, q, samp, sdfield, section, small,
103 span, strike, strong, style, sub, sup, table, thead, tbody, tfoot, td, th, tr, title, tt, u, ul, var
104 )
105
106 ## TAGS DENIED
107
108 ## Make sure we can set rules on any tag listed in allowTags.
109
110 ::
111
112 denyTags >
113
114 ## ALLOWED P & DIV ATTRIBUTES
115
116 ## Attributes class and align are always preserved
117
118 ## Align attribute will be unset on entry (see below)
119
120 ## This is a list of additional attributes to keep
121
122 ::
123
124 keepPDIVattribs = id, title, dir, lang, xml:lang, itemscope, itemtype, itemprop
125
126 ## ALLOW TO WRITE ABOUT HTML
127
128 ::
129
130 dontUndoHSC_db = 1
131 dontHSC_rte = 1
132
133 ## CONTENT TO DATABASE
134
135 ::
136
137 entryHTMLparser_db = 1
138 entryHTMLparser_db {
139
140 ## TAGS ALLOWED
141
142 ## Always use the same list of allowed tags.
143
144 ::
145
146 allowTags < RTE.default.proc.allowTags
147
148 ## TAGS DENIED
149
150 ## Make sure we can set rules on any tag listed in allowTags.
151
152 ::
153
154 denyTags >
155
156 ## AVOID CONTENT BEING HSC'ed TWICE
157
158 ::
159
160 htmlSpecialChars = 0
161
162 ::
163
164 tags {
165
166 ## REMOVE IMG TAGS
167
168 ::
169
170 img.allowedAttribs = 0
171 img.rmTagIfNoAttrib = 1
172
173 ## CLEAN ATTRIBUTES ON THE FOLLOWING TAGS
174
175 ::
176
177 span.fixAttrib.style.unset = 1
178 span.allowedAttribs = id, title, dir, lang, xml:lang, class, itemscope, itemtype, itemprop
179 span.rmTagIfNoAttrib = 1
180 p {
181 allowedAttribs = id, title, dir, lang, xml:lang, class, itemscope, itemtype, itemprop
182 fixAttrib.align.unset = 1
183 }
184 div < .p
185 hr.allowedAttribs = class
186 b.allowedAttribs < .span.allowedAttribs
187 bdo.allowedAttribs < .span.allowedAttribs
188 big.allowedAttribs < .span.allowedAttribs
189 blockquote.allowedAttribs < .span.allowedAttribs
190 cite.allowedAttribs < .span.allowedAttribs
191 code.allowedAttribs < .span.allowedAttribs
192 del.allowedAttribs < .span.allowedAttribs
193 dfn.allowedAttribs < .span.allowedAttribs
194 em.allowedAttribs < .span.allowedAttribs
195 i.allowedAttribs < .span.allowedAttribs
196 ins.allowedAttribs < .span.allowedAttribs
197 kbd.allowedAttribs < .span.allowedAttribs
198 label.allowedAttribs < .span.allowedAttribs
199 q.allowedAttribs < .span.allowedAttribs
200 samp.allowedAttribs < .span.allowedAttribs
201 small.allowedAttribs < .span.allowedAttribs
202 strike.allowedAttribs < .span.allowedAttribs
203 strong.allowedAttribs < .span.allowedAttribs
204 sub.allowedAttribs < .span.allowedAttribs
205 sup.allowedAttribs < .span.allowedAttribs
206 tt.allowedAttribs < .span.allowedAttribs
207 u.allowedAttribs < .span.allowedAttribs
208 var.allowedAttribs < .span.allowedAttribs
209 }
210
211 ## REMOVE OPEN OFFICE META DATA TAGS, WORD 2003 TAGS, LINK, META,
212 STYLE AND TITLE TAGS, AND DEPRECATED HTML TAGS
213
214 ## We use this rule instead of the denyTags rule so that we can
215 protect custom tags without protecting these unwanted tags.
216
217 ::
218
219 removeTags = center, font, link, o:p, sdfield, meta, style, title, strike, u
220
221 ## PROTECT CUSTOM TAGS
222
223 ::
224
225 keepNonMatchedTags = protect
226 }
227
228 ::
229
230 HTMLparser_db {
231
232 ## STRIP ALL ATTRIBUTES FROM THESE TAGS
233
234 ## If this list of tags is not set, it will default to:
235 b,i,u,br,center,hr,sub,sup,strong,em,li,ul,ol,blockquote,strike.
236
237 ## However, we want to keep xml:lang attribute on most tags and tags
238 from the default list where cleaned on entry.
239
240 ::
241
242 noAttrib = br
243
244 ## XHTML COMPLIANCE
245
246 ## Note that applying xhtml\_cleaning on exit would break non-standard
247 attributes of typolink tags
248
249 ::
250
251 xhtml_cleaning = 1
252 }
253
254 ::
255
256 exitHTMLparser_db = 1
257 exitHTMLparser_db {
258
259 ## KEEP ALL TAGS
260
261 ## Unwanted tags were removed on entry.
262
263 ## Without this rule, the parser will remove all tags! Presumably,
264 this rule will be more efficient than repeating the allowTags rule
265
266 ::
267
268 keepNonMatchedTags = 1
269
270 ## AVOID CONTENT BEING HSC'ed TWICE
271
272 ::
273
274 htmlSpecialChars = 0
275 }
276 }
277
278 ## Use same RTE processing rules in FE
279
280 ::
281
282 RTE.default.FE.proc < RTE.default.proc
283
284 ## RTE processing rules for bodytext column of tt\_content table
285
286 ## Erase settings from other extensions
287
288 ::
289
290 RTE.config.tt_content.bodytext >
291
292 ## Make sure we use ts\_css transformation
293
294 ::
295
296 RTE.config.tt_content.bodytext.proc.overruleMode = ts_css
297 RTE.config.tt_content.bodytext.types.text.proc.overruleMode = ts_css
298 RTE.config.tt_content.bodytext.types.textpic.proc.overruleMode = ts_css
299
300
301