runtime/doc/kcontrol/useragent/index.docbook

   1 <?xml version="1.0" ?>
   2 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
   3 "dtd/kdex.dtd" [
   4 <!ENTITY % addindex "IGNORE">
   5 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
   6 ]>
   7
   8 <article lang="&language;">
   9 <title>Browser Identification</title>
  10 <articleinfo>
  11 <authorgroup>
  12 <author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
  13 <!-- TRANS:ROLES_OF_TRANSLATORS -->
  14 </authorgroup>
  15
  16 <date>2003-10-12</date>
  17 <releaseinfo>3.2</releaseinfo>
  18
  19 <keywordset>
  20 <keyword>KDE</keyword>
  21 <keyword>KControl</keyword>
  22 <keyword>user agent</keyword>
  23 <keyword>browser</keyword>
  24 <keyword>identification</keyword>
  25 </keywordset>
  26
  27 </articleinfo>
  28
  29 <sect1 id="user-agent">
  30 <title>Browser Identification</title>
  31
  32
  33 <sect2 id="user-agent-intro">
  34 <title>Introduction</title>
  35
  36 <para>When &konqueror; connects to a web site to retrieve information,
  37 some basic identifying information is sent to the web site in the form
  38 of a <quote>User Agent</quote> header.</para>
  39
  40 <para>Because of minor differences in the way that different web
  41 browsers function, web sites that rely too much on a single browser may
  42 sometimes not display as intended when viewed using another
  43 browser. Some web sites are smart enough to examine the contents of the
  44 user agent header and incorporate this information in the
  45 <acronym>HTML</acronym> code so that the content is displayed correctly
  46 regardless of the browser used.</para>
  47
  48 <para>However, you may find that some web sites refuse to function
  49 correctly unless you are using a browser recognized as
  50 <quote>proper</quote> by that site. In these cases, you may find it
  51 necessary to fool the web site by having &konqueror; report itself to be
  52 another browser by means of the user agent header.</para>
  53
  54 </sect2>
  55
  56 <sect2 id="user-agent-use">
  57 <title>Use</title>
  58
  59 <para>In this module you can configure the
  60 type of browser that &konqueror; will report itself to be. You can
  61 control this information by web site. Usually, the list box that is
  62 labeled <guilabel>Site/Domain Specific Identification</guilabel> will be
  63 empty, so that &konqueror; will always use its default useragent
  64 string.</para>
  65
  66 <para>You can disable the sending of a user agent entirely, by
  67 unchecking the <guilabel>Send identification</guilabel>
  68 checkbox.  This may cause strange behavior on some sites, and may even
  69 deny you access to some websites, so disable this with caution.</para>
  70
  71 <para>To configure a new agent binding, press the
  72 <guibutton>New...</guibutton> button.  Type the name of the server or
  73 a domain in the text box at the top of the dialog that pops up, which
  74 is labeled <guilabel>When browsing the following
  75 site</guilabel>.</para>
  76
  77 <para>Note that you can <emphasis>not</emphasis> use the wildcard
  78 character <token>*</token> in this text box. However, the string
  79 <userinput>kde.org</userinput> will match all hosts in the domain
  80 <systemitem>kde.org</systemitem></para>
  81
  82 <para>After typing the name of the server, type in the identifying
  83 string in the next combo box, which is labeled <guilabel>Use the
  84 following identity:</guilabel>, or choose a string from the list. If
  85 you don't choose a string from the list, you will need to know what a
  86 valid string from the browser looks like. For example, you could type
  87 <userinput>Mozilla/4.0 (compatible; MSIE 4.0)</userinput>. </para>
  88
  89 <para>In the field labeled <guilabel>Alias (description)</guilabel>
  90 you can enter a descriptive name for the configured binding, &eg;
  91 <userinput>Netscape Navigator 4.75 on Linux</userinput> for the
  92 useragent string <userinput>Mozilla/4.75 (X11; U; Linux 2.2.14
  93 i686)</userinput>.</para>
  94
  95 <para>You can click on an existing entry in the <guilabel>Configured
  96 agent bindings</guilabel> list, and then modify the contents of the
  97 text boxes, followed by clicking <guibutton>Change...</guibutton>.</para>
  98
  99 <para>The <guibutton>Delete</guibutton> button can be used to delete
 100 the selected entry in the list of configured agent bindings.  The
 101 <guibutton>Delete All</guibutton> will remove all the configured user
 102 agent strings.  Click the <guibutton>Apply</guibutton> to take your
 103 changes in effect.</para>
 104
 105 <para>You can use the checkboxes at the top of the screen to build a
 106 user agent that is uniquely yours, by choosing your own combination of
 107 operating system name and version, platform, processor type, and
 108 language.</para>
 109
 110 <para>In all cases, the user agent that is being sent by default is
 111 displayed in bold text at the top of the page.</para>
 112
 113 </sect2>
 114
 115 </sect1>
 116
 117 </article>