doc/docbook/GuideMainWindowFolderPane.xml

   1 <?xml version="1.0" encoding="utf-8"?>\r
   2 <section id="GuideMainWindowFolderPane">\r
   3   <title id="titleGuideMainWindowFolderPane">Folder pane</title>\r
   4   <para>The folder pane contains the menu bar, tool bar, path entry, and folder list.</para>\r
   5   <para />\r
   6   <section id="Menubar">\r
   7     <title>Menu bar</title>\r
   8     <para>\r
   9       The main menu of the window. The functions available from the main menu are described in the\r
  10       <link linkend="GuideMainWindowMenus">Menus</link>\r
  11       chapter.\r
  12     </para>\r
  13     <para />\r
  14   </section>\r
  15   <section id="Toolbar">\r
  16     <title>Tool bar</title>\r
  17     <para>\r
  18       The tool bar includes buttons for often used operations. The tool bar can be hidden or shown by selecting\r
  19       <emphasis role="bold">Hide toolbar</emphasis>\r
  20       from the\r
  21       <emphasis role="bold">View</emphasis>\r
  22       menu.\r
  23     </para>\r
  24     <table frame="all">\r
  25       <tgroup cols="3" rowsep="1" colsep="1">\r
  26         <thead rowsep="1" colsep="1">\r
  27           <row>\r
  28             <entry>Icon</entry>\r
  29             <entry>Tooltip</entry>\r
  30             <entry>Description</entry>\r
  31           </row>\r
  32         </thead>\r
  33         <tbody>\r
  34           <row>\r
  35             <entry>\r
  36               <guiicon>\r
  37                 <inlinegraphic fileref="icon_thumb.png" />\r
  38               </guiicon>\r
  39             </entry>\r
  40             <entry>Show thumbnails</entry>\r
  41             <entry>\r
  42               <para>This button is active when the file list is in list view mode, and activating it will toggle the display of thumbnails.</para>\r
  43             </entry>\r
  44           </row>\r
  45           <row>\r
  46             <entry>\r
  47               <guiicon>\r
  48                 <inlinegraphic fileref="go-previous.png" />\r
  49               </guiicon>\r
  50             </entry>\r
  51             <entry>Back</entry>\r
  52             <entry>\r
  53               <para>Move back in folder history</para>\r
  54             </entry>\r
  55           </row>\r
  56           <row>\r
  57             <entry>\r
  58               <guiicon>\r
  59                 <inlinegraphic fileref="go-up.png" />\r
  60               </guiicon>\r
  61             </entry>\r
  62             <entry>Up</entry>\r
  63             <entry>\r
  64               <para>Move up one folder</para>\r
  65             </entry>\r
  66           </row>\r
  67           <row>\r
  68             <entry>\r
  69               <guiicon>\r
  70                 <inlinegraphic fileref="user-home.png" />\r
  71               </guiicon>\r
  72             </entry>\r
  73             <entry>Home</entry>\r
  74             <entry>\r
  75               <para>Change the main window to display the contents of the user's home folder</para>\r
  76             </entry>\r
  77           </row>\r
  78           <row>\r
  79             <entry>\r
  80               <guiicon>\r
  81                 <inlinegraphic fileref="view-refresh.png" />\r
  82               </guiicon>\r
  83             </entry>\r
  84             <entry>Refresh folder display</entry>\r
  85             <entry>\r
  86               <para>Refresh the contents of the file pane</para>\r
  87             </entry>\r
  88           </row>\r
  89           <row>\r
  90             <entry>\r
  91               <guiicon>\r
  92                 <inlinegraphic fileref="zoom-in.png" />\r
  93               </guiicon>\r
  94             </entry>\r
  95             <entry>Zoom in</entry>\r
  96             <entry>\r
  97               <para>Increase the image display size.</para>\r
  98             </entry>\r
  99           </row>\r
 100           <row>\r
 101             <entry>\r
 102               <guiicon>\r
 103                 <inlinegraphic fileref="zoom-out.png" />\r
 104               </guiicon>\r
 105             </entry>\r
 106             <entry>Zoom out</entry>\r
 107             <entry>\r
 108               <para>Decrease the image display size.</para>\r
 109             </entry>\r
 110           </row>\r
 111           <row>\r
 112             <entry>\r
 113               <guiicon>\r
 114                 <inlinegraphic fileref="zoom-fit-best.png" />\r
 115               </guiicon>\r
 116             </entry>\r
 117             <entry>Zoom to fit</entry>\r
 118             <entry>\r
 119               <para>This will size the image to fit within the window</para>\r
 120             </entry>\r
 121           </row>\r
 122           <row>\r
 123             <entry>\r
 124               <guiicon>\r
 125                 <inlinegraphic fileref="zoom-original.png" />\r
 126               </guiicon>\r
 127             </entry>\r
 128             <entry>Zoom 1:1</entry>\r
 129             <entry>\r
 130               <para>Restore zoom to the image's original size.</para>\r
 131             </entry>\r
 132           </row>\r
 133           <row>\r
 134             <entry>\r
 135               <guiicon>\r
 136                 <inlinegraphic fileref="preferences-desktop.png" />\r
 137               </guiicon>\r
 138             </entry>\r
 139             <entry>Preferences</entry>\r
 140             <entry>\r
 141               <para>\r
 142                 Displays the\r
 143                 <link linkend="GuideOptions">Preferences window</link>\r
 144                 .\r
 145               </para>\r
 146             </entry>\r
 147           </row>\r
 148           <row>\r
 149             <entry>\r
 150               <guiicon>\r
 151                 <inlinegraphic fileref="icon_float.png" />\r
 152               </guiicon>\r
 153             </entry>\r
 154             <entry>Float file list</entry>\r
 155             <entry>\r
 156               <para>Toggle the folder pane, file pane, and status bar between the main window and a secondary window.</para>\r
 157             </entry>\r
 158           </row>\r
 159         </tbody>\r
 160       </tgroup>\r
 161     </table>\r
 162     <para />\r
 163   </section>\r
 164   <section id="Pathentry">\r
 165     <title>Path entry</title>\r
 166     <para>This displays the active folder of the window and allows typing a location.</para>\r
 167     <para>\r
 168       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\r
 169       <code>Enter</code>\r
 170       key. Tab completion is also available in the path entry.\r
 171     </para>\r
 172     <note>\r
 173       <para>\r
 174         Tab completion uses the\r
 175         <keycode>Tab</keycode>\r
 176         key, press the\r
 177         <keycode>Down</keycode>\r
 178         key to move the focus from the entry.\r
 179       </para>\r
 180     </note>\r
 181     <para>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.</para>\r
 182     <para />\r
 183   </section>\r
 184   <section id="Folderlist">\r
 185     <title>Folder list</title>\r
 186     <para>This displays a list of sub folders contained in the active folder, or a tree that includes all folders in the file system.</para>\r
 187     <para>\r
 188       A\r
 189       <emphasis role="strong">context menu</emphasis>\r
 190       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\r
 191     </para>\r
 192     <para />\r
 193   </section>\r
 194   <section id="Listview">\r
 195     <title>List view</title>\r
 196     <para>\r
 197       This mode can be enabled by from the\r
 198       <emphasis role="bold">View</emphasis>\r
 199       menu, from the context menu, or pressing\r
 200       <code>Ctrl + T</code>\r
 201       .\r
 202     </para>\r
 203     <para>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 “..”.</para>\r
 204     <para />\r
 205   </section>\r
 206   <section id="Treeview">\r
 207     <title>Tree view</title>\r
 208     <para>\r
 209       This mode can be enabled by selecting\r
 210       <emphasis role="bold">Tree</emphasis>\r
 211       from the View menu, pressing\r
 212       <code>Ctrl + T</code>\r
 213       , or selecting\r
 214       <emphasis role="bold">View as tree</emphasis>\r
 215       from the context menu.\r
 216     </para>\r
 217     <para>\r
 218       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\r
 219       <code>+</code>\r
 220       or\r
 221       <code>-</code>\r
 222       keys when the folder branch has the focus.\r
 223     </para>\r
 224     <para />\r
 225   </section>\r
 226   <section id="Sorting">\r
 227     <title>Sorting</title>\r
 228     <para>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.</para>\r
 229     <para />\r
 230   </section>\r
 231   <section id="Contextmenu">\r
 232     <title>Context menu</title>\r
 233     <para>\r
 234       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\r
 235       <link linkend="GuideMainWindowMenus">menu bar</link>\r
 236       , however a few functions are unique to the context menu:\r
 237     </para>\r
 238     <table frame="all">\r
 239       <tgroup cols="3" rowsep="1" colsep="1">\r
 240         <thead rowsep="1" colsep="1">\r
 241           <row>\r
 242             <entry>Icon</entry>\r
 243             <entry>Text</entry>\r
 244             <entry>Description</entry>\r
 245           </row>\r
 246         </thead>\r
 247         <tbody>\r
 248           <row>\r
 249             <entry>\r
 250               <guiicon>\r
 251                 <inlinegraphic fileref="go-up.png" />\r
 252               </guiicon>\r
 253             </entry>\r
 254             <entry>Up to parent</entry>\r
 255             <entry>\r
 256               <para>This will change the window to display the contents of the parent folder.</para>\r
 257             </entry>\r
 258           </row>\r
 259           <row>\r
 260             <entry />\r
 261             <entry>Slide show</entry>\r
 262             <entry>\r
 263               <para>\r
 264                 Start a\r
 265                 <link linkend="GuideImagePresentationSlideshow">slide show</link>\r
 266                 that contains all images in the selected folder.\r
 267               </para>\r
 268             </entry>\r
 269           </row>\r
 270           <row>\r
 271             <entry />\r
 272             <entry>Slide show recursive</entry>\r
 273             <entry>\r
 274               <para>\r
 275                 Start a\r
 276                 <link linkend="GuideImagePresentationSlideshow">slide show</link>\r
 277                 that contains all images in the selected folder, and all images in the sub folders of that folder.\r
 278               </para>\r
 279             </entry>\r
 280           </row>\r
 281           <row>\r
 282             <entry>\r
 283               <guiicon>\r
 284                 <inlinegraphic fileref="edit-find.png" />\r
 285               </guiicon>\r
 286             </entry>\r
 287             <entry>Find duplicates</entry>\r
 288             <entry>\r
 289               <para>\r
 290                 This will open a new\r
 291                 <link linkend="GuideImageSearchFindingDuplicates">find duplicates</link>\r
 292                 window containing all images in the selected folder.\r
 293               </para>\r
 294             </entry>\r
 295           </row>\r
 296           <row>\r
 297             <entry>\r
 298               <guiicon>\r
 299                 <inlinegraphic fileref="edit-find.png" />\r
 300               </guiicon>\r
 301             </entry>\r
 302             <entry>Find duplicates recursive</entry>\r
 303             <entry>\r
 304               <para>\r
 305                 This will open a new\r
 306                 <link linkend="GuideImageSearchFindingDuplicates">find duplicates</link>\r
 307                 window containing all image in the selected folder, and all images in the sub folders of that folder.\r
 308               </para>\r
 309             </entry>\r
 310           </row>\r
 311           <row>\r
 312             <entry />\r
 313             <entry>New folder</entry>\r
 314             <entry>\r
 315               <para>Creates a new folder that is a sub folder of the selected folder.</para>\r
 316             </entry>\r
 317           </row>\r
 318           <row>\r
 319             <entry />\r
 320             <entry>Rename</entry>\r
 321             <entry>\r
 322               <para>Renames the selected folder.</para>\r
 323               <warning>\r
 324                 <emphasis role="bold">Warning:</emphasis>\r
 325                 Renaming a folder will not update metadata, such as keywords, or cached thumbnails for images contained in that folder, the data will be lost.\r
 326               </warning>\r
 327             </entry>\r
 328           </row>\r
 329           <row>\r
 330             <entry>\r
 331               <guiicon>\r
 332                 <inlinegraphic fileref="edit-delete.png" />\r
 333               </guiicon>\r
 334             </entry>\r
 335             <entry>Delete</entry>\r
 336             <entry>\r
 337               <para>Delete file or folder</para>\r
 338             </entry>\r
 339           </row>\r
 340           <row>\r
 341             <entry />\r
 342             <entry>Copy path</entry>\r
 343             <entry>\r
 344               <para>Copy sjkhsdlfjhvfljhDelete file or folder</para>\r
 345             </entry>\r
 346           </row>\r
 347           <row>\r
 348             <entry />\r
 349             <entry>View as list</entry>\r
 350             <entry>\r
 351               <para>Switches to list tree mode of the folder pane.</para>\r
 352             </entry>\r
 353           </row>\r
 354           <row>\r
 355             <entry />\r
 356             <entry>View as tree</entry>\r
 357             <entry>\r
 358               <para>Switches to tree mode of the folder pane.</para>\r
 359             </entry>\r
 360           </row>\r
 361           <row>\r
 362             <entry />\r
 363             <entry>Show hiden files</entry>\r
 364             <entry>\r
 365               <para>Switches to list tree mode of the folder pane.</para>\r
 366             </entry>\r
 367           </row>\r
 368           <row>\r
 369             <entry>\r
 370               <guiicon>\r
 371                 <inlinegraphic fileref="view-refresh.png" />\r
 372               </guiicon>\r
 373             </entry>\r
 374             <entry>Refresh</entry>\r
 375             <entry>\r
 376               <para>Switches to tree mode of the folder pane.</para>\r
 377             </entry>\r
 378           </row>\r
 379         </tbody>\r
 380       </tgroup>\r
 381     </table>\r
 382     <para />\r
 383   </section>\r
 384   <section id="Draganddrop">\r
 385     <title>Drag and drop</title>\r
 386     <para>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.</para>\r
 387     <para>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.</para>\r
 388     <para>\r
 389       Using\r
 390       <code>Shift</code>\r
 391       key while dragging is a shortcut to move action. Menu will not appear but move will occur.\r
 392     </para>\r
 393     <para>\r
 394       Using\r
 395       <code>Ctrl</code>\r
 396       key while dragging is a shortcut to copy action. Menu will not appear but copy will occur.\r
 397     </para>\r
 398     <para />\r
 399   </section>\r
 400 </section>\r