tde-i18n/tde-i18n-en_GB/docs/tdebase/kcontrol/kcmcss/index.docbook

<?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>