mirror of
https://invent.kde.org/system/dolphin
synced 2024-09-20 00:41:23 +00:00
165 lines
7 KiB
Plaintext
165 lines
7 KiB
Plaintext
<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 the
|
|
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 such as context file menus, and mime type
|
|
sensitive actions. But it was chosen not to implement automatic
|
|
update by watching file system changes: if you delete a file shown
|
|
in &fsview; outside of &konqueror;, you have to update manually by
|
|
⪚ pressing <keycap>F5</keycap> to see the change. The reason for this
|
|
decision is the potentially huge number 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 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 representative of
|
|
<guimenuitem>Depth</guimenuitem>, for easy detection of nesting, or
|
|
a color mapping of different file attributes such as name, owner, group,
|
|
or mime type.</para>
|
|
|
|
<para>A rectangle can be labeled with the various attributes
|
|
of the corresponding file or folder. For each 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 constraints). 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 an item
|
|
which is possibly lost for the areas of child items. Note that
|
|
less space is lost for the border if the rectangle is quadratic.</para>
|
|
|
|
<para>Similarly, it is better for a good overview to let each rectangle
|
|
at least have its name as a label. 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 held over an item can help a lot. They show
|
|
information for the item the mouse is currently over, together with
|
|
its parent folders 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 or children.</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>Keyboard navigation is 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
|
|
held down simultaneously, toggles selection of the current item. Press
|
|
<keycap>Return</keycap> to run the open action on 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>
|