runtime/doc/kcontrol/khtml/nsplugin.docbook

   1 <sect2 id="nsplugins">
   2 <title>&Netscape; Plugins</title>
   3
   4 <sect3 id="nsplugins-intro">
   5 <title>Introduction</title>
   6
   7 <para>As &Netscape;'s <application>Navigator</application> has been a
   8 web browsing standard for many years, so-called &Netscape; plugins have
   9 appeared that allow rich web content.  Using those plugins, web sites
  10 can contain <acronym>PDF</acronym> files, flash animations, video, &etc;
  11 With &konqueror;, you can still use these plugins to take advantage of
  12 rich web content.</para>
  13
  14 <note><para>&Netscape; plugins should not be confused with &konqueror;
  15 plugins. The latter ones specifically extend &konqueror;'s
  16 functionality; they are normally not used to display rich web
  17 content.</para></note>
  18
  19 </sect3>
  20
  21 <sect3 id="nsplugins-scan">
  22 <title>Scan</title>
  23
  24 <para>&konqueror; has to know where your &Netscape; plugins are
  25 installed.  This can be in several places, &ie; you might have
  26 system-wide plugins in <filename
  27 class="directory">/opt/netscape/plugins</filename> and your personal
  28 plugins in <filename
  29 class="directory">$<envar>HOME</envar>/.netscape/plugins</filename>.
  30 However, &konqueror; will not automatically use the installed plugins:
  31 it first has to scan a list of folders.  You can initiate the scan
  32 by clicking <guibutton>Scan for new plugins</guibutton>.  Alternatively,
  33 you can enable <guilabel>Scan for new plugins at &kde; startup</guilabel>
  34 so &konqueror; will scan the appropriate folders every time &kde;
  35 starts up, to see whether new plugins have been installed.</para>
  36
  37 <note><para>Enabling <guilabel>Scan for new plugins at &kde;
  38 startup</guilabel> can considerably slow down the startup procedure,
  39 and is known to give difficulty on certain installations.  Turn this
  40 option off if you experience problems.</para></note>
  41
  42 <para>To find plugins, &konqueror; will look in the folders
  43 specified in the <guilabel>Scan Folders</guilabel> frame.  When you
  44 use this control module for the first time, this list will already be
  45 filled with reasonable paths that should work on most operating systems.
  46 If you need to provide a new path, click the <guibutton>New</guibutton>
  47 button; then you can either enter the new path in the text edit box to
  48 the left, or choose a folder using the file dialog by clicking the
  49 <guibutton>New...</guibutton> button.  As scanning the folders can take
  50 a little time, you might want to remove folders from the list where
  51 you know that no plugins are installed: do this by selecting a folder
  52 and clicking <guibutton>Remove</guibutton>.  Using the
  53 <guibutton>Up</guibutton> and <guibutton>Down</guibutton> buttons you
  54 can change the order in which folders will be scanned by moving the
  55 selected folder up or down.</para>
  56
  57 <para>As usual, click <guibutton>Apply</guibutton> to save your changes
  58 permanently.</para>
  59
  60 </sect3>
  61
  62 <sect3 id="nsplugins-plugins">
  63 <title>Plugins</title>
  64
  65 <para>In this tab, you can see a list of the &Netscape; plugins found by
  66 &konqueror;, displayed as a tree.  Double click on a plugin to fold it
  67 out and you'll see that the different mime types this plugin can handle
  68 will be displayed as branches.  Fold out a mime type to see its
  69 info.</para>
  70
  71 <para>This tab is mostly for informational purposes.  The only
  72 configurable option is <guilabel>Use artsdsp to pipe plugin sound
  73 through aRts</guilabel>, which is enabled by default. Disable this if
  74 you wish plugins to use their own method for sounds, and you have
  75 configured &arts; in such a way that third-party applications can do
  76 so (for example, by having it exit when idle, or by having it use a
  77 custom sound device on modern soundcards which allow this.)</para>
  78
  79 </sect3>
  80
  81 <sect3 id="nsplugins-author">
  82 <title>Section Author</title>
  83
  84 <para>This section written by: Jost Schenck
  85 <email>jost@schenck.de</email></para>
  86
  87 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
  88
  89 </sect3>
  90
  91 </sect2>