doc/docbook/GuideOptionsFiltering.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <section id="GuideOptionsFiltering">
   3   <title id="titleGuideOptionsFiltering">File Filters Options</title>
   4   <para>This section describes the options presented under the File Filters Tab of the preferences dialogue.</para>
   5   <para />
   6   <section id="Filters">
   7     <title>Filters</title>
   8     <variablelist>
   9       <varlistentry>
  10         <term>
  11           <guilabel>Show hidden files or folders</guilabel>
  12         </term>
  13         <listitem>
  14           <para>Enables the display of hidden files and folders, also known as dot files.</para>
  15         </listitem>
  16       </varlistentry>
  17       <varlistentry>
  18         <term>
  19           <guilabel>Show parent folder</guilabel>
  20         </term>
  21         <listitem>
  22           <para>Enables the display of the parent folder as a double dot in the directories views.</para>
  23         </listitem>
  24       </varlistentry>
  25       <varlistentry>
  26         <term>
  27           <guilabel>Case sensitive sort (Collection and Search windows, and tab completion)</guilabel>
  28         </term>
  29         <listitem>
  30           <para>Files and folders are sorted such that upper case letters occur before lower case letters.</para>
  31           <para>
  32             Enabled result: A, B, C, a, b, c
  33             <para />
  34             Disabled result: A, a, B, b, C, c
  35           </para>
  36         </listitem>
  37       </varlistentry>
  38       <varlistentry>
  39         <term>
  40           <guilabel>Disable file extension checks</guilabel>
  41         </term>
  42         <listitem>
  43           <para>During rename operations, allows files to be renamed to a different extension with no warning issued.</para>
  44         </listitem>
  45       </varlistentry>
  46       <varlistentry>
  47         <term>
  48           <guilabel>Disable file filtering</guilabel>
  49         </term>
  50         <listitem>
  51           <para>Enable this to allow Geeqie to list all files, even those that do not contain images.</para>
  52         </listitem>
  53       </varlistentry>
  54     </variablelist>
  55     <para />
  56   </section>
  57   <section id="Groupingsidecarextensions">
  58     <title>Grouping sidecar extensions</title>
  59     <para>This field defines which extensions will lead to file grouping. Grouped files will appear as a single entry in file views. This is useful, for example, when browsing directories containing two files for the same image (such as raw+jpeg files generated by some cameras).</para>
  60     <para>The group is represented by the first extension in the list for which a file exists.</para>
  61     <para>
  62       Each extension should include the starting dot and should be separated by a semi-colon from following entries. It is possible to use wild-cards corresponding to entries in the
  63       <emphasis>File Types Class</emphasis>
  64       below:
  65       <variablelist>
  66         <varlistentry>
  67           <term>
  68             <literal>%unknown</literal>
  69           </term>
  70           <listitem>
  71             expands to all files listed in class
  72             <emphasis>Unknown</emphasis>
  73             ,
  74           </listitem>
  75         </varlistentry>
  76         <varlistentry>
  77           <term>
  78             <literal>%image</literal>
  79           </term>
  80           <listitem>
  81             expands to all files listed in class
  82             <emphasis>Image</emphasis>
  83             ,
  84           </listitem>
  85         </varlistentry>
  86         <varlistentry>
  87           <term>
  88             <literal>%raw</literal>
  89           </term>
  90           <listitem>
  91             expands to all files listed in class
  92             <emphasis>RAW Image</emphasis>
  93           </listitem>
  94         </varlistentry>
  95         <varlistentry>
  96           <term>
  97             <literal>%meta</literal>
  98           </term>
  99           <listitem>
 100             expands to all files listed in class
 101             <emphasis>Metadata</emphasis>
 102           </listitem>
 103         </varlistentry>
 104       </variablelist>
 105     </para>
 106     <para />
 107     <para />
 108   </section>
 109   <section id="Filetypes">
 110     <title>File types</title>
 111     <para>
 112       This list contains the image formats that are understood by Geeqie. To disable a specific file type from being displayed, uncheck it's corresponding check-box. 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
 113       <keycap>Enter</keycap>
 114       ; press
 115       <keycap>Escape</keycap>
 116       to cancel an active edit.
 117     </para>
 118     <note>
 119       <para>Unlike all other options in the dialogue, filter list changes are applied immediately.</para>
 120     </note>
 121     <para>
 122       The table consists of:
 123       <variablelist>
 124         <varlistentry>
 125           <term>
 126             <guilabel>Enabled</guilabel>
 127           </term>
 128           <listitem>
 129             Whether or not the filter is used.
 130           </listitem>
 131         </varlistentry>
 132         <varlistentry>
 133           <term>
 134             <guilabel>Filter</guilabel>
 135           </term>
 136           <listitem>
 137             List of extensions this filter applies to, separated by a
 138             <code>;</code>
 139             . Each extension must be preceded by a dot.
 140           </listitem>
 141         </varlistentry>
 142         <varlistentry>
 143           <term>
 144             <guilabel>Description</guilabel>
 145           </term>
 146           <listitem>Brief description. This is not used elsewhere.</listitem>
 147         </varlistentry>
 148         <varlistentry>
 149           <term>
 150             <guilabel>Class</guilabel>
 151           </term>
 152           <listitem>
 153             This may be used to define sets of file types, for use in the
 154             <emphasis>Grouping</emphasis>
 155             function described above. The drop-down list has 7 entries:
 156             <itemizedlist>
 157               <listitem>Unknown</listitem>
 158               <listitem>Image</listitem>
 159               <listitem>RAW Image</listitem>
 160               <listitem>Metadata</listitem>
 161               <listitem>Video</listitem>
 162               <listitem>Collection</listitem>
 163               <listitem>Document</listitem>
 164               <listitem>Archive (.zip, .rar etc.)</listitem>
 165             </itemizedlist>
 166           </listitem>
 167         </varlistentry>
 168         <varlistentry>
 169           <term>
 170             <guilabel>Writable</guilabel>
 171           </term>
 172           <listitem>If this option is checked, Geeqie will try to write metadata to the image file itself. This, and the following option, are mutually exclusive.</listitem>
 173         </varlistentry>
 174         <varlistentry>
 175           <term>
 176             <guilabel>Sidecar is allowed</guilabel>
 177           </term>
 178           <listitem>If this option is checked, Geeqie will try to write metadata to a sidecar file associated with the image. This, and the previous option, are mutually exclusive.</listitem>
 179         </varlistentry>
 180       </variablelist>
 181     </para>
 182     <variablelist>
 183       <varlistentry>
 184         <term>
 185           <guibutton>
 186             <guiicon>
 187               <inlinegraphic fileref="list-add.png" />
 188             </guiicon>
 189             Add
 190           </guibutton>
 191         </term>
 192         <listitem>Adds a new blank line to the filter list, change the parameters to match the desired file type.</listitem>
 193       </varlistentry>
 194     </variablelist>
 195     <variablelist>
 196       <varlistentry>
 197         <term>
 198           <guibutton>
 199             <guiicon>
 200               <inlinegraphic fileref="list-remove.png" />
 201             </guiicon>
 202             Remove
 203           </guibutton>
 204         </term>
 205         <listitem>Removes the selected line from the filter list.</listitem>
 206       </varlistentry>
 207     </variablelist>
 208     <variablelist>
 209       <varlistentry>
 210         <term>
 211           <guibutton>Defaults</guibutton>
 212         </term>
 213         <listitem>Resets the filter list to the default values, discarding any customizations made by the user.</listitem>
 214       </varlistentry>
 215     </variablelist>
 216     <variablelist>
 217       <varlistentry>
 218         <term>
 219           <guibutton>Column Sorting</guibutton>
 220         </term>
 221         <listitem>Columns other than Filter can be sorted in ascending or descending order by clicking on the column header.</listitem>
 222       </varlistentry>
 223     </variablelist>
 224     <variablelist>
 225       <varlistentry>
 226         <term>
 227           <guibutton>Filter Search</guibutton>
 228         </term>
 229         <listitem>A search of the file extensions listed in the Filter column can be initiated either by typing <code>Ctrl + F</code> or by pressing any alpha-numeric key when the File Types table has focus.</listitem>
 230       </varlistentry>
 231     </variablelist>
 232   </section>
 233 </section>