[prev in list] [next in list] [prev in thread] [next in thread]
List: kde-commits
Subject: =?utf-8?q?=5Bkde-baseapps=5D_/=3A_merge_konq-plugins_into_konque?=
From: Burkhard_Lück <lueck () hube-lueck ! de>
Date: 2011-05-22 19:28:59
Message-ID: 20110522192859.8A5EBA60A4 () git ! kde ! org
[Download RAW message or body]
Git commit 7014040a954e2d8cd08c1b2be195ad20fb299ab8 by Burkhard Lück.
Committed on 22/05/2011 at 21:19.
Pushed by lueck into branch 'master'.
merge konq-plugins into konqueror's documentation
adapt help path for fsview
@David: dirfilter does no show up in Tools menu in file manager mode, even if \
enabled. Locally broken here? CCMAIL:faure@kde.org
M +0 -1 doc/CMakeLists.txt
D +0 -12 doc/konq-plugins/CMakeLists.txt
D +0 -7 doc/konq-plugins/babel/CMakeLists.txt
D +0 -95 doc/konq-plugins/babel/index.docbook
D +0 -7 doc/konq-plugins/dirfilter/CMakeLists.txt
D +0 -61 doc/konq-plugins/dirfilter/index.docbook
D +0 -2 doc/konq-plugins/domtreeviewer/CMakeLists.txt
D +0 -62 doc/konq-plugins/domtreeviewer/index.docbook
D +0 -7 doc/konq-plugins/fsview/CMakeLists.txt
D +0 -182 doc/konq-plugins/fsview/index.docbook
D +0 -7 doc/konq-plugins/imgallery/CMakeLists.txt
D +- -- doc/konq-plugins/imgallery/folders.png
D +0 -207 doc/konq-plugins/imgallery/index.docbook
D +- -- doc/konq-plugins/imgallery/look.png
D +- -- doc/konq-plugins/imgallery/thumbnails.png
D +0 -153 doc/konq-plugins/index.docbook
D +0 -7 doc/konq-plugins/khtmlsettings/CMakeLists.txt
D +0 -114 doc/konq-plugins/khtmlsettings/index.docbook
D +0 -7 doc/konq-plugins/uachanger/CMakeLists.txt
D +0 -102 doc/konq-plugins/uachanger/index.docbook
D +0 -7 doc/konq-plugins/validators/CMakeLists.txt
D +0 -87 doc/konq-plugins/validators/index.docbook
D +0 -2 doc/konq-plugins/webarchiver/CMakeLists.txt
D +0 -62 doc/konq-plugins/webarchiver/index.docbook
M +1 -1 doc/konqueror/browser.docbook
A +- -- doc/konqueror/folders.png [License: Trivial file]
M +3 -0 doc/konqueror/index.docbook
A +- -- doc/konqueror/look.png [License: Trivial file]
M +329 -33 doc/konqueror/plugins.docbook
A +- -- doc/konqueror/thumbnails.png [License: Trivial file]
A +164 -0 doc/konqueror/view-extensions.docbook [License: UNKNOWN] *
M +1 -1 konq-plugins/fsview/fsview_part.cpp
The files marked with a * at the end have a non valid license. Please read: \
http://techbase.kde.org/Policies/Licensing_Policy and use the headers which are \
listed at that page.
http://commits.kde.org/kde-baseapps/7014040a954e2d8cd08c1b2be195ad20fb299ab8
diff --git a/doc/CMakeLists.txt b/doc/CMakeLists.txt
index 5ee8aed..b3340c3 100644
--- a/doc/CMakeLists.txt
+++ b/doc/CMakeLists.txt
@@ -1,5 +1,4 @@
add_subdirectory(dolphin)
add_subdirectory(kfind)
add_subdirectory(konqueror)
-add_subdirectory(konq-plugins)
add_subdirectory(kdepasswd)
diff --git a/doc/konq-plugins/CMakeLists.txt b/doc/konq-plugins/CMakeLists.txt
deleted file mode 100644
index dc89fe1..0000000
--- a/doc/konq-plugins/CMakeLists.txt
+++ /dev/null
@@ -1,12 +0,0 @@
-add_subdirectory(babel)
-add_subdirectory(dirfilter)
-add_subdirectory(domtreeviewer)
-add_subdirectory(fsview)
-add_subdirectory(imgallery)
-add_subdirectory(khtmlsettings)
-add_subdirectory(uachanger)
-add_subdirectory(validators)
-add_subdirectory(webarchiver)
-########### install files ###############
-
-kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR \
konq-plugins)
diff --git a/doc/konq-plugins/babel/CMakeLists.txt \
b/doc/konq-plugins/babel/CMakeLists.txt deleted file mode 100644
index c36fd43..0000000
--- a/doc/konq-plugins/babel/CMakeLists.txt
+++ /dev/null
@@ -1,7 +0,0 @@
-########### install files ###############
-
-#
-
-#
-#
-kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR \
konq-plugins/babel)
diff --git a/doc/konq-plugins/babel/index.docbook \
b/doc/konq-plugins/babel/index.docbook deleted file mode 100644
index fdc5728..0000000
--- a/doc/konq-plugins/babel/index.docbook
+++ /dev/null
@@ -1,95 +0,0 @@
-<?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 % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-
-<sect1 id="babel">
-<sect1info>
-
-<authorgroup>
-<author>
-<firstname>Lauri</firstname>
-<surname>Watts</surname>
-<affiliation><address>&Lauri.Watts.mail;</address></affiliation>
-</author>
-
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2006-02-26</date>
-<releaseinfo>3.5.1</releaseinfo> <!-- Used KDE version -->
-
-<abstract>
-<para>The Babel &konqueror; plugin gives you quick access to the
-Babelfish translation service.</para>
-</abstract>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>kdeaddons</keyword>
-<keyword>konqueror</keyword>
-<keyword>plugins</keyword>
-<keyword>babelfish</keyword>
-<keyword>translate</keyword>
-</keywordset>
-</sect1info>
-
-<title>The Babel &konqueror; plugin</title>
-
-<sect2>
-<title>Using the Babelfish plugin</title>
-
-<para>Babelfish is a machine translation service provided by <ulink
-url="http://babel.altavista.com/">AltaVista</ulink>.</para>
-
-<para>The plugin allows you to automatically translate web pages
-between several languages.</para>
-
-<para>The Babelfish plugin can be accessed in the &konqueror; menubar
-under <menuchoice><guimenu>Tools</guimenu>
-<guimenuitem>Translate Web Page</guimenuitem></menuchoice>.
-Select from the list that drops down the language to translate from
-and the language to translate to.</para>
-
-<para>If you have a portion of the text on the page selected, that
-will be translated instead of the entire &URL;.</para>
-
-<para>Not all languages are available from the Babelfish service.</para>
-
-<important>
-<para>Machine translation is not a perfect science! Babelfish will at
-best give you a rough translation, and at worst will give you a very
-funny read. Don't base important decisions on things you have read
-from a Babelfish translated page, without confirming that the
-translation is indeed accurate.</para>
-</important>
-
-<note>
-<para>You may only translate web pages that are accessible on the
-world wide web. To translate any other text, you should go directly
-to the Babelfish site itself, where you are able to paste in text for
-translation.</para>
-</note>
-
-</sect2>
-
-<sect2>
-<title>Credits</title>
-
-<para>The Babelfish plugin is copyright (C)
-2001 &Kurt.Granroth;
-
-&Kurt.Granroth.mail;</para>
-
-<para>Documentation Copyright 2002 &Lauri.Watts;
-&Lauri.Watts.mail;</para>
-
-<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
-
-</sect2>
-</sect1>
-</article>
diff --git a/doc/konq-plugins/dirfilter/CMakeLists.txt \
b/doc/konq-plugins/dirfilter/CMakeLists.txt deleted file mode 100644
index b56bbfe..0000000
--- a/doc/konq-plugins/dirfilter/CMakeLists.txt
+++ /dev/null
@@ -1,7 +0,0 @@
-########### install files ###############
-
-#
-
-#
-#
-kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR \
konq-plugins/dirfilter)
diff --git a/doc/konq-plugins/dirfilter/index.docbook \
b/doc/konq-plugins/dirfilter/index.docbook deleted file mode 100644
index 11e4b89..0000000
--- a/doc/konq-plugins/dirfilter/index.docbook
+++ /dev/null
@@ -1,61 +0,0 @@
-<?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 % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-
-<sect1 id="dirfilter">
-<sect1info>
-
-<authorgroup>
-<author>
-<firstname>Gardner</firstname>
-<surname>Bell</surname>
-<affiliation><address><email>gbell72@rogers.com</email></address></affiliation>
-</author>
-
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2004-09-15</date>
-<releaseinfo>3.10.00</releaseinfo>
-
-<abstract>
-<para>The directory view filter allows you to choose which items are displayed in a \
directory.</para>
-</abstract>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>kdeaddons</keyword>
-<keyword>konqueror</keyword>
-<keyword>plugins</keyword>
-<keyword>dirfilter</keyword>
-</keywordset>
-
-</sect1info>
-
-<title>The View Filter</title>
-
-<sect2>
-<title>Using the View Filter</title>
-
-<para>The View Filter plugin (also known as <quote>dirfilter</quote>)
-can be accessed in the &konqueror; menubar under
-<menuchoice><guimenu>Tools</guimenu><guimenuitem>View
-Filter</guimenuitem></menuchoice>. This plugin allows you to filter
-&konqueror;'s current working directory in a variety of ways.</para>
-
-</sect2>
-
-<sect2>
-<title>Credits</title>
-
-<para>The dirfilter plugin is copyright ©
-2000-2002 Dawit Alemayehu <email>adawit@kde.org</email>.</para>
-</sect2>
-
-</sect1>
-</article>
diff --git a/doc/konq-plugins/domtreeviewer/CMakeLists.txt \
b/doc/konq-plugins/domtreeviewer/CMakeLists.txt deleted file mode 100644
index 0f5a7b4..0000000
--- a/doc/konq-plugins/domtreeviewer/CMakeLists.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-########### install files ###############
-kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR \
konq-plugins/domtreeviewer)
diff --git a/doc/konq-plugins/domtreeviewer/index.docbook \
b/doc/konq-plugins/domtreeviewer/index.docbook deleted file mode 100644
index 17421b3..0000000
--- a/doc/konq-plugins/domtreeviewer/index.docbook
+++ /dev/null
@@ -1,62 +0,0 @@
-<?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 % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-
-<sect1 id="domtreeviewer">
-<sect1info>
-
-<authorgroup>
-<author>
-<firstname>Gardner</firstname>
-<surname>Bell</surname>
-<affiliation><address><email>gbell72@rogers.com</email></address></affiliation>
-</author>
-
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2006-02-26</date>
-<releaseinfo>3.5.1</releaseinfo>
-
-<abstract>
-<para>The <acronym>DOM</acronym> Tree Viewer allows a developer to view the styles, \
attributes and elements of a web document.</para>
-</abstract>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>kdeaddons</keyword>
-<keyword>konqueror</keyword>
-<keyword>plugins</keyword>
-<keyword>DOMTreeViewer</keyword>
-</keywordset>
-
-</sect1info>
-
-<title>The <acronym>DOM</acronym> Tree Viewer</title>
-
-<sect2>
-<title>Using the <acronym>DOM</acronym> Tree Viewer</title>
-
-<para>To begin using The <acronym>DOM</acronym> Tree Viewer in &konqueror;, select \
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Show DOM \
Tree</guimenuitem></menuchoice>. This will open a new window which displays the \
<acronym>DOM</acronym> of the current web page you are viewing. By default the \
display starts at the root node of the document, example: \
<quote>documentElement</quote>, all other nodes that you will see are children or \
descendants of the root node.</para>
-
-<para>If you wish to manipulate the <acronym>DOM</acronym> tree in any way you will \
have to use an external script to do so.</para>
-
-</sect2>
-
-<sect2>
-<title>Credits</title>
-
-<para>The domtreeviewer plugin is Copyright ©
-2001 The Kafka Team/Andreas Schlapbach
-
-<email>kde-kafka@master.kde.org</email>
-<email>schlpbch@unibe.ch</email></para>
-</sect2>
-
-</sect1>
-</article>
diff --git a/doc/konq-plugins/fsview/CMakeLists.txt \
b/doc/konq-plugins/fsview/CMakeLists.txt deleted file mode 100644
index 5806c42..0000000
--- a/doc/konq-plugins/fsview/CMakeLists.txt
+++ /dev/null
@@ -1,7 +0,0 @@
-########### install files ###############
-
-#
-
-#
-#
-kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR \
konq-plugins/fsview)
diff --git a/doc/konq-plugins/fsview/index.docbook \
b/doc/konq-plugins/fsview/index.docbook deleted file mode 100644
index 99754fa..0000000
--- a/doc/konq-plugins/fsview/index.docbook
+++ /dev/null
@@ -1,182 +0,0 @@
-<?xml version="1.0" ?>
-<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
-"dtd/kdex.dtd" [
-<!ENTITY fsview "<application>FSView</application>">
-<!ENTITY % addindex "IGNORE">
-<!ENTITY % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-
-<sect1 id="fsview">
-<sect1info>
-
-<authorgroup>
-<author>
-<personname><firstname>Josef</firstname>
-<surname>Weidendorfer</surname></personname>
-<address><email>Josef.Weidendorfer@gmx.de</email></address>
-</author>
-
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2006-02-24</date>
-<releaseinfo>3.5.1</releaseinfo>
-
-<abstract>
-<para>The &fsview; Plugin for &konqueror; is another view mode for
-objects of mimetype <literal>inode/directory</literal> for local
-files. It can be viewed as an alternative to the various iconviews and
-listviews for browsing the content of your local file system.</para>
-</abstract>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>kdeaddons</keyword>
-<keyword>konqueror</keyword>
-<keyword>plugins</keyword>
-<keyword></keyword>
-</keywordset>
-
-</sect1info>
-
-<title>&fsview; - the File System View</title>
-
-<sect2>
-<title>Introduction</title>
-
-<para>The &fsview; Plugin for &konqueror; is another view mode for
-objects of mimetype <literal>inode/directory</literal> for local
-files. It can be viewed as an alternative to the various iconviews and
-listviews for browsing the content of your local file system.</para>
-
-<para>The unique property of &fsview; is its ability to show whole
-nested folder hierarchies using a so-called tree map for graphical
-visualization. Tree maps allow for displaying metrics of objects in
-nested structures: each object is represented by a rectangle whose
-area is proportional to its metric. The sum of the children's metrics must be
-equal to or smaller than the parent object's metric.</para>
-
-<para>For &fsview;, sizes of files and folders are chosen as
-metric, where the size of a folder is defined to be the sum of the
-sizes of its subitems. This way, big files even deep down in the
-folder hierarchy can be spotted easily be looking for large
-rectangles. So &fsview; can be looked at as a graphical and interactive
-version of the &UNIX; <command>du</command> command.</para>
-
-<para>The integration of &fsview; as part of Konqueror allows it to
-use the standard features like context file menus, and mime type
-sensitive actions. But it was chosen not to implement automatical
-update of file system changes by watching: if you delete a file shown
-in &fsview; outside of &konqueror;, you have to update manually by
-⪚ pressing <keycap>F5</keycap>. The reason for this decision is
-the potentially huge amount of files which would have to be watched
-for changes, and thus, could put an unreasonable pressure on system
-resources for a small feature.</para>
-
-</sect2>
-
-<sect2>
-<title>Visualization Features</title>
-
-<para>This section explains the graphical visualization of &fsview;
-in detail.</para>
-
-<sect3>
-<title>Item Drawing Options</title>
-
-<para>In &fsview;, an item of the tree map visualization is a rectangle
-representing a file or folder of your file system. For easier navigation,
-rectangles have a meaningful coloring and labeling options.</para>
-
-<para>The color of a rectangle, switchable via menu item
-<menuchoice><guimenu>View</guimenu><guisubmenu>Color
-Mode</guisubmenu></menuchoice> can be either
-<guimenuitem>Depth</guimenuitem> for easy detection of the nesting, or
-a color mapping of different file attributes like name, owner, group,
-or mime type.</para>
-
-<para>A rectangle can be labeled with the various attributes
-of the corresponding file or folder. For an attribute, you can
-choose, whether it should be shown at all, only if space is available,
-or if space should be taken from children (thus introducing
-errors to pure tree map drawing constrains). Additionally, you can choose
-the relative location of the label in the rectangle.</para>
-
-</sect3>
-
-<sect3>
-<title>TreeMap Drawing Algorithms</title>
-
-<para>For drawing algorithms in tree maps, the rule that the area
-is proportional to the metric of an item should hold true.
-With the tree map in &fsview;, this goal isn't always met: we draw borders
-to show the nesting of items, and this border takes space for a item
-which is possible lost for the areas of child items. Note that
-less space is lost for the border if the rectangle is quadratic.</para>
-
-<para>Similar, it is good for a better overview to let all rectangles
-at least have its name as label, taking space, too. It is an option to
-always force space for labels, or only to draw labels when empty space
-is available. In the latter case, the tool tips appearing when the
-mouse is kept over an item for some time, can help a lot. They show
-information for the item the mouse is currently over, together with
-its parent relations up to the root item of the tree map.</para>
-
-<para>How the space of an item is split into subareas for children is
-left to the implementation. It is always better to try to split areas
-in such a way that rectangles are as quadratic as possible, both for
-labeling and less space lost by borders. The best methods in this
-regard are <guilabel>Rows</guilabel>, <guilabel>Columns</guilabel>, or
-<guilabel>Recursive Bisection</guilabel>.</para>
-
-<para>You can choose the minimal area of items to be drawn via the
-menu item <menuchoice><guimenu>View</guimenu><guimenuitem>Stop at
-Area</guimenuitem></menuchoice>. Instead, a hash pattern will be drawn
-over the parents area to signal that this space is in fact occupied by
-a child.</para>
-
-</sect3>
-
-</sect2>
-
-<sect2>
-<title>User Interface</title>
-
-<para>&fsview; supports multiple selection of items, similar to the
-iconview and listview. This allows for actions to be done
-simultaneously to a set of files. A simple mouse click always selects
-a single item below the mouse pointer. Use a mouse click in
-combination with pressing the &Shift; key for range selection or the
-&Ctrl; Key for selection toggle. Note that by selecting an item, subitems can no
-longer be selected. Selecting an item will also clear the selection of all its
-parent items before.</para>
-
-<para>There is keyboard navigation available in tree maps: use
-<keycap>Left Arrow</keycap> and <keycap>Right Arrow</keycap> keys to
-move the current item between siblings, and the <keycap>Up
-Arrow</keycap> and <keycap>Down Arrow</keycap> keys to go up and down
-the nesting hierarchy. <keycap>Space</keycap> selects the item, in
-conjunction with &Shift; does range selection, and with the &Ctrl; key
-hold down simultaneously, toggles selection of the current item. Press
-<keycap>Return</keycap> to run the open action onto the current item.</para>
-
-</sect2>
-
-<sect2>
-<title>Credits and License</title>
-
-<para>Originally, &fsview; was meant as a small test application and
-usage tutorial for the TreeMap widget developed within
-<application>KCachegrind</application>.</para>
-
-<para>Copyright by Josef Weidendorfer, licensed using GPL V2.</para>
-
-&underGPL;
-&underFDL;
-
-</sect2>
-
-</sect1>
-</article>
diff --git a/doc/konq-plugins/imgallery/CMakeLists.txt \
b/doc/konq-plugins/imgallery/CMakeLists.txt deleted file mode 100644
index 89eddac..0000000
--- a/doc/konq-plugins/imgallery/CMakeLists.txt
+++ /dev/null
@@ -1,7 +0,0 @@
-########### install files ###############
-
-#
-
-#
-#
-kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR \
konq-plugins/imgallery)
diff --git a/doc/konq-plugins/imgallery/folders.png \
b/doc/konq-plugins/imgallery/folders.png deleted file mode 100644
index a8a1f6e..0000000
Binary files a/doc/konq-plugins/imgallery/folders.png and /dev/null differ
diff --git a/doc/konq-plugins/imgallery/index.docbook \
b/doc/konq-plugins/imgallery/index.docbook deleted file mode 100644
index 517bb99..0000000
--- a/doc/konq-plugins/imgallery/index.docbook
+++ /dev/null
@@ -1,207 +0,0 @@
-<?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 % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-
-<sect1 id="kimgalleryplugin">
-<sect1info>
-
-<authorgroup>
-<author>
-<firstname>Mike</firstname>
-<surname>Diehl</surname>
-<affiliation><address><email>madpenguin8@yahoo.com</email></address></affiliation>
-</author>
-
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2006-02-24</date>
-<releaseinfo>3.00.00</releaseinfo>
-
-<abstract>
-<para>The Image Gallery &konqueror; plugin creates image gallery html pages from a \
selected directory.</para>
-</abstract>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>kdeaddons</keyword>
-<keyword>konqueror</keyword>
-<keyword>plugins</keyword>
-</keywordset>
-
-</sect1info>
-
-<title>The Image Gallery Plugin</title>
-
-<sect2>
-<title>Using the Image Gallery Plugin</title>
-
-<para>The Image Gallery plugin can be accessed in the &konqueror; menubar under \
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Create Image \
Gallery</guimenuitem></menuchoice>, or with \
<keycombo>&Ctrl;<keycap>I</keycap></keycombo>.</para>
-
-<para>When you start the Image Gallery plugin a dialog opens allowing you to adjust \
the way the gallery is created.</para>
-</sect2>
-</sect1>
-
-<sect1 id="page_look_dialog">
-<title>Page Look</title>
-
-<screenshot>
-<screeninfo>Look Dialog Screenshot</screeninfo>
-<mediaobject>
-<imageobject>
-<imagedata fileref="look.png" format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>Screenshot</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
-
-<para>The Look dialog is for adjusting the appearance of the gallery page.</para>
-
-<variablelist>
-
-<varlistentry>
-<term><guimenuitem>Page title</guimenuitem></term>
-<listitem><para>The Page title option has a text input box for changing the title of \
the image gallery page.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Images per row</guimenuitem></term>
-<listitem><para>The Images per row option has a slider and a spin box for adjusting \
the number of thumbnails that are in a single row in the \
gallery.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Show image file name</guimenuitem></term>
-<listitem><para>The Show image file name check box allows you to turn on or off the \
use of the filenames below the gallery thumbnails.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Show image file size</guimenuitem></term>
-<listitem><para>The Show image filesize check box allows you to turn on or off the \
use of the filesizes below the gallery thumbnails.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Show image dimensions</guimenuitem></term>
-<listitem><para>The Show image dimensions check box allows you to turn on or off the \
use of the image dimensions in pixels below the gallery \
thumbnails.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Font name</guimenuitem></term>
-<listitem><para>The Font name combo box provides you with a choice of which font to \
use in creating the gallery.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Font size</guimenuitem></term>
-<listitem><para>The Font size spin box is for changing the size of the font you \
selected.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Foreground color</guimenuitem></term>
-<listitem><para>The Foreground color option has a selector for choosing the \
foreground color of the gallery, this includes the text \
areas.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Background color</guimenuitem></term>
-<listitem><para>The Background color option has a selector for choosing the \
background color of the gallery.</para></listitem>
-</varlistentry>
-
-</variablelist>
-</sect1>
-
-<sect1 id="folders_dialog">
-<title>Folders</title>
-
-<screenshot>
-<screeninfo>Folders Dialog Screenshot</screeninfo>
-<mediaobject>
-<imageobject>
-<imagedata fileref="folders.png" format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>Screenshot</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
-
-
-<para>The Folders dialog is used for choosing where to save the gallery. This dialog \
is also used to configure what folders are used.</para>
-
-<variablelist>
-
-<varlistentry>
-<term><guimenuitem>Save to HTML file</guimenuitem></term>
-<listitem><para>The Save to file selector decides where you want to save you image \
gallery html page.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Recurse subfolders</guimenuitem></term>
-<listitem><para>The Recurse subfolders check box enables recursing of \
subdirectories. If the check box is enabled, a slider and spin box are enabled to \
select the recursion depth.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Copy original files</guimenuitem></term>
-<listitem><para>The Copy original files check box creates an image folder storing \
copies of the original images used in the gallery.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Use comment file</guimenuitem></term>
-<listitem><para>The use comment file check box enables a file selector to choose a \
comments file to use with your gallery.</para></listitem>
-</varlistentry>
-
-</variablelist>
-</sect1>
-
-<sect1 id="thumbnails_dialog">
-<title>Thumbnails</title>
-
-<screenshot>
-<screeninfo>Thumbnails Dialog Screenshot</screeninfo>
-<mediaobject>
-<imageobject>
-<imagedata fileref="thumbnails.png" format="PNG"/>
-</imageobject>
-<textobject>
-<phrase>Screenshot</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
-
-<para>The thumbnails dialog is used for adjusting the properties of the thumbnails \
in the gallery.</para>
-
-<variablelist>
-
-<varlistentry>
-<term><guimenuitem>Image format for the thumbnails</guimenuitem></term>
-<listitem><para>The image format combo box allows you to choose what format is used \
for the thumbnail images.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Thumbnail size</guimenuitem></term>
-<listitem><para>The thumbnail size option provides a slider and spin box for \
adjusting the size of the thumbnails used in the \
gallery.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Set different color depth</guimenuitem></term>
-<listitem><para>The set different color depth check box enables a combo box for \
selecting a different color depth for the thumbnails if you wish to use a color depth \
other than the depth used in the original image.</para></listitem>
-</varlistentry>
-
-</variablelist>
-
-<sect2>
-<title>Credits</title>
-
-<para> Copyright © 2001,2003 Lukas Tinkl <email>lukas@kde.org</email></para>
-<para> Andreas Schlapbach <email>schlpbch@iam.unibe.ch</email></para>
-
-<para>Documentation Copyright 2004 Mike Diehl \
<email>madpenguin8@yahoo.com</email></para>
-</sect2>
-
-</sect1>
-
-</article>
diff --git a/doc/konq-plugins/imgallery/look.png \
b/doc/konq-plugins/imgallery/look.png deleted file mode 100644
index a342fab..0000000
Binary files a/doc/konq-plugins/imgallery/look.png and /dev/null differ
diff --git a/doc/konq-plugins/imgallery/thumbnails.png \
b/doc/konq-plugins/imgallery/thumbnails.png deleted file mode 100644
index d2ab1ad..0000000
Binary files a/doc/konq-plugins/imgallery/thumbnails.png and /dev/null differ
diff --git a/doc/konq-plugins/index.docbook b/doc/konq-plugins/index.docbook
deleted file mode 100644
index 26bbcf3..0000000
--- a/doc/konq-plugins/index.docbook
+++ /dev/null
@@ -1,153 +0,0 @@
-<?xml version="1.0" ?>
-<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
-"dtd/kdex.dtd" [
- <!ENTITY kappname "&konqueror; Plugins">
- <!ENTITY package "kdeaddons">
- <!ENTITY % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<book lang="&language;">
-<bookinfo>
-<title>The &konqueror; Plugins Handbook</title>
-
-<authorgroup>
-<author>
-<firstname>Lauri</firstname>
-<surname>Watts</surname>
-<affiliation><address>&Lauri.Watts.mail;</address></affiliation>
-</author>
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-
-<date>2006-05-20</date>
-<releaseinfo>3.5.2</releaseinfo> <!-- Used KDE version here -->
-
-<copyright>
-<year>2002</year>
-<holder>&Lauri.Watts;</holder>
-</copyright>
-
-<legalnotice>&FDLNotice;</legalnotice>
-
-<abstract>
-<para>
-This is the handbook for the additional plugins for &konqueror; the
-&kde; file manager and web browser.
-</para>
-</abstract>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>kdeaddons</keyword>
-<keyword>Konqueror</keyword>
-<keyword>Plugins</keyword>
-</keywordset>
-
-</bookinfo>
-
-<chapter id="introduction">
-<title>Introduction</title>
-
-<para>
-The &package; package contains several plugins for &konqueror;.
-Despite their small size, they provide additional functions and ease
-the use of some of the functions &konqueror; already contains, by
-making them more accessible.
-</para>
-
-<para>
-More information on the use of &konqueror; and its built in
-functionality, can be found in the &konqueror; handbook.
-</para>
-
-<para>
-To load these plugins from within &konqueror;, select
-<menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure \
Extensions...</guimenuitem></menuchoice>
-to open a dialog with all installed plugins and select the ones you need.
-</para>
-
-<para>
-This is a list of the <emphasis>standard</emphasis> configuration
-modules provided by the <application role="package">&kde; addons</application>
-package. Please note that there may be many more modules on your system if you
-have installed additional software.
-</para>
-
-<itemizedlist>
-<listitem>
-<para><ulink url="help:/konq-plugins/babel/index.html">Babelfish</ulink></para>
-</listitem>
-<listitem>
-<para><ulink url="help:/konq-plugins/domtreeviewer/index.html">The \
<acronym>DOM</acronym> tree
-viewer</ulink></para>
-</listitem>
-<listitem>
-<para><ulink url="help:/konq-plugins/imgallery/index.html">The &konqueror; image
-gallery</ulink></para>
-</listitem>
-<!--
-<listitem>
-<para><ulink url="help:/konq-plugins/mediaplayer/index.html">The Embedded Media
-Player</ulink></para>
-</listitem>
--->
-<listitem>
-<para><ulink url="help:/konq-plugins/validators/index.html">The
-Validators</ulink></para>
-</listitem>
-<listitem>
-<para><ulink url="help:/konq-plugins/dirfilter/index.html">The Folder
-Filter</ulink></para>
-</listitem>
-<listitem>
-<para><ulink url="help:/konq-plugins/khtmlsettings/index.html">KHTMLSettings</ulink></para>
-</listitem>
-<listitem>
-<para><ulink url="help:/konq-plugins/uachanger/index.html">The User Agent \
Changer</ulink></para>
-</listitem>
-<listitem>
-<para><ulink url="help:/konq-plugins/webarchiver/index.html">The Web
-Archiver</ulink></para>
-</listitem>
-<listitem>
-<para><ulink url="help:/konq-plugins/fsview/index.html">FSView - the File
-System View</ulink></para>
-</listitem>
-</itemizedlist>
-
-</chapter>
-
-<chapter id="credits">
-<title>Credits and License</title>
-
-<para>
-Copyrights for each plugin are listed in the applicable chapter.
-</para>
-
-<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
-&underFDL;
-&underGPL;
-
-</chapter>
-
-<appendix id="installation">
-<title>Installation</title>
-
-&install.intro.documentation;
-
-<para>You should install the kdebase package which contains
-&konqueror; before attempting to compile this package.</para>
-
-&install.compile.documentation;
-
-</appendix>
-
-
-</book>
-
-<!--
-Local Variables:
-mode: sgml
-End:
--->
diff --git a/doc/konq-plugins/khtmlsettings/CMakeLists.txt \
b/doc/konq-plugins/khtmlsettings/CMakeLists.txt deleted file mode 100644
index 60c2176..0000000
--- a/doc/konq-plugins/khtmlsettings/CMakeLists.txt
+++ /dev/null
@@ -1,7 +0,0 @@
-########### install files ###############
-
-#
-
-#
-#
-kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR \
konq-plugins/khtmlsettings)
diff --git a/doc/konq-plugins/khtmlsettings/index.docbook \
b/doc/konq-plugins/khtmlsettings/index.docbook deleted file mode 100644
index f86999d..0000000
--- a/doc/konq-plugins/khtmlsettings/index.docbook
+++ /dev/null
@@ -1,114 +0,0 @@
-<?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 % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-
-<sect1 id="khtmlsettings">
-<sect1info>
-
-<authorgroup>
-<author>
-<firstname>Mike</firstname>
-<surname>Diehl</surname>
-<affiliation><address><email>madpenguin8@yahoo.com</email></address></affiliation>
-</author>
-
-<author>
-<firstname>Lauri</firstname>
-<surname>Watts</surname>
-<affiliation><address>&Lauri.Watts.mail;</address></affiliation>
-</author>
-
-
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2006-01-10</date>
-<releaseinfo>3.5.1</releaseinfo>
-
-<abstract>
-<para>The &HTML; Settings plugin provides an easy way to access the common &HTML; \
settings for &konqueror;.</para>
-</abstract>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>kdeaddons</keyword>
-<keyword>konqueror</keyword>
-<keyword>plugins</keyword>
-</keywordset>
-
-</sect1info>
-
-<title>KHTMLSettings</title>
-
-<sect2>
-<title>Using KHTMLSettings</title>
-
-<para>The &HTML; settings plugin can be accessed in the &konqueror; menubar under \
<menuchoice><guimenu>Tools</guimenu><guimenuitem>HTML \
Settings</guimenuitem></menuchoice>. Below is a list of the settings and a short \
description of each one.</para>
-
-<variablelist>
-<varlistentry>
-<term><guimenuitem>JavaScript</guimenuitem></term>
-<listitem><para>Allows you to turn the use of JavaScript in &konqueror; on or \
off.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Java</guimenuitem></term>
-<listitem><para>Allows you to turn the use of &Java; in &konqueror; on or \
off.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Cookies</guimenuitem></term>
-<listitem><para>Allows you to turn the use of Cookies in &konqueror; on or \
off.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Plugins</guimenuitem></term>
-<listitem><para>Allows you to turn the use of the &konqueror; plugins you have \
installed on or off.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Autoload Images</guimenuitem></term>
-<listitem><para>Allows you to turn on or off the loading of images in web \
pages.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Enable Proxy</guimenuitem></term>
-<listitem><para>Allows you to enable or disable the use of a proxy in the \
&konqueror; browser.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Enable Cache</guimenuitem></term>
-<listitem><para>Allows you to enable or disable the use of cache in the &konqueror; \
browser.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Cache Policy</guimenuitem></term>
-<listitem>
-<para>The Cache Policy submenu provides you with a way to configure the how
-&konqueror; uses cache. The possible uses include:</para>
-<itemizedlist>
-<listitem><para>Keep Cache in Sync</para></listitem>
-<listitem><para>Use Cache if Possible</para></listitem>
-<listitem><para>Offline Browsing Mode</para></listitem>
-</itemizedlist>
-</listitem>
-</varlistentry>
-</variablelist>
-
-</sect2>
-
-<sect2>
-<title>Credits</title>
-
-<para> Copyright © 2001 &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail;</para>
-
-<para>Documentation Copyright 2004 Mike Diehl \
<email>madpenguin8@yahoo.com</email></para>
-</sect2>
-
-</sect1>
-</article>
diff --git a/doc/konq-plugins/uachanger/CMakeLists.txt \
b/doc/konq-plugins/uachanger/CMakeLists.txt deleted file mode 100644
index 50a6a40..0000000
--- a/doc/konq-plugins/uachanger/CMakeLists.txt
+++ /dev/null
@@ -1,7 +0,0 @@
-########### install files ###############
-
-#
-
-#
-#
-kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR \
konq-plugins/uachanger)
diff --git a/doc/konq-plugins/uachanger/index.docbook \
b/doc/konq-plugins/uachanger/index.docbook deleted file mode 100644
index a40b392..0000000
--- a/doc/konq-plugins/uachanger/index.docbook
+++ /dev/null
@@ -1,102 +0,0 @@
-<?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 % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-
-<sect1 id="uachanger">
-<sect1info>
-
-<authorgroup>
-<author>
-<firstname>Gardner</firstname>
-<surname>Bell</surname>
-<affiliation><address><email>gbell72@rogers.com</email></address></affiliation>
-</author>
-
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2004-07-13</date>
-<releaseinfo>3.10.00</releaseinfo>
-
-<abstract>
-<para>The uachanger adds a menu to &konqueror; that allows you to
-change the Browser and Operating System identification on a
-domain-by-domain basis. This is useful when browsing websites that
-limit access to those using a particular web browser.</para>
-</abstract>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>kdeaddons</keyword>
-<keyword>konqueror</keyword>
-<keyword>plugins</keyword>
-<keyword>uachanger</keyword>
-</keywordset>
-
-</sect1info>
-
-<title>The User Agent Changer</title>
-
-<sect2>
-<title>Using the User Agent Changer</title>
-
-<para>The &konqueror; uachanger plugin can be accessed in the menubar under \
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Change Browser \
Identification</guimenuitem></menuchoice></para>
-<!-- ************************************ -->
-<!-- We probably need an entity for Mozilla, and I should check about -->
-<!-- trademark stuff for the MS browsers (Phil)-->
-<!-- ************************************ -->
-<variablelist>
-<varlistentry>
-<term><guimenuitem>Default Identification</guimenuitem></term>
-<listitem><para>The default User Agent header for &konqueror; is \
Mozilla/5.0(compatible;Konqueror/3.2)(KHTML, like Gecko). If you come across a site \
that refuses this browser access, change your User Agent to one of the options \
below.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Internet Explorer</guimenuitem></term>
-<listitem><para>Allows you to change your User Agent header to MSIE for sites that \
refuse <application>Mozilla</application>-based browsers entry. You will most likely \
need to use one of the MSIE User Agents if you wish to use &konqueror; to access \
Hotmail.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Mozilla</guimenuitem></term>
-<listitem><para>Allows you to change the User Agent header in &konqueror; to appear \
as <application>Mozilla</application> version 1.2.1 through \
1.6</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Netscape Navigator</guimenuitem></term>
-<listitem><para>Pages that don't comply with W3C recommendations, or were written \
using proprietary &HTML; elements and attributes will render correctly if you choose \
to send the User Agent of these old browsers.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Other</guimenuitem></term>
-<listitem><para>This section contains miscellaneous browsers that you can use to \
change your User Agent.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Apply To Entire Site</guimenuitem></term>
-<listitem><para>This option allows you to specify that the defined User Agent \
applies across every page on the site you are \
visiting.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Configure</guimenuitem></term>
-<listitem><para>Selecting <guimenuitem>Configure</guimenuitem> allows you to fine \
tune the amount of information you wish to reveal about the browser and operating \
system being used.</para></listitem>
-</varlistentry>
-</variablelist>
-
-</sect2>
-
-<sect2>
-<title>Credits</title>
-
-<para>The User Agent Changer plugin is Copyright ©
-2001 Dawit Alemayehu.
-
-<email>adawit@kde.org</email></para>
-</sect2>
-
-</sect1>
-</article>
diff --git a/doc/konq-plugins/validators/CMakeLists.txt \
b/doc/konq-plugins/validators/CMakeLists.txt deleted file mode 100644
index e9788fc..0000000
--- a/doc/konq-plugins/validators/CMakeLists.txt
+++ /dev/null
@@ -1,7 +0,0 @@
-########### install files ###############
-
-#
-
-#
-#
-kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR \
konq-plugins/validators)
diff --git a/doc/konq-plugins/validators/index.docbook \
b/doc/konq-plugins/validators/index.docbook deleted file mode 100644
index 47b08bf..0000000
--- a/doc/konq-plugins/validators/index.docbook
+++ /dev/null
@@ -1,87 +0,0 @@
-<?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 % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-
-<sect1 id="validators">
-<sect1info>
-
-<authorgroup>
-<author>
-<firstname>Gardner</firstname>
-<surname>Bell</surname>
-<affiliation><address><email>gbell72@rogers.com</email></address></affiliation>
-</author>
-
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2006-01-10</date>
-<releaseinfo>3.5.1</releaseinfo>
-
-<abstract>
-<para>The &konqueror; validator plugin checks your &CSS; and &HTML; documents
-for conformance to W3C recommendations and other standards.</para>
-</abstract>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>kdeaddons</keyword>
-<keyword>konqueror</keyword>
-<keyword>plugins</keyword>
-<keyword>validators</keyword>
-</keywordset>
-
-</sect1info>
-
-<title>The Validators Plugin</title>
-
-<sect2>
-<title>Using the Validators Plugin</title>
-
-<para>The validator plugin can be accessed in the &konqueror; menubar under
-<menuchoice><guimenu>Tools</guimenu><guimenuitem>Validate Web \
Page</guimenuitem></menuchoice>.
-A description of each subitem can be found below.</para>
-
-<variablelist>
-<varlistentry>
-<term><guimenuitem>Validate &HTML;</guimenuitem></term>
-<listitem><para>The validate &HTML; option allows you to compare your &HTML; \
document to the defined syntax of &HTML; and reports any errors found. Validating \
your &HTML; will ensure that your pages display properly on all \
browsers.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Validate CSS</guimenuitem></term>
-<listitem><para>Allows you to validate your &CSS; style sheet that is embedded in an \
&HTML; or &XHTML;
-document. Having valid &CSS; is critical to ensuring that your web site maintains a \
consistent look regardless of the browser that is being \
used.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Validate Links</guimenuitem></term>
-<listitem><para>Allows you to confirm that the links on your site contain no \
redirects or broken links. This tool recursively checks all links on a \
site.</para></listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guimenuitem>Configure Validator</guimenuitem></term>
-<listitem><para>The configure validator item allows you to view the preset \
validators you can use
-to validate your &HTML; and &CSS;.</para></listitem>
-</varlistentry>
-</variablelist>
-
-</sect2>
-
-<sect2>
-<title>Credits</title>
-
-<para>The validators plugin is Copyright ©
-2001 Richard Moore and Andreas Schlapbach
-
-&Richard.J.Moore.mail;
-<email>schlpbch@iam.unibe.ch</email></para>
-</sect2>
-
-</sect1>
-</article>
diff --git a/doc/konq-plugins/webarchiver/CMakeLists.txt \
b/doc/konq-plugins/webarchiver/CMakeLists.txt deleted file mode 100644
index 61ba80e..0000000
--- a/doc/konq-plugins/webarchiver/CMakeLists.txt
+++ /dev/null
@@ -1,2 +0,0 @@
-########### install files ###############
-kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR \
konq-plugins/webarchiver)
diff --git a/doc/konq-plugins/webarchiver/index.docbook \
b/doc/konq-plugins/webarchiver/index.docbook deleted file mode 100644
index 12e561f..0000000
--- a/doc/konq-plugins/webarchiver/index.docbook
+++ /dev/null
@@ -1,62 +0,0 @@
-<?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 % English "INCLUDE" > <!-- change language only here -->
-]>
-
-<article lang="&language;">
-
-<sect1 id="webarchiver">
-<sect1info>
-
-<authorgroup>
-<author>
-<firstname>Gardner</firstname>
-<surname>Bell</surname>
-<affiliation><address><email>gbell72@rogers.com</email></address></affiliation>
-</author>
-
-<!-- TRANS:ROLES_OF_TRANSLATORS -->
-</authorgroup>
-
-<date>2004-07-14</date>
-<releaseinfo>3.10.00</releaseinfo>
-
-<abstract>
-<para>The webarchiver plugin for &konqueror; allows for archiving of
-web pages, documents and images in <literal role="extension">.war</literal> \
format.</para>
-</abstract>
-
-<keywordset>
-<keyword>KDE</keyword>
-<keyword>kdeaddons</keyword>
-<keyword>konqueror</keyword>
-<keyword>plugins</keyword>
-<keyword>webarchiver</keyword>
-</keywordset>
-
-</sect1info>
-
-<title>Web Archiver</title>
-
-<sect2>
-<title>Using the Web Archiver</title>
-
-<para>To access the webarchiver point your mouse to \
<menuchoice><guimenu>Tools</guimenu><guimenuitem>Archive Web \
Page...</guimenuitem></menuchoice>. A dialog will appear allowing you to save the \
current website being viewed.</para>
-
-</sect2>
-
-<sect2>
-<title>Credits</title>
-
-<para>The webarchiver plugin is Copyright ©
-2001-2003 Andreas Schlapbach, Antonio Larossa and Malte Starostik
-
-<email>schlpbch@iam.unibe.ch</email>
-<email>larossa@kde.org</email>
-<email>malte@kde.org</email></para>
-</sect2>
-
-</sect1>
-</article>
diff --git a/doc/konqueror/browser.docbook b/doc/konqueror/browser.docbook
index a90aa3e..37ca660 100644
--- a/doc/konqueror/browser.docbook
+++ b/doc/konqueror/browser.docbook
@@ -326,7 +326,7 @@ to its use of &Java; or JavaScript. If you suspect that this may \
be the case check that they have been enabled in the <guilabel>Java & JavaScript
</guilabel> section of the settings dialog.</para></note>
<note><para>Install the <guilabel>UserAgent Changer</guilabel> extension from the
-extragear base module and enable it in \
<menuchoice><guimenu>Settings</guimenu><guimenuitem> +&konqueror; Plugins and enable \
it in <menuchoice><guimenu>Settings</guimenu><guimenuitem> Configure \
Extensions</guimenuitem></menuchoice>. This extension adds a <guimenuitem>Change \
Browser Identification</guimenuitem> item to the <guimenu>Tools</guimenu> menu. \
Using this item lets you quickly switch between different <quote>User \
Agent</quote>
diff --git a/doc/konqueror/folders.png b/doc/konqueror/folders.png
new file mode 100644
index 0000000..56cb59c
Binary files /dev/null and b/doc/konqueror/folders.png differ
diff --git a/doc/konqueror/index.docbook b/doc/konqueror/index.docbook
index 12c8f80..7fa6a87 100644
--- a/doc/konqueror/index.docbook
+++ b/doc/konqueror/index.docbook
@@ -3,6 +3,7 @@
"dtd/kdex.dtd" [
<!ENTITY kappname "&konqueror;">
<!ENTITY package "kdebase">
+ <!ENTITY fsview "<application>FSView</application>">
<!ENTITY konqueror-introduction SYSTEM "introduction.docbook">
<!ENTITY konqueror-basics SYSTEM "basics.docbook">
<!ENTITY konqueror-filemanager SYSTEM "filemanager.docbook">
@@ -12,6 +13,7 @@
<!ENTITY konqueror-sidebar SYSTEM "sidebar.docbook">
<!ENTITY konqueror-save-settings SYSTEM "save-settings.docbook">
<!ENTITY konqueror-plugins SYSTEM "plugins.docbook">
+ <!ENTITY konqueror-view-extensions SYSTEM "view-extensions.docbook">
<!ENTITY konqueror-config SYSTEM "config.docbook">
<!ENTITY konqueror-commands SYSTEM "commands.docbook">
<!ENTITY konqueror-faq SYSTEM "faq.docbook">
@@ -72,6 +74,7 @@
&konqueror-sidebar; <!-- 4.4-->
&konqueror-save-settings; <!-- 4.4-->
&konqueror-plugins; <!-- 4.5-->
+&konqueror-view-extensions;
&konqueror-config; <!-- 4.4-->
&konqueror-commands; <!-- 4.5-->
&konqueror-faq; <!-- 4.5-->
diff --git a/doc/konqueror/look.png b/doc/konqueror/look.png
new file mode 100644
index 0000000..f02c5af
Binary files /dev/null and b/doc/konqueror/look.png differ
diff --git a/doc/konqueror/plugins.docbook b/doc/konqueror/plugins.docbook
index 665754c..f71fc89 100644
--- a/doc/konqueror/plugins.docbook
+++ b/doc/konqueror/plugins.docbook
@@ -6,8 +6,8 @@
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
-<date>2010-05-16</date>
-<releaseinfo>&kde; 4.5</releaseinfo>
+<date>2011-05-16</date>
+<releaseinfo>&kde; 4.7</releaseinfo>
</chapterinfo>
@@ -35,51 +35,97 @@ Browser Plugins</ulink> help page.</para>
<sect1 id="konq-plugin">
<title>&konqueror; Plugins</title>
-<para>The &kde; module extragear contains several useful plugins that interact with
+<para>&kde; releases several useful plugins that interact with
&konqueror; in various ways. These are explained briefly below.</para>
-<!--NO ENTRY KONQ PLUGINS IN HELPCENTER NAVIGATION TREE IN KDE4
-, more detailed information may be obtained by looking through the \
<guimenuitem>Konqueror
-Plugins</guimenuitem> section in the &kde; Help Center
-How to access the doc in extragear/base/doc/konq-plugins???
--->
-<para>Use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure \
Extensions...
-</guimenuitem></menuchoice> to open a dialog with all installed plugins and select
+
+<para>Use <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure Extensions
+...</guimenuitem></menuchoice> to open a dialog with all installed plugins and \
select the ones you need. All plugins are accessible in the <guimenu>Tools</guimenu> \
menu.</para>
+<para>Only plugins appropriate for the current mode (file manager or browser)
+are listed in the dialog.</para>
+
<variablelist>
<title>Browser Mode</title>
<varlistentry>
<term>Web Page Translation</term>
-<listitem><para>This uses AltaVista's BabelFish site to translate the current
+<listitem><para>This uses the machine translation service provided by <ulink
+url="http://babelfish.yahoo.com/">Yahoo's BabelFish site</ulink> to translate the \
current <acronym>HTML</acronym> page to whatever language you want (within reason). \
It can be launched with <menuchoice><guimenu>Tools</guimenu><guisubmenu>Translate
-Web Page</guisubmenu></menuchoice>.</para></listitem>
+Web Page</guisubmenu></menuchoice>.</para>
+<para>If you have a portion of the text on the page selected, that
+will be translated instead of the entire &URL;.</para>
+
+<para>Not all languages are available from the Babelfish service.</para>
+
+<important>
+<para>Machine translation is not a perfect science! Babelfish will at
+best give you a rough translation, and at worst will give you a very
+funny read. Don't base important decisions on things you have read
+from a Babelfish translated page, without confirming that the
+translation is indeed accurate.</para>
+</important>
+
+<note>
+<para>You may only translate web pages that are accessible on the
+world wide web. To translate any other text, you should go directly
+to the Babelfish site itself, where you are able to paste in text for
+translation.</para>
+</note>
+</listitem>
</varlistentry>
<varlistentry>
<term>DOM Tree Viewer</term>
-<listitem><para>Selecting <menuchoice><guimenu>Tools</guimenu><guisubmenu>Show
+<listitem>
+<para>The <acronym>DOM</acronym> Tree Viewer allows a developer to view
+the styles, attributes and elements of a web document.</para>
+<para>Selecting <menuchoice><guimenu>Tools</guimenu><guisubmenu>Show
DOM Tree</guisubmenu></menuchoice> opens a new window which displays the
document object model (DOM) of the current <acronym>HTML</acronym>
-page.</para></listitem>
+page.</para>
+<para>By default the display starts at the root node of the document, example: \
<quote>documentElement</quote>, all other nodes that you will see are children or \
descendants of the root node.</para> +<para>If you wish to manipulate the \
<acronym>DOM</acronym> tree in any way you will have to use an external script to do \
so.</para> +</listitem>
+</varlistentry>
+
+<varlistentry>
+<term>Web Page Validator</term>
+<listitem>
+<para>This plugin uses the W3C HTML validator to validate the current page, very \
useful when +creating web pages.</para>
+
+<variablelist>
+<varlistentry>
+<term><guimenuitem>Validate &HTML; (by URI)</guimenuitem> / <guimenuitem>Validate \
&HTML; (by Upload)</guimenuitem></term> +<listitem><para>The validate &HTML; option \
allows you to compare your &HTML; document to the defined syntax of &HTML; and \
reports any errors found. Validating your &HTML; will ensure that your pages display \
properly on all browsers.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Validate CSS (by URI)</guimenuitem></term>
+<listitem><para>Allows you to validate your &CSS; style sheet that is embedded in an \
&HTML; or &XHTML; +document. Having valid &CSS; is critical to ensuring that your \
web site maintains a consistent look regardless of the browser that is being \
used.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Validate Links</guimenuitem></term>
+<listitem><para>Allows you to confirm that the links on your site contain no \
redirects or broken links. This tool recursively checks all links on a \
site.</para></listitem> </varlistentry>
<varlistentry>
-<term>HTML Validator</term>
-<listitem><para>This is started with
-<menuchoice><guimenu>Tools</guimenu><guisubmenu>Validate Web
-Page</guisubmenu><guimenuitem>Validate HTML</guimenuitem></menuchoice>. It
-uses the W3C HTML validator to validate the current page, very useful when
-creating web pages.</para></listitem>
+<term><guimenuitem>Validate Page</guimenuitem></term>
+<listitem><para>Validates the current page but does not show the result in another \
window or tab as the previous actions. +Using this item enables the action \
<guimenuitem>View Validator Report</guimenuitem> to display a summary of the \
validation.</para></listitem> </varlistentry>
<varlistentry>
-<term>CSS Validator</term>
-<listitem><para>Started with
-<menuchoice><guimenu>Tools</guimenu><guisubmenu>Validate Web
-Page</guisubmenu><guimenuitem>Validate CSS</guimenuitem></menuchoice>, it uses
-the W3C CSS validator to validate the current page's Cascading Style
-Sheets.</para></listitem>
+<term><guimenuitem>Configure Validator</guimenuitem></term>
+<listitem><para>The configure validator item allows you to view the preset \
validators you can use +to validate your &HTML; and &CSS;.</para></listitem>
+</varlistentry>
+</variablelist>
+</listitem>
</varlistentry>
<varlistentry>
@@ -87,7 +133,58 @@ Sheets.</para></listitem>
<listitem><para>Select <menuchoice><guimenu>Tools</guimenu><guisubmenu>HTML
Settings</guisubmenu></menuchoice> to enable or disable a number of HTML
settings without going through the <guimenu>Settings</guimenu> dialog.
-</para></listitem>
+</para>
+<variablelist>
+<varlistentry>
+<term><guimenuitem>JavaScript</guimenuitem></term>
+<listitem><para>Allows you to turn the use of JavaScript in &konqueror; on or \
off.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Java</guimenuitem></term>
+<listitem><para>Allows you to turn the use of &Java; in &konqueror; on or \
off.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Cookies</guimenuitem></term>
+<listitem><para>Allows you to turn the use of Cookies in &konqueror; on or \
off.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Plugins</guimenuitem></term>
+<listitem><para>Allows you to turn the use of the &konqueror; plugins you have \
installed on or off.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Autoload Images</guimenuitem></term>
+<listitem><para>Allows you to turn on or off the loading of images in web \
pages.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Enable Proxy</guimenuitem></term>
+<listitem><para>Allows you to enable or disable the use of a proxy in the \
&konqueror; browser.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Enable Cache</guimenuitem></term>
+<listitem><para>Allows you to enable or disable the use of cache in the &konqueror; \
browser.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Cache Policy</guimenuitem></term>
+<listitem>
+<para>The Cache Policy submenu provides you with a way to configure the how
+&konqueror; uses cache. The possible uses include:</para>
+<itemizedlist>
+<listitem><para>Keep Cache in Sync</para></listitem>
+<listitem><para>Use Cache if Possible</para></listitem>
+<listitem><para>Offline Browsing Mode</para></listitem>
+</itemizedlist>
+</listitem>
+</varlistentry>
+</variablelist>
+
+</listitem>
</varlistentry>
<varlistentry>
@@ -96,10 +193,41 @@ settings without going through the <guimenu>Settings</guimenu> \
dialog. Browser Identification</guisubmenu></menuchoice> to get a menu that allows
you to change the User Agent string without going through the <guimenu>Settings
</guimenu> dialog procedure.
+</para>
+<para>The plugin allows you to
+change the Browser and Operating System identification on a
+domain-by-domain basis. This is useful when browsing websites that
+limit access to those using a particular web browser.</para>
+<variablelist>
+<varlistentry>
+<term><guimenuitem>Default Identification</guimenuitem></term>
+<listitem><para>The default User Agent header for &konqueror; is \
Mozilla/5.0(compatible;Konqueror/4.7)(KHTML/4.7, like Gecko). If you come across a \
site that refuses this browser access, change your User Agent to one of the options \
below.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term>Browser submenu</term>
+<listitem><para>
+The following menu items show a lot of popular browsers like \
<guimenuitem>Firefox</guimenuitem>, +<guimenuitem>Internet Explorer</guimenuitem>, \
<guimenuitem>Netscape Navigator</guimenuitem>, +<guimenuitem>Opera</guimenuitem>, \
<guimenuitem>Other</guimenuitem>, and <guimenuitem>Safari</guimenuitem>. \
</para></listitem> </varlistentry>
<varlistentry>
+<term><guimenuitem>Apply To Entire Site</guimenuitem></term>
+<listitem><para>This option allows you to specify that the defined User Agent \
applies across every page on the site you are visiting.</para></listitem> \
+</varlistentry> +
+<varlistentry>
+<term><guimenuitem>Configure</guimenuitem></term>
+<listitem><para>Selecting <guimenuitem>Configure</guimenuitem> opens the settings \
dialog and allows you to fine tune the amount of information you wish to reveal about \
the browser and operating system being used.</para></listitem> +</varlistentry>
+</variablelist>
+
+</listitem>
+</varlistentry>
+
+<varlistentry>
<term>Archive Web Page</term>
<listitem><para>Invoked with <menuchoice><guimenu>Tools</guimenu><guisubmenu>
Archive Web Page</guisubmenu></menuchoice>, this tool creates an archive
@@ -112,7 +240,9 @@ archive file name to view the saved page.
</variablelist>
<variablelist>
-<title>Filemanager Mode</title>
+<title>File Manager Mode</title>
+
+<!--in 4.6 but not in master ???-->
<varlistentry>
<term>Folder View Filter</term>
<listitem><para>This is controlled by
@@ -125,13 +255,179 @@ are displayed in a folder.</para></listitem>
<term>Image Gallery</term>
<listitem><para>In File Manager mode, you can select
<menuchoice><guimenu>Tools</guimenu><guisubmenu>Create Image
-Gallery</guisubmenu></menuchoice> to create an HTML page with
-thumbnails of all the images in the current folder. By default the HTML page
-is called <filename>images.html</filename> and the thumbnails are put into a
-new <filename>thumbs</filename> folder.
-</para></listitem>
+Gallery</guisubmenu></menuchoice> or use \
<keycombo>&Ctrl;<keycap>I</keycap></keycombo> +to create an HTML page with \
thumbnails of all the images in the current folder. +By default the HTML page is \
called <filename>images.html</filename> and the thumbnails +are put into a new \
<filename>images</filename> folder.</para> +<para>When you start the Image Gallery \
plugin a dialog opens allowing you to adjust the +way the gallery is created.</para>
+
+<variablelist id="page_look_dialog">
+<title>Page Look</title>
+<varlistentry>
+<term>The Look dialog is for adjusting the appearance of the gallery page.</term>
+<listitem>
+
+<screenshot>
+<screeninfo>Look Dialog Screenshot</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="look.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Screenshot</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+
+<variablelist>
+
+<varlistentry>
+<term><guimenuitem>Page title</guimenuitem></term>
+<listitem><para>The Page title option has a text input box for changing the title of \
the image gallery page.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Images per row</guimenuitem></term>
+<listitem><para>The Images per row option has a slider and a spin box for adjusting \
the number of thumbnails that are in a single row in the gallery.</para></listitem> \
+</varlistentry> +
+<varlistentry>
+<term><guimenuitem>Show image file name</guimenuitem></term>
+<listitem><para>The Show image file name check box allows you to turn on or off the \
use of the filenames below the gallery thumbnails.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Show image file size</guimenuitem></term>
+<listitem><para>The Show image filesize check box allows you to turn on or off the \
use of the filesizes below the gallery thumbnails.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Show image dimensions</guimenuitem></term>
+<listitem><para>The Show image dimensions check box allows you to turn on or off the \
use of the image dimensions in pixels below the gallery thumbnails.</para></listitem> \
+</varlistentry> +
+<varlistentry>
+<term><guimenuitem>Font name</guimenuitem></term>
+<listitem><para>The Font name combo box provides you with a choice of which font to \
use in creating the gallery.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Font size</guimenuitem></term>
+<listitem><para>The Font size spin box is for changing the size of the font you \
selected.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Foreground color</guimenuitem></term>
+<listitem><para>The Foreground color option has a selector for choosing the \
foreground color of the gallery, this includes the text areas.</para></listitem> \
+</varlistentry> +
+<varlistentry>
+<term><guimenuitem>Background color</guimenuitem></term>
+<listitem><para>The Background color option has a selector for choosing the \
background color of the gallery.</para></listitem> +</varlistentry>
+
+</variablelist>
+
+<variablelist id="folders_dialog">
+<title>Folders</title>
+<varlistentry>
+<term>The Folders dialog is used for choosing where to save the gallery.
+This dialog is also used to configure what folders are used.</term>
+<listitem>
+
+<screenshot>
+<screeninfo>Folders Dialog Screenshot</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="folders.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Screenshot</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+
+<variablelist>
+
+<varlistentry>
+<term><guimenuitem>Save to HTML file</guimenuitem></term>
+<listitem><para>The Save to file selector decides where you want to save you image \
gallery html page.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Recurse subfolders</guimenuitem></term>
+<listitem><para>The Recurse subfolders check box enables recursing of \
subdirectories. If the check box is enabled, a slider and spin box are enabled to \
select the recursion depth.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Copy original files</guimenuitem></term>
+<listitem><para>The Copy original files check box creates an image folder storing \
copies of the original images used in the gallery.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Use comment file</guimenuitem></term>
+<listitem><para>The use comment file check box enables a file selector to choose a \
comments file to use with your gallery.</para></listitem> +</varlistentry>
+
+</variablelist>
+
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+<variablelist id="thumbnails_dialog">
+<title>Thumbnails</title>
+<varlistentry>
+<term>The thumbnails dialog is used for adjusting the properties of the thumbnails \
in the gallery.</term> +<listitem>
+
+<screenshot>
+<screeninfo>Thumbnails Dialog Screenshot</screeninfo>
+<mediaobject>
+<imageobject>
+<imagedata fileref="thumbnails.png" format="PNG"/>
+</imageobject>
+<textobject>
+<phrase>Screenshot</phrase>
+</textobject>
+</mediaobject>
+</screenshot>
+
+<variablelist>
+
+<varlistentry>
+<term><guimenuitem>Image format for the thumbnails</guimenuitem></term>
+<listitem><para>The image format combo box allows you to choose what format is used \
for the thumbnail images.</para></listitem> +</varlistentry>
+
+<varlistentry>
+<term><guimenuitem>Thumbnail size</guimenuitem></term>
+<listitem><para>The thumbnail size option provides a slider and spin box for \
adjusting the size of the thumbnails used in the gallery.</para></listitem> \
+</varlistentry> +
+<varlistentry>
+<term><guimenuitem>Set different color depth</guimenuitem></term>
+<listitem><para>The set different color depth check box enables a combo box for \
selecting a different color depth for the thumbnails if you wish to use a color depth \
other than the depth used in the original image.</para></listitem> +</varlistentry>
+
+</variablelist>
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+
+</listitem>
+</varlistentry>
+
+</variablelist>
+
+</listitem>
</varlistentry>
+<!--How to enable ???-->
<varlistentry>
<term>Search Bar</term>
<listitem><para>Provides a text box for easy access to search engines like Google.
diff --git a/doc/konqueror/thumbnails.png b/doc/konqueror/thumbnails.png
new file mode 100644
index 0000000..8fd08b1
Binary files /dev/null and b/doc/konqueror/thumbnails.png differ
diff --git a/doc/konqueror/view-extensions.docbook \
b/doc/konqueror/view-extensions.docbook new file mode 100644
index 0000000..e27e583
--- /dev/null
+++ b/doc/konqueror/view-extensions.docbook
@@ -0,0 +1,164 @@
+<chapter id="view-extensions">
+
+<title>View Mode Extensions</title>
+
+<!--filemanager mode:
+default Icons/Details/Columns (Dolphin), File Size View (konq-plugins)
+additional Terminal Emulator (Konsole), File Replace View (kdewebdev), Cervisia \
(kdesdk), Radial Map (Filelight-kdeutils) and more +browser mode:
+default KHTML, WebKit, Embedded Advanced Text Editor
+additional KImageMapEditor+KLinkStatusPart (kdewebdev) and more
+ -->
+<para>&konqueror; provides additional views in <menuchoice><guimenu>View</guimenu>
+<guisubmenu>View Mode</guisubmenu></menuchoice> in file manager and browser mode, if \
+the corresponding applications and plugins are installed.</para>
+<para>The file manager mode has the additional views <guimenuitem>Radial \
Map</guimenuitem> +from the application <application>Filelight</application> and the \
&konqueror; plugin +<guimenuitem>File Size View</guimenuitem>.</para>
+
+<sect1 id="fsview">
+<sect1info>
+<authorgroup>
+<author>
+<personname><firstname>Josef</firstname>
+<surname>Weidendorfer</surname></personname>
+<address><email>Josef.Weidendorfer@gmx.de</email></address>
+</author>
+
+</authorgroup>
+<date>2011-05-16</date>
+<releaseinfo>&kde; 4.7</releaseinfo>
+</sect1info>
+
+<title>&fsview; - the File System View</title>
+<sect2>
+<title>Introduction</title>
+
+<para>The &fsview; Plugin for &konqueror; is another view mode for
+objects of mimetype <literal>inode/directory</literal> for local
+files. It can be viewed as an alternative to the various iconviews and
+listviews for browsing the content of your local file system.</para>
+
+<para>The unique property of &fsview; is its ability to show whole
+nested folder hierarchies using a so-called tree map for graphical
+visualization. Tree maps allow for displaying metrics of objects in
+nested structures: each object is represented by a rectangle whose
+area is proportional to its metric. The sum of the children's metrics must be
+equal to or smaller than the parent object's metric.</para>
+
+<para>For &fsview;, sizes of files and folders are chosen as
+metric, where the size of a folder is defined to be the sum of the
+sizes of its subitems. This way, big files even deep down in the
+folder hierarchy can be spotted easily be looking for large
+rectangles. So &fsview; can be looked at as a graphical and interactive
+version of the &UNIX; <command>du</command> command.</para>
+
+<para>The integration of &fsview; as part of Konqueror allows it to
+use the standard features like context file menus, and mime type
+sensitive actions. But it was chosen not to implement automatical
+update of file system changes by watching: if you delete a file shown
+in &fsview; outside of &konqueror;, you have to update manually by
+⪚ pressing <keycap>F5</keycap>. The reason for this decision is
+the potentially huge amount of files which would have to be watched
+for changes, and thus, could put an unreasonable pressure on system
+resources for a small feature.</para>
+
+</sect2>
+
+<sect2>
+<title>Visualization Features</title>
+
+<para>This section explains the graphical visualization of &fsview;
+in detail.</para>
+
+<sect3>
+<title>Item Drawing Options</title>
+
+<para>In &fsview;, an item of the tree map visualization is a rectangle
+representing a file or folder of your file system. For easier navigation,
+rectangles have a meaningful coloring and labeling options.</para>
+
+<para>The color of a rectangle, switchable via menu item
+<menuchoice><guimenu>View</guimenu><guisubmenu>Color
+Mode</guisubmenu></menuchoice> can be either
+<guimenuitem>Depth</guimenuitem> for easy detection of the nesting, or
+a color mapping of different file attributes like name, owner, group,
+or mime type.</para>
+
+<para>A rectangle can be labeled with the various attributes
+of the corresponding file or folder. For an attribute, you can
+choose, whether it should be shown at all, only if space is available,
+or if space should be taken from children (thus introducing
+errors to pure tree map drawing constrains). Additionally, you can choose
+the relative location of the label in the rectangle.</para>
+
+</sect3>
+
+<sect3>
+<title>TreeMap Drawing Algorithms</title>
+
+<para>For drawing algorithms in tree maps, the rule that the area
+is proportional to the metric of an item should hold true.
+With the tree map in &fsview;, this goal isn't always met: we draw borders
+to show the nesting of items, and this border takes space for a item
+which is possible lost for the areas of child items. Note that
+less space is lost for the border if the rectangle is quadratic.</para>
+
+<para>Similar, it is good for a better overview to let all rectangles
+at least have its name as label, taking space, too. It is an option to
+always force space for labels, or only to draw labels when empty space
+is available. In the latter case, the tool tips appearing when the
+mouse is kept over an item for some time, can help a lot. They show
+information for the item the mouse is currently over, together with
+its parent relations up to the root item of the tree map.</para>
+
+<para>How the space of an item is split into subareas for children is
+left to the implementation. It is always better to try to split areas
+in such a way that rectangles are as quadratic as possible, both for
+labeling and less space lost by borders. The best methods in this
+regard are <guilabel>Rows</guilabel>, <guilabel>Columns</guilabel>, or
+<guilabel>Recursive Bisection</guilabel>.</para>
+
+<para>You can choose the minimal area of items to be drawn via the
+menu item <menuchoice><guimenu>View</guimenu><guimenuitem>Stop at
+Area</guimenuitem></menuchoice>. Instead, a hash pattern will be drawn
+over the parents area to signal that this space is in fact occupied by
+a child.</para>
+
+</sect3>
+
+</sect2>
+
+<sect2>
+<title>User Interface</title>
+
+<para>&fsview; supports multiple selection of items, similar to the
+iconview and listview. This allows for actions to be done
+simultaneously to a set of files. A simple mouse click always selects
+a single item below the mouse pointer. Use a mouse click in
+combination with pressing the &Shift; key for range selection or the
+&Ctrl; key for selection toggle. Note that by selecting an item, subitems can no
+longer be selected. Selecting an item will also clear the selection of all its
+parent items before.</para>
+
+<para>There is keyboard navigation available in tree maps: use
+<keycap>Left Arrow</keycap> and <keycap>Right Arrow</keycap> keys to
+move the current item between siblings, and the <keycap>Up
+Arrow</keycap> and <keycap>Down Arrow</keycap> keys to go up and down
+the nesting hierarchy. <keycap>Space</keycap> selects the item, in
+conjunction with &Shift; does range selection, and with the &Ctrl; key
+hold down simultaneously, toggles selection of the current item. Press
+<keycap>Return</keycap> to run the open action onto the current item.</para>
+
+</sect2>
+
+<sect2>
+<title>Credits and License</title>
+<para>Originally, &fsview; was meant as a small test application and
+usage tutorial for the TreeMap widget developed within
+<application>KCachegrind</application>.</para>
+<para>Copyright by Josef Weidendorfer, licensed using GPL V2.</para>
+</sect2>
+
+</sect1>
+</chapter>
diff --git a/konq-plugins/fsview/fsview_part.cpp \
b/konq-plugins/fsview/fsview_part.cpp index 22739cc..d654177 100644
--- a/konq-plugins/fsview/fsview_part.cpp
+++ b/konq-plugins/fsview/fsview_part.cpp
@@ -249,7 +249,7 @@ void FSViewPart::showInfo()
void FSViewPart::showHelp()
{
KToolInvocation::startServiceByDesktopName("khelpcenter",
- QString("help:/konq-plugins/fsview/index.html"));
+ QString("help:/konqueror/index.html#fsview"));
}
void FSViewPart::startedSlot()
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic