From kde-commits Sun May 22 19:28:59 2011 From: =?utf-8?q?Burkhard_L=C3=BCck?= Date: Sun, 22 May 2011 19:28:59 +0000 To: kde-commits Subject: =?utf-8?q?=5Bkde-baseapps=5D_/=3A_merge_konq-plugins_into_konque?= Message-Id: <20110522192859.8A5EBA60A4 () git ! kde ! org> X-MARC-Message: https://marc.info/?l=kde-commits&m=130609258216355 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 @@ - - - -]> - -
- - - - - - -Lauri -Watts -
&Lauri.Watts.mail;
 - - - - - -2006-02-26 -3.5.1 - - -The Babel &konqueror; plugin gives you quick access to the -Babelfish translation service. - - - -KDE -kdeaddons -konqueror -plugins -babelfish -translate - - - -The Babel &konqueror; plugin - - -Using the Babelfish plugin - -Babelfish is a machine translation service provided by AltaVista. - -The plugin allows you to automatically translate web pages -between several languages. - -The Babelfish plugin can be accessed in the &konqueror; menubar -under Tools -Translate Web Page. -Select from the list that drops down the language to translate from -and the language to translate to. - -If you have a portion of the text on the page selected, that -will be translated instead of the entire &URL;. - -Not all languages are available from the Babelfish service. - - -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. - - - -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. - - - - - -Credits - -The Babelfish plugin is copyright (C) -2001 &Kurt.Granroth; - -&Kurt.Granroth.mail; - -Documentation Copyright 2002 &Lauri.Watts; -&Lauri.Watts.mail; - - - - - -
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 @@ - - - -]> - -
- - - - - - -Gardner -Bell -
gbell72@rogers.com
 - - - - - -2004-09-15 -3.10.00 - - -The directory view filter allows you to choose which items are displayed in a directory. - - - -KDE -kdeaddons -konqueror -plugins -dirfilter - - - - -The View Filter - - -Using the View Filter - -The View Filter plugin (also known as dirfilter) -can be accessed in the &konqueror; menubar under -ToolsView -Filter. This plugin allows you to filter -&konqueror;'s current working directory in a variety of ways. - - - - -Credits - -The dirfilter plugin is copyright © -2000-2002 Dawit Alemayehu adawit@kde.org. - - - -
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 @@ - - - -]> - -
- - - - - - -Gardner -Bell -
gbell72@rogers.com
 - - - - - -2006-02-26 -3.5.1 - - -The DOM Tree Viewer allows a developer to view the styles, attributes and elements of a web document. - - - -KDE -kdeaddons -konqueror -plugins -DOMTreeViewer - - - - -The <acronym>DOM</acronym> Tree Viewer - - -Using the <acronym>DOM</acronym> Tree Viewer - -To begin using The DOM Tree Viewer in &konqueror;, select ToolsShow DOM Tree. This will open a new window which displays the DOM of the current web page you are viewing. By default the display starts at the root node of the document, example: documentElement, all other nodes that you will see are children or descendants of the root node. - -If you wish to manipulate the DOM tree in any way you will have to use an external script to do so. - - - - -Credits - -The domtreeviewer plugin is Copyright © -2001 The Kafka Team/Andreas Schlapbach - -kde-kafka@master.kde.org -schlpbch@unibe.ch - - - -
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 @@ - -FSView"> - - -]> - -
- - - - - - -Josef -Weidendorfer -
Josef.Weidendorfer@gmx.de
- - - - - -2006-02-24 -3.5.1 - - -The &fsview; Plugin for &konqueror; is another view mode for -objects of mimetype inode/directory 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. - - - -KDE -kdeaddons -konqueror -plugins - - - - - -&fsview; - the File System View - - -Introduction - -The &fsview; Plugin for &konqueror; is another view mode for -objects of mimetype inode/directory 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. - -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. - -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; du command. - -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 F5. 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. - - - - -Visualization Features - -This section explains the graphical visualization of &fsview; -in detail. - - -Item Drawing Options - -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. - -The color of a rectangle, switchable via menu item -ViewColor -Mode can be either -Depth for easy detection of the nesting, or -a color mapping of different file attributes like name, owner, group, -or mime type. - -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. - - - - -TreeMap Drawing Algorithms - -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. - -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. - -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 Rows, Columns, or -Recursive Bisection. - -You can choose the minimal area of items to be drawn via the -menu item ViewStop at -Area. Instead, a hash pattern will be drawn -over the parents area to signal that this space is in fact occupied by -a child. - - - - - - -User Interface - -&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. - -There is keyboard navigation available in tree maps: use -Left Arrow and Right Arrow keys to -move the current item between siblings, and the Up -Arrow and Down Arrow keys to go up and down -the nesting hierarchy. Space 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 -Return to run the open action onto the current item. - - - - -Credits and License - -Originally, &fsview; was meant as a small test application and -usage tutorial for the TreeMap widget developed within -KCachegrind. - -Copyright by Josef Weidendorfer, licensed using GPL V2. - -&underGPL; -&underFDL; - - - - -
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 @@ - - - -]> - -
- - - - - - -Mike -Diehl -
madpenguin8@yahoo.com
 - - - - - -2006-02-24 -3.00.00 - - -The Image Gallery &konqueror; plugin creates image gallery html pages from a selected directory. - - - -KDE -kdeaddons -konqueror -plugins - - - - -The Image Gallery Plugin - - -Using the Image Gallery Plugin - -The Image Gallery plugin can be accessed in the &konqueror; menubar under ToolsCreate Image Gallery, or with &Ctrl;I. - -When you start the Image Gallery plugin a dialog opens allowing you to adjust the way the gallery is created. - - - - -Page Look - - -Look Dialog Screenshot - - - - - -Screenshot - - - - -The Look dialog is for adjusting the appearance of the gallery page. - - - - -Page title -The Page title option has a text input box for changing the title of the image gallery page. - - - -Images per row -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. - - - -Show image file name -The Show image file name check box allows you to turn on or off the use of the filenames below the gallery thumbnails. - - - -Show image file size -The Show image filesize check box allows you to turn on or off the use of the filesizes below the gallery thumbnails. - - - -Show image dimensions -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. - - - -Font name -The Font name combo box provides you with a choice of which font to use in creating the gallery. - - - -Font size -The Font size spin box is for changing the size of the font you selected. - - - -Foreground color -The Foreground color option has a selector for choosing the foreground color of the gallery, this includes the text areas. - - - -Background color -The Background color option has a selector for choosing the background color of the gallery. - - - - - - -Folders - - -Folders Dialog Screenshot - - - - - -Screenshot - - - - - -The Folders dialog is used for choosing where to save the gallery. This dialog is also used to configure what folders are used. - - - - -Save to HTML file -The Save to file selector decides where you want to save you image gallery html page. - - - -Recurse subfolders -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. - - - -Copy original files -The Copy original files check box creates an image folder storing copies of the original images used in the gallery. - - - -Use comment file -The use comment file check box enables a file selector to choose a comments file to use with your gallery. - - - - - - -Thumbnails - - -Thumbnails Dialog Screenshot - - - - - -Screenshot - - - - -The thumbnails dialog is used for adjusting the properties of the thumbnails in the gallery. - - - - -Image format for the thumbnails -The image format combo box allows you to choose what format is used for the thumbnail images. - - - -Thumbnail size -The thumbnail size option provides a slider and spin box for adjusting the size of the thumbnails used in the gallery. - - - -Set different color depth -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. - - - - - -Credits - - Copyright © 2001,2003 Lukas Tinkl lukas@kde.org - Andreas Schlapbach schlpbch@iam.unibe.ch - -Documentation Copyright 2004 Mike Diehl madpenguin8@yahoo.com - - - - -
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 @@ - - - - -]> - - - -The &konqueror; Plugins Handbook - - - -Lauri -Watts -
&Lauri.Watts.mail;
 - - - - - -2006-05-20 -3.5.2 - - -2002 -&Lauri.Watts; - - -&FDLNotice; - - - -This is the handbook for the additional plugins for &konqueror; the -&kde; file manager and web browser. - - - - -KDE -kdeaddons -Konqueror -Plugins - - - - - -Introduction - - -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. - - - -More information on the use of &konqueror; and its built in -functionality, can be found in the &konqueror; handbook. - - - -To load these plugins from within &konqueror;, select -SettingsConfigure Extensions... -to open a dialog with all installed plugins and select the ones you need. - - - -This is a list of the standard configuration -modules provided by the &kde; addons -package. Please note that there may be many more modules on your system if you -have installed additional software. - - - - -Babelfish - - -The DOM tree -viewer - - -The &konqueror; image -gallery - - - -The -Validators - - -The Folder -Filter - - -KHTMLSettings - - -The User Agent Changer - - -The Web -Archiver - - -FSView - the File -System View - - - - - - -Credits and License - - -Copyrights for each plugin are listed in the applicable chapter. - - - -&underFDL; -&underGPL; - - - - -Installation - -&install.intro.documentation; - -You should install the kdebase package which contains -&konqueror; before attempting to compile this package. - -&install.compile.documentation; - - - - - - - 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 @@ - - - -]> - -
- - - - - - -Mike -Diehl -
madpenguin8@yahoo.com
 - - - -Lauri -Watts -
&Lauri.Watts.mail;
 - - - - - - -2006-01-10 -3.5.1 - - -The &HTML; Settings plugin provides an easy way to access the common &HTML; settings for &konqueror;. - - - -KDE -kdeaddons -konqueror -plugins - - - - -KHTMLSettings - - -Using KHTMLSettings - -The &HTML; settings plugin can be accessed in the &konqueror; menubar under ToolsHTML Settings. Below is a list of the settings and a short description of each one. - - - -JavaScript -Allows you to turn the use of JavaScript in &konqueror; on or off. - - - -Java -Allows you to turn the use of &Java; in &konqueror; on or off. - - - -Cookies -Allows you to turn the use of Cookies in &konqueror; on or off. - - - -Plugins -Allows you to turn the use of the &konqueror; plugins you have installed on or off. - - - -Autoload Images -Allows you to turn on or off the loading of images in web pages. - - - -Enable Proxy -Allows you to enable or disable the use of a proxy in the &konqueror; browser. - - - -Enable Cache -Allows you to enable or disable the use of cache in the &konqueror; browser. - - - -Cache Policy - -The Cache Policy submenu provides you with a way to configure the how -&konqueror; uses cache. The possible uses include: - -Keep Cache in Sync -Use Cache if Possible -Offline Browsing Mode - - - - - - - - -Credits - - Copyright © 2001 &Carsten.Pfeiffer; &Carsten.Pfeiffer.mail; - -Documentation Copyright 2004 Mike Diehl madpenguin8@yahoo.com - - - -
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 @@ - - - -]> - -
- - - - - - -Gardner -Bell -
gbell72@rogers.com
 - - - - - -2004-07-13 -3.10.00 - - -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. - - - -KDE -kdeaddons -konqueror -plugins -uachanger - - - - -The User Agent Changer - - -Using the User Agent Changer - -The &konqueror; uachanger plugin can be accessed in the menubar under ToolsChange Browser Identification - - - - - - -Default Identification -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. - - - -Internet Explorer -Allows you to change your User Agent header to MSIE for sites that refuse Mozilla-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. - - - -Mozilla -Allows you to change the User Agent header in &konqueror; to appear as Mozilla version 1.2.1 through 1.6 - - - -Netscape Navigator -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. - - - -Other -This section contains miscellaneous browsers that you can use to change your User Agent. - - - -Apply To Entire Site -This option allows you to specify that the defined User Agent applies across every page on the site you are visiting. - - - -Configure -Selecting Configure allows you to fine tune the amount of information you wish to reveal about the browser and operating system being used. - - - - - - -Credits - -The User Agent Changer plugin is Copyright © -2001 Dawit Alemayehu. - -adawit@kde.org - - - -
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 @@ - - - -]> - -
- - - - - - -Gardner -Bell -
gbell72@rogers.com
 - - - - - -2006-01-10 -3.5.1 - - -The &konqueror; validator plugin checks your &CSS; and &HTML; documents -for conformance to W3C recommendations and other standards. - - - -KDE -kdeaddons -konqueror -plugins -validators - - - - -The Validators Plugin - - -Using the Validators Plugin - -The validator plugin can be accessed in the &konqueror; menubar under -ToolsValidate Web Page. -A description of each subitem can be found below. - - - -Validate &HTML; -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. - - - -Validate CSS -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. - - - -Validate Links -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. - - - -Configure Validator -The configure validator item allows you to view the preset validators you can use -to validate your &HTML; and &CSS;. - - - - - - -Credits - -The validators plugin is Copyright © -2001 Richard Moore and Andreas Schlapbach - -&Richard.J.Moore.mail; -schlpbch@iam.unibe.ch - - - -
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 @@ - - - -]> - -
- - - - - - -Gardner -Bell -
gbell72@rogers.com
 - - - - - -2004-07-14 -3.10.00 - - -The webarchiver plugin for &konqueror; allows for archiving of -web pages, documents and images in .war format. - - - -KDE -kdeaddons -konqueror -plugins -webarchiver - - - - -Web Archiver - - -Using the Web Archiver - -To access the webarchiver point your mouse to ToolsArchive Web Page.... A dialog will appear allowing you to save the current website being viewed. - - - - -Credits - -The webarchiver plugin is Copyright © -2001-2003 Andreas Schlapbach, Antonio Larossa and Malte Starostik - -schlpbch@iam.unibe.ch -larossa@kde.org -malte@kde.org - - - -
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 Java & JavaScript section of the settings dialog. Install the UserAgent Changer extension from the -extragear base module and enable it in Settings +&konqueror; Plugins and enable it in Settings Configure Extensions. This extension adds a Change Browser Identification item to the Tools menu. Using this item lets you quickly switch between different User Agent 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" [ + FSView"> @@ -12,6 +13,7 @@ + @@ -72,6 +74,7 @@ &konqueror-sidebar; &konqueror-save-settings; &konqueror-plugins; +&konqueror-view-extensions; &konqueror-config; &konqueror-commands; &konqueror-faq; 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 @@ -2010-05-16 -&kde; 4.5 +2011-05-16 +&kde; 4.7 @@ -35,51 +35,97 @@ Browser Plugins help page. &konqueror; Plugins -The &kde; module extragear contains several useful plugins that interact with +&kde; releases several useful plugins that interact with &konqueror; in various ways. These are explained briefly below. - -Use SettingsConfigure Extensions... - to open a dialog with all installed plugins and select + +Use SettingsConfigure Extensions +... to open a dialog with all installed plugins and select the ones you need. All plugins are accessible in the Tools menu. +Only plugins appropriate for the current mode (file manager or browser) +are listed in the dialog. + Browser Mode Web Page Translation -This uses AltaVista's BabelFish site to translate the current +This uses the machine translation service provided by Yahoo's BabelFish site to translate the current HTML page to whatever language you want (within reason). It can be launched with ToolsTranslate -Web Page. +Web Page. +If you have a portion of the text on the page selected, that +will be translated instead of the entire &URL;. + +Not all languages are available from the Babelfish service. + + +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. + + + +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. + + DOM Tree Viewer -Selecting ToolsShow + +The DOM Tree Viewer allows a developer to view +the styles, attributes and elements of a web document. +Selecting ToolsShow DOM Tree opens a new window which displays the document object model (DOM) of the current HTML -page. +page. +By default the display starts at the root node of the document, example: documentElement, all other nodes that you will see are children or descendants of the root node. +If you wish to manipulate the DOM tree in any way you will have to use an external script to do so. + + + + +Web Page Validator + +This plugin uses the W3C HTML validator to validate the current page, very useful when +creating web pages. + + + +Validate &HTML; (by URI) / Validate &HTML; (by Upload) +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. + + + +Validate CSS (by URI) +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. + + + +Validate Links +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. -HTML Validator -This is started with -ToolsValidate Web -PageValidate HTML. It -uses the W3C HTML validator to validate the current page, very useful when -creating web pages. +Validate Page +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 View Validator Report to display a summary of the validation. -CSS Validator -Started with -ToolsValidate Web -PageValidate CSS, it uses -the W3C CSS validator to validate the current page's Cascading Style -Sheets. +Configure Validator +The configure validator item allows you to view the preset validators you can use +to validate your &HTML; and &CSS;. + + + @@ -87,7 +133,58 @@ Sheets. Select ToolsHTML Settings to enable or disable a number of HTML settings without going through the Settings dialog. - + + + +JavaScript +Allows you to turn the use of JavaScript in &konqueror; on or off. + + + +Java +Allows you to turn the use of &Java; in &konqueror; on or off. + + + +Cookies +Allows you to turn the use of Cookies in &konqueror; on or off. + + + +Plugins +Allows you to turn the use of the &konqueror; plugins you have installed on or off. + + + +Autoload Images +Allows you to turn on or off the loading of images in web pages. + + + +Enable Proxy +Allows you to enable or disable the use of a proxy in the &konqueror; browser. + + + +Enable Cache +Allows you to enable or disable the use of cache in the &konqueror; browser. + + + +Cache Policy + +The Cache Policy submenu provides you with a way to configure the how +&konqueror; uses cache. The possible uses include: + +Keep Cache in Sync +Use Cache if Possible +Offline Browsing Mode + + + + + + @@ -96,10 +193,41 @@ settings without going through the Settings dialog. Browser Identification to get a menu that allows you to change the User Agent string without going through the Settings dialog procedure. + +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. + + +Default Identification +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. + + + +Browser submenu + +The following menu items show a lot of popular browsers like Firefox, +Internet Explorer, Netscape Navigator, +Opera, Other, and Safari. +Apply To Entire Site +This option allows you to specify that the defined User Agent applies across every page on the site you are visiting. + + + +Configure +Selecting Configure 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. + + + + + + + Archive Web Page Invoked with Tools Archive Web Page, this tool creates an archive @@ -112,7 +240,9 @@ archive file name to view the saved page. -Filemanager Mode +File Manager Mode + + Folder View Filter This is controlled by @@ -125,13 +255,179 @@ are displayed in a folder. Image Gallery In File Manager mode, you can select ToolsCreate Image -Gallery to create an HTML page with -thumbnails of all the images in the current folder. By default the HTML page -is called images.html and the thumbnails are put into a -new thumbs folder. - +Gallery or use &Ctrl;I +to create an HTML page with thumbnails of all the images in the current folder. +By default the HTML page is called images.html and the thumbnails +are put into a new images folder. +When you start the Image Gallery plugin a dialog opens allowing you to adjust the +way the gallery is created. + + +Page Look + +The Look dialog is for adjusting the appearance of the gallery page. + + + +Look Dialog Screenshot + + + + + +Screenshot + + + + + + + +Page title +The Page title option has a text input box for changing the title of the image gallery page. + + + +Images per row +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. + + + +Show image file name +The Show image file name check box allows you to turn on or off the use of the filenames below the gallery thumbnails. + + + +Show image file size +The Show image filesize check box allows you to turn on or off the use of the filesizes below the gallery thumbnails. + + + +Show image dimensions +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. + + + +Font name +The Font name combo box provides you with a choice of which font to use in creating the gallery. + + + +Font size +The Font size spin box is for changing the size of the font you selected. + + + +Foreground color +The Foreground color option has a selector for choosing the foreground color of the gallery, this includes the text areas. + + + +Background color +The Background color option has a selector for choosing the background color of the gallery. + + + + + +Folders + +The Folders dialog is used for choosing where to save the gallery. +This dialog is also used to configure what folders are used. + + + +Folders Dialog Screenshot + + + + + +Screenshot + + + + + + + +Save to HTML file +The Save to file selector decides where you want to save you image gallery html page. + + + +Recurse subfolders +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. + + + +Copy original files +The Copy original files check box creates an image folder storing copies of the original images used in the gallery. + + + +Use comment file +The use comment file check box enables a file selector to choose a comments file to use with your gallery. + + + + + + + + + + +Thumbnails + +The thumbnails dialog is used for adjusting the properties of the thumbnails in the gallery. + + + +Thumbnails Dialog Screenshot + + + + + +Screenshot + + + + + + + +Image format for the thumbnails +The image format combo box allows you to choose what format is used for the thumbnail images. + + + +Thumbnail size +The thumbnail size option provides a slider and spin box for adjusting the size of the thumbnails used in the gallery. + + + +Set different color depth +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. + + + + + + + + + + + + + + + + Search Bar 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 @@ + + +View Mode Extensions + + +&konqueror; provides additional views in View +View Mode in file manager and browser mode, if +the corresponding applications and plugins are installed. +The file manager mode has the additional views Radial Map +from the application Filelight and the &konqueror; plugin +File Size View. + + + + + +Josef +Weidendorfer +
Josef.Weidendorfer@gmx.de
+ + + +2011-05-16 +&kde; 4.7 + + +&fsview; - the File System View + +Introduction + +The &fsview; Plugin for &konqueror; is another view mode for +objects of mimetype inode/directory 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. + +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. + +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; du command. + +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 F5. 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. + + + + +Visualization Features + +This section explains the graphical visualization of &fsview; +in detail. + + +Item Drawing Options + +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. + +The color of a rectangle, switchable via menu item +ViewColor +Mode can be either +Depth for easy detection of the nesting, or +a color mapping of different file attributes like name, owner, group, +or mime type. + +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. + + + + +TreeMap Drawing Algorithms + +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. + +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. + +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 Rows, Columns, or +Recursive Bisection. + +You can choose the minimal area of items to be drawn via the +menu item ViewStop at +Area. Instead, a hash pattern will be drawn +over the parents area to signal that this space is in fact occupied by +a child. + + + + + + +User Interface + +&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. + +There is keyboard navigation available in tree maps: use +Left Arrow and Right Arrow keys to +move the current item between siblings, and the Up +Arrow and Down Arrow keys to go up and down +the nesting hierarchy. Space 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 +Return to run the open action onto the current item. + + + + +Credits and License +Originally, &fsview; was meant as a small test application and +usage tutorial for the TreeMap widget developed within +KCachegrind. +Copyright by Josef Weidendorfer, licensed using GPL V2. + + + + 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()