summaryrefslogtreecommitdiffstats
path: root/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmcss/index.docbook
blob: 34b33d4c1d771ec8b5b0c8b55d21b2934718cb06 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % British-English "INCLUDE"
> <!-- change language only here -->
]>

<article>
<articleinfo>

<authorgroup>
<author
>&Lauri.Watts; &Lauri.Watts.mail;</author>
<othercredit role="translator"
><firstname
>John</firstname
><surname
>Knight</surname
><affiliation
><address
><email
>anarchist_tomato@herzeleid.net</email
></address
></affiliation
><contrib
>Conversion to British English</contrib
></othercredit
> 
</authorgroup>

<date
>2003-10-12</date>
<releaseinfo
>3.2</releaseinfo>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>CSS</keyword>
<keyword
>Stylesheets</keyword>
<keyword
>Accessibility</keyword>
</keywordset>

</articleinfo>

<sect1 id="stylesheets">

<title
>Stylesheets</title>

<sect2>
<title
>Introduction</title>

<para
><acronym
>CSS</acronym
> style sheets affect the way web pages appear. <acronym
>CSS</acronym
> stands for <emphasis
>C</emphasis
>ascading <emphasis
>S</emphasis
>tyle <emphasis
>S</emphasis
>heets.</para>

<para
>&kde; can use its own stylesheet, based on simple defaults and the colour scheme you are using for your desktop. &kde; can also use a stylesheet that you have written yourself. Finally, you can specify a stylesheet in this module. The options presented in this module are tuned for accessibility purposes, especially for people with reduced vision.</para>

<para
>Your choices here affect every &kde; application that renders HTML with &kde;'s own renderer, which is called tdehtml. These include &kmail;, &khelpcenter; and of course &konqueror;. Choices here do not affect other browsers such as &Netscape;.</para>

<para
>The module has two pages, <guilabel
>General</guilabel
>, where you can choose which stylesheet to use, and <guilabel
>Customise</guilabel
> where you can design an accessibility stylesheet.</para>

</sect2>

<sect2 id="css-general">
<title
>General</title>

<para
>This page contains the following options:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Use default stylesheet</guilabel
></term>
<listitem>
<para
>&kde; will use the default stylesheet. Some of the colours will default to those defined in your chosen colour scheme. Most settings are easily overridden by the page you are viewing.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Use user-defined stylesheet</guilabel
></term>
<listitem>
<para
>&kde; will use a stylesheet that you have written yourself. You can use the browse button to locate the stylesheet on your system. <acronym
>CSS</acronym
> files traditionally have a <literal role="extension"
>.css</literal
> extension, but this is not required.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Use accessibility stylesheet defined in &quot;Customise&quot;-tab</guilabel
></term>
<listitem>
<para
>Use the settings defined in the <guilabel
>Customise</guilabel
> tab. Enabling this option will enable the options on the <guilabel
>Customise</guilabel
> page.</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="css-customize">
<title
>Customise</title>

<para
>Here you can set up a user stylesheet. The options available are only a subset of the instructions you can add in a stylesheet, and they are geared towards people with reduced vision, to allow users to create a stylesheet that makes web pages and the &kde; help files more readable.</para>

<para
>The options on this page are disabled unless you chose <guilabel
>Use accessibility stylesheet defined in &quot;Customise&quot;-tab</guilabel
> on the previous page.</para>

<sect3>
<title
><guilabel
>Font Family</guilabel
></title>

<variablelist>
<varlistentry>
<term
><guilabel
>Base family</guilabel
></term>
<listitem>
<para
>Choose a font family to use for body text.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Use same family for all text</guilabel
></term>
<listitem>
<para
>If you enable this, then the same font family will be used for all text, regardless of the settings on the page you are viewing. This is useful for pages which have used a decorative or hard to read font for headlines.</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3>
<title
>Font Size</title>

<variablelist>
<varlistentry>
<term
><guilabel
>Base Font Size</guilabel
></term>
<listitem>
<para
>This is the default size for text on the page. Many web sites set their font sizes relative to this default, using <quote
>larger</quote
> or <quote
>+1</quote
> to make the text bigger, and <quote
>smaller</quote
> or <quote
>-1</quote
> to make the text smaller.</para>
<para
>Many people design their web pages on platforms where the ordinary default text size is too large for the average user to read, so it is very common to come across web pages that have forced the font smaller in this way.</para>
<para
>This setting will allow you to set the default font to a comfortable size, so that the relative sizes are also enlarged enough to be comfortable.</para>
<para
>Do not forget you can also have &konqueror; enforce a minimum size, so that text is <emphasis
>never</emphasis
> too small to read. Set that under Behaviour, in the Web Browser section in &kcontrol;.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Use same size for all elements</guilabel
></term>
<listitem>
<para
>If you enable this option, then all text will be rendered at your specified font size, regardless of the instructions the page contains. Relative font sizes as discussed earlier, and even specific instructions that text should be rendered at a certain size will be overridden here.</para>
</listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3>
<title
>Colours</title>

<variablelist>
<varlistentry>
<term
><guilabel
>Black on White</guilabel
></term>
<listitem>
<para
>Many people with reduced vision find black text on a white screen gives the most contrast, and is easiest to read. If this applies to you, you can set this here.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>White on Black</guilabel
></term>
<listitem>
<para
>Many other people with reduced vision find the opposite to be true, that white text on a black screen is easier to read.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Custom</guilabel
></term>
<listitem>
<para
>Still other people find that pure black and white, in either order, is difficult to read. You can set custom colours here for both the <guilabel
>Background</guilabel
> and the <guilabel
>Foreground</guilabel
>.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Use same colour for all text</guilabel
></term>
<listitem>
<para
>Many web sites use a different, often contrasting colour for headings or other flourishes. If this interferes with your ability to read the content, you can enable this checkbox to have &kde; use the colours you have set above for all text.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3>
<title
>Images</title>

<variablelist>
<varlistentry>
<term
><guilabel
>Suppress images</guilabel
></term>
<listitem>
<para
>If you do not want to view images, you can turn this off here.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Suppress background images</guilabel
></term>
<listitem>
<para
>One major problem for reduced vision users is that background images do not give sufficient contrast to allow them to read the text. You can disable background images here, independently of your choice above to view all images.</para>
</listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3>
<title
>Preview</title>

<para
>The <guibutton
>Preview</guibutton
> allows you to see the effect of your changes. A window will pop up, showing how several types of headings will appear with your stylesheet, and a sentence in the default body text.</para>

<para
>This should allow you to fine tune your stylesheet until you have something that you can comfortably read.</para>

<para
>Happy surfing!</para>

</sect3>

</sect2>

</sect1>

</article>