524b6f379b150873ecf98ef9260b3682b40a57c6
[geeqie.git] / doc / options_filtering.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>Filtering Options - 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="options_window.html">Previous</a>
25             </p>
26           </th>
27
28           <th>
29             <p class="navtop_title">Filtering &ndash; Options Explained</p>
30           </th>
31
32           <th>
33             <p class="next"><a href="options_editor_commands.html">Next</a>
34             </p>
35           </th>
36         </tr>
37     </table>
38   </div>
39
40   <hr />
41
42   <h1>Filtering Options</h1>
43
44   <p>This section describes the options presented under the Filtering Tab of the preferences dialog.</p>
45
46   <h2>Filters</h2>
47
48   <dl class="dialog_desc">
49   <dt>Show hidden files or folders</dt>
50   <dd><p>Enables the display of hidden files and folders, also known as dot files.</p></dd>
51  
52   <dt>Show dot directory</dt>
53   <dd><p>Enables the display of the current directory as a dot in the directories views. It may be useful for some drag'n'drop operations.</p></dd>
54
55   <dt>Case sensitive sort</dt>
56   <dd><p>Files and folders are sorted such that upper case letters occur before lower case letters.</p>
57   <p>Enabled result: A, B, C, a, b, c<br />
58   Disabled result: A, a, B, b, C, c</p>
59   </dd>
60
61   <dt>Disable file filtering</dt>
62   <dd><p>Enable this to allow Geeqie to list all files, even those that do not contain images.</p></dd>
63
64   </dl>
65   
66   <h2>Grouping sidecar extensions</h2>
67   <p>This field defines which extensions will lead to file grouping. Each extension should be separated by a semi-colon and should include the starting dot.</p>
68   <p>Grouped files will appear as one in file views. For example, it is useful when browsing directories containing two files for the same image (as raw+jpeg files generated by some cameras).</p>
69
70   <h2>File types</h2>
71
72   <p>This list contains the image formats that are understood by Geeqie. To disable a specific file type from being displayed, uncheck it's corresponding checkbox. Filters can be edited by first selecting the line containing the item to be changed, then clicking the filter or description field, making any changes, then pressing <span class="key">Enter</span>; press <span class="key">Escape</span> to cancel an active edit. The format for the filter field is a semicolon (;) seperated list of extensions, extensions must include the period (.).</p>
73
74   <p class="note"><span class="note_label">Note:</span> Unlike all other options in the dialog, filter list changes are applied immediately.</p>
75
76   <dl class="dialog_desc">
77
78   <dt>Add button</dt>
79   <dd><p>Adds a new blank line to the filter list, change the parameters to match the desired file type.</p></dd>
80
81   <dt>Remove button</dt>
82   <dd><p>Removes the selected line from the filter list.</p></dd>
83
84   <dt>Defaults button</dt>
85   <dd><p>Resets the filter list to the default values, discarding any customizations made by the user.</p></dd>
86
87   </dl>
88
89   <hr id="bottomseparator" />
90
91   <div class="navbottom">
92     <table width="100%" border="0" cellpadding="4" cellspacing="0">
93       <col id="navbottom_col1" width="33%"></col>
94       <col id="navbottom_col2" width="33%"></col>
95       <col id="navbottom_col3" width="33%"></col>
96
97         <tr>
98           <th>
99             <p class="previous"><a href="options_window.html">Previous</a>
100             </p>
101           </th>
102
103           <th>
104             <p class="navbottom_title"><a href="index.html">Contents</a>
105             </p>
106           </th>
107
108           <th>
109             <p class="next"><a href="options_editor_commands.html">Next</a>
110             </p>
111           </th>
112         </tr>
113
114     </table>
115   </div>
116
117   <div class="footer">Geeqie User Manual</div>
118   <div class="bottomspacer">&nbsp;</div>
119 </body>
120 </html>