2
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
4
<!ENTITY nsplugins-kcontrol SYSTEM "nsplugin.docbook">
5
<!ENTITY % addindex "IGNORE">
6
<!ENTITY % British-English "INCLUDE"
7
> <!-- change language only here -->
10
<article lang="&language;">
15
>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
16
<othercredit role="translator"
24
>anarchist_tomato@herzeleid.net</email
28
>Conversion to British English</contrib
50
<sect1 id="konq-browsing">
52
>Browsing With &konqueror;</title>
55
>The &konqueror; Browser module of &kcontrol; allows you to select various options for the appearance and behaviour of &konqueror;, the integrated web browser of &kde;.</para>
57
<sect2 id="kbrowse-html">
63
>The first option you can enable on this page is <guilabel
64
>Enable completion of forms</guilabel
65
>. If you check this box, &konqueror; will try to remember what you answer to form questions, and will try to fill in forms for you with the answers you previously used.</para>
68
>You can configure the number of form items &konqueror; remembers with the slider below labelled <guilabel
69
>Maximum completions</guilabel
74
>Of course, anything &konqueror; fills in a form with, you can still edit before submitting the form!</para
78
>The next option is <guilabel
79
>Change cursor over links</guilabel
80
>. If this option is selected, the shape of the cursor will change (usually to a hand) whenever it moves over a hyperlink. This makes it easy to identify links, especially when they are in the form of images.</para>
83
>&konqueror; defaults to a single window per page, but has the capability to open multiple <firstterm
85
> inside a single window. &konqueror; also, by default, has a &MMB; shortcut to open any link in a new window. If you enable <guilabel
86
>Open links in new tab instead of in new window</guilabel
87
> you can &MMB; click on a link to have it open in a new tab.</para>
90
>If you are using tabbed browsing, you can choose if a newly opened tab becomes the active (<quote
92
>) tab, or goes to the back. On a slow internet connection, or while browsing a page that has a list of headlines or other links in a list, you may like to have the new tabs load in the background while you continue reading. In this case, leave this setting disabled. If you prefer to go straight to the new page, leaving the old one in the background to return to later, enable it.</para>
95
>If you close a window in &konqueror; that has multiple tabs open, &konqueror; will ask you if you're sure that you meant to close it. You can toggle on and off this behaviour with the <guilabel
96
>Confirm when closing windows with multiple tabs</guilabel
100
>As a convenience feature, if you enable <guilabel
101
>Right click goes back in history</guilabel
102
>, then clicking an empty area (&ie; not a link) in the &konqueror; window will act as if you pressed the <guiicon
104
> button on the toolbar.</para>
107
>The checkbox labelled <guilabel
108
>Automatically load images</guilabel
109
>, allows you to control whether images on web pages are loaded by default. Unless you have a very slow connection, you will probably want to leave this option selected, as there are many web pages that are difficult to use without images. If you don't select the option to automatically load images, you can still view the text on the page, and then load the images if you need them.</para>
113
>Allow automatic delayed reloading/redirecting</guilabel
114
> allows websites to send you to another page without your interaction. In many cases, this is a convenience. For example, the website has moved to a new <acronym
116
>. Many webmasters in this situation will put up a page on the old site, telling you that it has moved and you may like to change your bookmark, and then automatically move you along to the new website. However, such features can be confusing, or annoying, when misused, and so you may wish to disable it.</para>
119
>The next setting is <guilabel
120
>Underline links:</guilabel
121
>. You can choose to underline links <guilabel
123
>. If this option is selected, any text on web pages that acts as a link will be shown in an underlined font. While many web pages do use colour to distinguish text that acts as a link, underlining makes it very easy to spot links.</para>
126
>If you don't like underlined links, you can choose <guilabel
128
>, so that no links are underlined. Or you can choose a middle ground, <guilabel
130
>, so that links are underlined when the mouse cursor is resting over them, and not underlined the rest of the time.</para>
133
>Many web pages use animated gif images, and these can be very annoying, and in some cases, quite a drain on your system resources. The <guilabel
134
>Animations</guilabel
135
> option lets you choose when animations are enabled. The default is enabled, but you can set this to disabled, or to run the animation only once, even if the file itself contains instructions that the animation should run more times, or continuously.</para>
139
<sect2 id="kbrowse-appearance">
145
>Under this tab, you can select various options related to the use of fonts. Although the shapes and sizes of fonts are often part of the design of a web page, you can select some default settings for &konqueror; to use.</para>
148
>The first thing you can set here is the font size. There are two settings which work together to allow you a comfortable browsing experience.</para>
151
>Firstly, you can set a <guilabel
152
>Minimum Font Size</guilabel
153
>. This means, even if the font size is set specifically in the page you are viewing, &konqueror; will ignore that instruction and never show smaller fonts than you set here.</para>
156
>Next you can set a <guilabel
157
>Medium Font Size</guilabel
158
>. This is not only the default size of text, used when the page doesn't specify sizes, but it is also used as the base size that relative font sizes are calculated against. That is, the <acronym
162
>, it means smaller than the size you set for this option.</para>
165
>For either option, you can select the exact font size in points by using the up/down spin control (or just typing) next to the option label.</para>
168
>These options are independent of each other. Pages that do not set a font size, or ask for the default, will display with the size you set from <guilabel
169
>Medium Font Size</guilabel
170
>, while any pages that ask for a size smaller than your <guilabel
171
>Minimum Font Size</guilabel
172
> setting will instead show that size. The one does not affect the other.</para>
175
>The remaining options are for the fonts to be associated with different types of markup used in <acronym
177
> pages. Note that many web pages may override these settings. If you click anywhere on a control which shows a font name, a list of font names appears, and you can select a different font if you like. (If there are a lot of fonts, a vertical scrollbar appears in the list to allow you to scroll through all of the fonts.)</para>
180
>You can set a font for each <quote
185
>, by changing the character set in the
186
first drop down box, and then selecting a font for each category below.
187
This would take quite some time, so you may just want to set up the
188
fonts for your default character set. Most English speaking users will
192
>Below this, you can set a <guilabel
193
>Font size adjustment for this encoding</guilabel
194
>. Sometimes the fonts you want to use for a particular encoding or language are much larger or smaller than average, so you can use this setting to bring them into line.</para>
197
>You can set a default encoding that &konqueror; should assume pages are when rendering them. The default setting is <guilabel
198
>Use language encoding</guilabel
199
>, but you can change it to any encoding available in the list.</para>
203
<sect2 id="kbrowse-java">
205
>&Java; and JavaScript</title>
208
>&Java; allows applications to be downloaded and run by a web browser, provided you have the necessary software installed on your machine. Many web sites make use of &Java; (for example, online banking services or interactive gaming sites). You should be aware that running programs from unknown sources could pose a threat to the security of your computer, even if the potential extent of the damage is not great.</para>
211
>The checkboxes under <guilabel
212
>Global Settings</guilabel
213
> allows you to turn &Java; support on for all web sites by default. You can also select to turn &Java; on or off for specific hosts. To add a policy for a specific host, click the <guilabel
215
> button to bring up a dialogue in which you can type the host name and then choose to accept or reject &Java; code from that particular host, which will add the domain to the list on the left of the page.</para>
218
>You can select a host in the list, and click the <guilabel
220
> button to choose a different policy for that host. Clicking the <guilabel
222
> button removes the policy for the selected host; after deletion, the global settings will then apply to that host. You can import policies from a file by clicking the <guilabel
224
> button. To save the current list to a compressed archive file, click the <guilabel
229
>Finally, the group of controls labelled <guilabel
230
>Java Runtime Settings</guilabel
231
> allows you to set some options for the way in which &Java; should run. These options are useful for diagnosing problems, or if you are a &Java; developer, and should not normally need adjusting.</para>
234
>If you select the <guilabel
235
>Show Java Console</guilabel
236
> option, &konqueror; will open a console window from which &Java; applications can read and write text. While most &Java; applications will not require such a console, it could be helpful in diagnosing problems with &Java; applications.</para>
241
> will cause the <acronym
243
>to use &kde;'s own <acronym
245
> transports for network connections.</para>
249
>Use security manager</guilabel
250
> is normally enabled by default. This setting will cause the <acronym
252
> to run with a Security Manager in place. This will keep applets from being able to read and write to your file system, creating arbitrary sockets, and other actions which could be used to compromise your system. Disable this option at your own risk. You can modify your <filename
255
>/.java.policy</filename
256
> file with the &Java; policytool utility to give code downloaded from certain sites more permissions.</para>
260
>Shutdown Applet Server when inactive</guilabel
261
> checkbox allows you to save resources by closing the &Java; Applet Server when it is not in use, rather than leaving it running in the background. Leaving this disabled may make &Java; applets start up faster, but it will use system resources when you are not using a &Java; applet. If you enable this, you can set a timeout.</para>
264
>You can either opt to have &konqueror; automatically detect the &Java; installation on your system, or specify the path to the installation yourself by selecting <guilabel
265
>Use user-specified Java</guilabel
266
>. You may want to choose the latter method, for instance, if you have multiple &Java; installations on your system, and want to specify which one to use. If the &Java; Virtual Machine you are using requires any special startup options, you can type them in the text box labelled <guilabel
267
>Additional Java Arguments</guilabel
272
<sect2 id="kbrowse-javascript">
277
>Despite the name, JavaScript is not related at all to &Java;.</para>
280
>The first part of this page works the same as the &Java; page settings.</para>
283
>The checkboxes under <guilabel
284
>Global Settings</guilabel
285
> allow you to turn JavaScript support on for all web sites by default. You can also select to turn JavaScript on or off for specific hosts. To add a policy for a specific host, click the <guilabel
287
> button to bring up a dialogue in which you can type the host name and then choose to accept or reject JavaScript code from that particular host, which will add the domain to the list on the left of the page.</para>
290
>You can select a host in the list, and click the <guilabel
292
> button to choose a different policy for that host. Clicking the <guilabel
294
> button removes the policy for the selected host; after deletion, the global settings will then apply to that host. You can import policies from a file by clicking the <guilabel
296
> button. To save the current list to a compressed archive file, click the <guilabel
301
>The final set of options on this page determine what happens when a page uses JavaScript for specific actions.</para>
304
>You can individually enable or disable the ability of JavaScript to manipulate your windows by moving, resizing or changing focus. You can also disable JavaScript from changing the status bar text, so that for instance, you can always see where links will take you when clicked.The choices for these options are <guilabel
311
>For opening a new window, there is even more control. You can set &konqueror; to <guilabel
313
> all such requests, <guilabel
315
> each time a request is made, or <guilabel
317
> all popup requests.</para>
322
> setting will only allow JavaScript popup windows when you have explicitly chosen a link that creates one.</para>
326
<sect2 id="kbrowse-plugins">
331
>The first setting here is <guilabel
332
>Enable Plugins globally</guilabel
333
>. If you disable this checkbox, then &konqueror; will not use any plugins. If you enable it, then any installed and configured plugins that it can find will be used by &konqueror;</para>
336
>You can also restrict &konqueror; to <guilabel
337
>Only allow HTTP and HTTPS URLs for plugins</guilabel
338
> by checking the box.</para>
341
&nsplugins-kcontrol; </sect1>
added
removed
docs/kdebase-runtime/kcontrol/khtml/index.docbook
