runtime/doc/faq/webbrowse.docbook

   1 <!-- <?xml version="1.0" ?>
   2 <!DOCTYPE chapter PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
   3  "dtd/kdex.dtd"> -->
   4
   5 <chapter id="webbrowser">
   6 <title>Webbrowsing with &konqueror;</title>
   7 <para>&konqueror; is &kde;'s open source, standards compliant webbrowser.
   8 It's home page is
   9 <ulink
  10 url="http://www.konqueror.org">http://www.konqueror.org</ulink> where a
  11 &konqueror; specific <acronym>FAQ</acronym> can be found.</para>
  12
  13 <qandaset>
  14
  15 <qandaentry>
  16 <question><para>Where does the name &konqueror; come from?</para></question>
  17 <answer><para>It's a word play on the other browsers' names. After the Navigator and the Explorer comes the Conqueror; it's spelled with a K to show that it's part of &kde;. The name change also moves away from <quote>kfm</quote> (the &kde; file manager, &konqueror;'s predecessor) which represented only file management.</para></answer>
  18 </qandaentry>
  19
  20 <qandaentry>
  21 <question><para>Can I run &konqueror; without running &kde;?</para></question>
  22 <answer><para>Yes. Just install &Qt;, kdelibs and kdebase, and from your favorite window manager just launch &konqueror;. It should work just fine, but if it doesn't (&kde; developers don't test that case often), report it to http://bugs.kde.org and try running "kdeinit" before running &konqueror;, it usually helps.
  23 This is of course the same for any other &kde; application. </para>
  24 </answer>
  25 </qandaentry>
  26
  27 <qandaentry>
  28 <question><para>Why doesn't &konqueror; show the contents of an image's <sgmltag class="attribute">ALT</sgmltag> attribute in a tooltip?</para></question>
  29 <answer><para>
  30 There is no standard that states the <sgmltag class="attribute">ALT</sgmltag> attribute should appear as a tooltip. The specification calls for <sgmltag class="attribute">ALT</sgmltag> to be displayed in place of the image, as in text-mode only browsers such at lynx or w3m. Abusing the <sgmltag class="attribute">ALT</sgmltag> attribute is bad for accessibility. Tooltips are supposed to come from the <sgmltag class="attribute">TITLE</sgmltag> attribute and this is implemented in &konqueror;
  31 </para></answer>
  32 </qandaentry>
  33
  34 <qandaentry>
  35 <question>
  36 <para>How do I use &konqueror; as a web browser with a proxy?</para>
  37 </question>
  38 <answer>
  39 <para>&konqueror; can be used with &HTTP; and &FTP; proxies.  To set
  40 up the proxy server in &konqueror;, just select
  41 <menuchoice><guimenu>Settings</guimenu><guisubmenu>Configure
  42 &konqueror;...</guisubmenu></menuchoice> from the &konqueror; menu and
  43 go to the <guilabel>Proxy</guilabel> tab.</para>
  44 </answer>
  45 </qandaentry>
  46
  47 <qandaentry>
  48 <question id="nsbookmark">
  49 <para>How do I import bookmarks from another browser into &konqueror; ?</para>
  50 </question>
  51 <answer>
  52 <para>To import bookmarks from another browser into &konqueror; select
  53 <guimenu>Bookmarks</guimenu><guimenuitem>Edit Bookmarks</guimenuitem>
  54 and then in the <application>Bookmark Editor</application> select
  55 <guimenu>File</guimenu><guimenuitem>Import</guimenuitem>. Then select
  56 the browser you would like to import bookmarks from. In the Open dialog,
  57 navigate to the location of the folder or file your bookmarks are
  58 contained in and click <guilabel>Open</guilabel>
  59 </para>
  60 </answer>
  61 </qandaentry>
  62
  63 <qandaentry>
  64 <question><para>How can I make &konqueror; only show certain bookmarks in the bookmarks toolbar?</para></question>
  65 <answer><para>In &konqueror; go to <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure &konqueror;...</guimenuitem></menuchoice>. Then select <guilabel>Web Behaviour</guilabel> from the icon list. Under the <guilabel>Bookmarks</guilabel> heading, place a check in the box next to <guilabel>Show only marked bookmarks in bookmark toolbar</guilabel>. Now in the <application>Bookmark Editor</application> an option to <guilabel>Show in Toolbar</guilabel> appears on clicking with the &RMB; on any bookmark entry or in the <guimenu>Edit</guimenu> menu when the entry is highlighted. Folders can also be shown in the bookmarks toolbar in much the same way.</para></answer>
  66 </qandaentry>
  67
  68 <qandaentry>
  69 <question>
  70 <para>How do I fool a site into believing &konqueror; is &Netscape; or
  71 some other browser?</para>
  72 </question>
  73 <answer>
  74 <para>In &konqueror;, select
  75 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
  76 Konqueror...</guimenuitem></menuchoice> and in the configuration
  77 dialog, select <guilabel>Browser Identification</guilabel>. Default
  78 and site-specific browser identifications can be set from here.</para>
  79 </answer>
  80 </qandaentry>
  81 <qandaentry>
  82 <question>
  83 <para>&konqueror; is taking a really long time to load webpages, what
  84 could cause this?</para></question>
  85 <answer>
  86 <para>Quite often &konqueror; loading webpages slowly is caused by
  87 <acronym>DNS</acronym> servers with broken <acronym>IPV6</acronym>
  88 support.  Adding the following to <filename>/etc/profile</filename> or any
  89 other script that is sourced on login should solve this problem:
  90 <screen>
  91 export KDE_NO_IPV6=true
  92 </screen>
  93 for bourne compatible shells, and for C-style shells:
  94 <screen>
  95 setenv KDE_NO_IPV6 true
  96 </screen>
  97 </para>
  98 </answer>
  99 </qandaentry>
 100
 101 <qandaentry>
 102 <question>
 103 <para>How do I configure &konqueror; to run &Java; applets?</para>
 104 </question>
 105 <answer>
 106 <para>Choose
 107 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
 108 &konqueror;...</guimenuitem></menuchoice> from &konqueror;'s menubar
 109 and then select <guilabel>Java &amp; Javascript</guilabel>. Set the
 110 <guilabel>Path to Java executable</guilabel> correctly. If it doesn't
 111 work, please check the <ulink
 112 url="http://www.konqueror.org/javahowto/">Konqueror + Java
 113 HOWTO</ulink>.</para>
 114 </answer>
 115 </qandaentry>
 116
 117
 118 <qandaentry>
 119 <question>
 120 <para>How do I block unrequested popup windows in &konqueror;?</para>
 121 </question>
 122 <answer>
 123 <para>&konqueror; has a new 'smart' policy for JavaScript popups. From the
 124 &konqueror; main window, select <menuchoice><guimenu>Settings</guimenu>
 125 <guimenuitem>Configure &konqueror;...</guimenuitem></menuchoice> and then
 126 <guilabel>Java &amp; JavaScript</guilabel>. On the
 127 <guilabel>JavaScript</guilabel> tab, under <guilabel>Global JavaScript
 128 Policies</guilabel> set the radio button beside <guilabel>Open new
 129 windows:</guilabel> to <guilabel>Smart</guilabel>.
 130 </para>
 131 </answer>
 132 </qandaentry>
 133
 134 <qandaentry>
 135 <question>
 136 <para>Why doesn't my banking site work with &konqueror;?  It pops up a new
 137 window with the login screen in other browsers, but not in
 138 &konqueror;.</para>
 139 </question>
 140 <answer>
 141 <para>
 142 Make sure you have Javascript enabled, and the default JavaScript web popups
 143 policy set to <guilabel>Ask</guilabel> or <guilabel>Allow</guilabel>.  The
 144 <guilabel>Smart</guilabel> policy is not always sufficient for some banks.
 145 Many banks also require &Java; support.  You can find more help on enabling
 146 this at <ulink
 147 url="http://www.konqueror.org/">http://www.konqueror.org/</ulink>.
 148 </para>
 149 </answer>
 150 </qandaentry>
 151
 152 <qandaentry>
 153 <question>
 154 <para>Can &konqueror; use user-specified stylesheets, like those in the
 155 Firefox adblock extention?</para>
 156 </question>
 157 <answer>
 158 <para>Yes, you can set &konqueror; to use any kind of valid
 159 <acronym>css</acronym> stylesheet to filter webcontent or improve accessibility.
 160 From the &konqueror; main window simply click
 161 <menuchoice><guimenu>Settings</guimenu>
 162 <guimenuitem>Configure &konqueror;...</guimenuitem></menuchoice> and select
 163 <guilabel>Stylesheets</guilabel>. Set the radio button to
 164 <guilabel>Use user-defined stylesheet</guilabel> and browse to where the
 165 stylesheet you want to use is located. Alternatively, you can select
 166 <guilabel>Use accessibility stylesheet defined in "Customize"
 167 tab</guilabel> and then set your own options.</para>
 168 <para>
 169 An example of <acronym>css</acronym> rules that implement ad blocking can be
 170 found at:
 171 <ulink url="http://www.mozilla.org/support/firefox/adblock">
 172 http://www.mozilla.org/support/firefox/adblock</ulink>.
 173 </para>
 174 </answer>
 175 </qandaentry>
 176 <qandaentry>
 177 <question><para>
 178 Why does &konqueror; display a plain grey square when I try to view flash animations, even though the flash plugin is installed?
 179 </para></question>
 180 <answer><para>
 181 Under the latest versions of X.org, having the composite extension loaded can cause problems with the flash plugin. Try disabling the composite extension and see if normal flash operation is restored.
 182 </para></answer>
 183 </qandaentry>
 184
 185 <qandaentry>
 186 <question>
 187 <para>Why can't &konqueror; render &GIF; images?</para>
 188 </question>
 189 <answer>
 190 <para>It is because you did not enable &GIF; support in &Qt;.  Please see
 191 <xref linkend="gif"/> for more details.</para>
 192 </answer>
 193 </qandaentry>
 194
 195 <qandaentry>
 196 <question><para>When I try to open a web page with &konqueror;, I get the
 197 message: <quote>There appears to be a configuration error. You have
 198 associated Konqueror with text/html, but it cannot handle this file
 199 type.</quote></para>
 200 </question>
 201 <answer>
 202 <para>You need to make sure that the embedding settings for the text/html
 203 <acronym>MIME</acronym> type are correct:
 204 <orderedlist>
 205 <listitem><para>In &konqueror;, go to
 206 <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
 207 &konqueror;...</guimenuitem></menuchoice> and then to the <guilabel>File
 208 Associations</guilabel> page.</para></listitem> <listitem><para>Open
 209 text->html in the tree view.</para></listitem> <listitem><para>Click on the
 210 <guilabel>Embedding</guilabel> tab. Make sure that <guilabel>Left Click
 211 Action</guilabel> is set to <guilabel>Show file in embedded
 212 viewer</guilabel>, and that <guilabel>KHTML (khtml)</guilabel> is at the top
 213 of <guilabel>Services Preference Order</guilabel>.</para></listitem>
 214 </orderedlist>
 215 </para>
 216 </answer>
 217 </qandaentry>
 218
 219 </qandaset>
 220 </chapter>
 221
 222