Add specific css for print media(has to be improved).
[geeqie.git] / doc / main_window_folder_pane.html
1 <?xml version="1.0" encoding="iso-8859-1"?>
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4
5 <html xmlns="http://www.w3.org/1999/xhtml">
6 <head>
7   <meta http-equiv="CONTENT-TYPE" content="text/html; charset=iso-8859-1" />
8
9   <title>Folder Pane - Geeqie User Manual</title>
10   <link rel="stylesheet" type="text/css" href="style.css" media="all" />
11   <link rel="stylesheet" type="text/css" href="style_screen.css" media="screen" />
12   <link rel="stylesheet" type="text/css" href="style_print.css" media="print" />
13 </head>
14
15 <body lang="en-US" dir="ltr" xml:lang="en-US">
16   <div class="navtop">
17     <table width="100%" border="0" cellpadding="4" cellspacing="0">
18       <col id="navtop_col1" width="33%"></col>
19       <col id="navtop_col2" width="33%"></col>
20       <col id="navtop_col3" width="33%"></col>
21
22         <tr>
23           <th>
24             <p class="previous"><a href="main_window_file_pane.html">Previous</a>
25             </p>
26           </th>
27
28           <th>
29             <p class="navtop_title">Folder Pane &ndash; Main Window</p>
30           </th>
31
32           <th>
33             <p class="next"><a href="main_window_image_pane.html">Next</a>
34             </p>
35           </th>
36         </tr>
37     </table>
38   </div>
39
40   <hr />
41
42   <h1>Folder pane</h1>
43
44   <p>The folder pane contains the menu bar, tool bar, path entry, and folder list.</p>
45
46   <h2>Menu bar</h2>
47   
48   <p>The main menu of the window. The functions available from the main menu are described in the <a href="main_window_menus.html">Menus</a> chapter.</p>
49
50   <h2>Tool bar</h2>
51  
52   <p>The tool bar includes buttons for often used operations. The tool bar can be hidden or shown by selecting &ldquo;Hide toolbar&rdquo; from the view menu.</p>
53
54   <p class="note"><span class="note_label">Note:</span> These buttons are only displayed as an icon, the text below refers to the tool tip that appears by hovering the mouse over each button.</p>
55
56   <dl class="menu_desc">
57   <dt>Show thumbnails</dt><dd>This button is active when the file list is in list view mode, and activating it will toggle the display of thumbnails.</dd>
58
59   <dt>Change to home folder</dt><dd>Change the main window to display the contents of the user's home folder.</dd>
60
61   <dt>Refresh file list</dt><dd>This will check for changes to the active folder and update the window.</dd>
62
63   <dt>Zoom in</dt><dd>Increase the image display size.</dd>
64
65   <dt>Zoom out</dt><dd>Decrease the image display size.</dd>
66
67   <dt>Fit image to window</dt><dd>This will size the image to fit within the image view.</dd>
68
69   <dt>Set zoom 1:1</dt><dd>Restore zoom to the image's original size.</dd>
70
71   <dt>Configure options</dt><dd>Displays the <a href="options.html">Options window</a>.</dd>
72
73   <dt>Float controls</dt><dd>Toggle the folder pane, file pane, and status bar between the main window and a secondary window.</dd>
74   </dl>
75   
76   <h2>Path entry</h2>
77  
78   <p>This displays the active folder of the window and allows typing a location.</p>
79
80   <p>A folder or file can be typed into the entry to quickly change to a desired location or image, the main window will update after pressing the Enter key. Tab completion is also available in the path entry.</p>
81
82   <p class="note"><span class="note_label">Note:</span> Tab completion uses the tab key, press the down arrow to move the focus from the entry.</p>
83
84   <p>Next to the path entry is a button with a down arrow, clicking this will display a drop down list containing the most recent locations viewed. The list is ordered such that the most recent location is at the top. Selecting a location from the drop down list will change the window to display the location.</p>
85
86   <h2>Folder list</h2>
87  
88   <p>This displays a list of sub folders contained in the active folder, or a tree that includes all folders in the file system.</p>
89
90   <p>A <b>context menu</b> can be displayed by clicking the right mouse button on the folder pane or pressing the menu key while the folder pane has the focus</p>
91
92   <h2>List view</h2>
93
94   <p>This mode can be enabled by unselecting &ldquo;Tree&rdquo; from the View menu, pressing Control + T, or unselecting &ldquo;View as tree&rdquo; from the context menu.</p>
95
96   <p>The list view mode displays sub folders contained in the active folder in a standard vertical list. The parent folder can be selected with the folder named &ldquo;..&rdquo;.</p>
97
98   <h2>Tree view</h2>
99
100   <p>This mode can be enabled by selecting &ldquo;Tree&rdquo; from the View menu, pressing Control + T, or selecting &ldquo;View as tree&rdquo; from the context menu.</p>
101
102   <p>The tree view mode displays all folders in the file system, starting with the root folder and branching out to include sub folders. A folder branch can be expanded or collapsed by clicking the expander next to each folder icon, or by pressing the respective &ldquo;+&rdquo; or &ldquo;-&rdquo; keys when the folder branch has the focus.</p>
103
104   <h2>Sorting</h2>
105
106   <p>The order of the folder names will match the order selected for the file pane. Sort order can be changed by clicking the sort area of the status bar or from the context menu of the file pane.</p>
107
108   <h2>Context menu</h2>
109
110   <p>Right clicking the mouse or pressing the menu key while the folder pane has focus will display a menu. The menu functions will perform the same as those that match the window's <a href="main_window_menus.html">menu bar</a>, however a few functions are unique to the context menu:</p>
111
112   <dl class="menu_desc">
113   <dt>Up to parent</dt><dd>This will change the window to display the contents of the parent folder.</dd>
114
115   <dt>Slide show</dt><dd>Start a <a href="image_presentation_slideshow.html">slide show</a> that contains all images in the selected folder.</dd>
116
117   <dt>Slide show recursive</dt><dd>Start a <a href="image_presentation_slideshow.html">slide show</a> that contains all images in the selected folder, and all images in the sub folders of that folder.</dd>
118
119   <dt>Find duplicates</dt><dd>This will open a new <a href="image_search_finding_duplicates.html">find duplicates</a> window containing all images in the selected folder.</dd>
120
121   <dt>Find duplicates recursive</dt><dd>This will open a new <a href="image_search_finding_duplicates.html">find duplicates</a> window containing all image in the selected folder, and all images in the sub folders of that folder.</dd>
122
123   <dt>New folder</dt><dd>Creates a new folder that is a sub folder of the selected folder.</dd>
124
125   <dt>Rename</dt><dd>Renames the selected folder.
126
127   <p class="note"><span class="note_label">Note:</span> Renaming a folder will not update metadata, such as keywords, or cached thumbnails for images contained in that folder, the data will be lost.</p></dd>
128
129   <dt>View as tree</dt><dd>Toggles between the list and tree modes of the folder pane.</dd>
130
131   </dl>
132
133   <h2>Drag and drop</h2>
134
135   <p>Image files can be dropped onto folders displayed in the folder pane. A menu will appear allowing you to select to move or copy the dropped images into the target folder. The list will automatically scroll up or down when the drag pointer is near the respective top or bottom of the list. When in tree mode, hovering over a folder for a brief period of time will expand that folder.</p>
136
137   <p>The folders can used as a drag source for drag and drop, for example to add images in a folder to a collection window. However drag and drop can not be used to move or copy folders in Geeqie.</p>
138
139   <hr />
140
141   <div class="navbottom">
142     <table width="100%" border="0" cellpadding="4" cellspacing="0">
143       <col id="navbottom_col1" width="33%"></col>
144       <col id="navbottom_col2" width="33%"></col>
145       <col id="navbottom_col3" width="33%"></col>
146
147         <tr>
148           <th>
149             <p class="previous"><a href="main_window_file_pane.html">Previous</a>
150             </p>
151           </th>
152
153           <th>
154             <p class="navbottom_title"><a href="index.html">Contents</a>
155             </p>
156           </th>
157
158           <th>
159             <p class="next"><a href="main_window_image_pane.html">Next</a>
160             </p>
161           </th>
162         </tr>
163
164     </table>
165   </div>
166
167   <div class="footer">Geeqie User Manual</div>
168   <div class="bottomspacer">&nbsp;</div>
169 </body>
170 </html>