Mercurial > hg > forks > geeqie

annotate doc/docbook/GuideReferenceConfig.xml @ 2833:c8ed60cb1990

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Fix #633: Fix typo in GuideReferenceConfig.html https://github.com/BestImageViewer/geeqie/pull/633
author Andreas Rönnquist <>
date Mon, 24 Sep 2018 10:23:28 +0100
parents 3685b630d2e4
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2388
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
1 <?xml version="1.0" encoding="utf-8"?>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
2 <section id="GuideReferenceConfig">
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
3 <title id="titleGuideReferenceConfig">Configuration Files and Locations</title>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
4 <para>The following data lists the locations Geeqie uses for various actions. The uppercase symbols are environment variables. If they are not set on your system the fallback locations are listed in parentheses.</para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
5 <para>
2833
c8ed60cb1990 Fix #633: Fix typo in GuideReferenceConfig.html
Andreas Rönnquist <>
parents: 2628
diff changeset
6 Geeqie will first attempt to load a configuration file from:
2518
8d368d89a7c0 Minor doc update - config file locations
Colin Clark <colin.clark@cclark.uk>
parents: 2388
diff changeset
7 <programlisting xml:space="preserve">/etc/geeqie/geeqierc.xml</programlisting>
8d368d89a7c0 Minor doc update - config file locations
Colin Clark <colin.clark@cclark.uk>
parents: 2388
diff changeset
8 </para>
8d368d89a7c0 Minor doc update - config file locations
Colin Clark <colin.clark@cclark.uk>
parents: 2388
diff changeset
9 <para>It will then continue with the following locations.</para>
8d368d89a7c0 Minor doc update - config file locations
Colin Clark <colin.clark@cclark.uk>
parents: 2388
diff changeset
10 <para>
2388
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
11 Most of Geeqie's configuration files are contained in the folder, and sub-folders of:
2518
8d368d89a7c0 Minor doc update - config file locations
Colin Clark <colin.clark@cclark.uk>
parents: 2388
diff changeset
12 <programlisting xml:space="preserve">$XDG_CONFIG_HOME/geeqie/</programlisting>
2388
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
13 <programlisting xml:space="preserve">($~/.config/geeqie/)</programlisting>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
14 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
15 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
16 Geeqie's standard configuration file is:
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
17 <programlisting xml:space="preserve">.../geeqierc.xml</programlisting>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
18 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
19 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
20 An alternative configuration file may be used by executing:
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
21 <programlisting xml:space="preserve">geeqie -r --config-load:&lt;filename&gt;</programlisting>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
22 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
23 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
24 Geeqie-created desktop files used by
2628
3685b630d2e4 Fix documentation errors
Colin Clark <colin.clark@cclark.uk>
parents: 2518
diff changeset
25 <link linkend="GuideImageManagementPlugins">Plugins</link>
2388
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
26 are in the folder:
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
27 <programlisting xml:space="preserve">.../applications</programlisting>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
28 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
29 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
30 Lua script files for
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
31 <link linkend="GuideReferenceLua">Lua Extensions</link>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
32 are in the folder:
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
33 <programlisting xml:space="preserve">.../lua</programlisting>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
34 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
35 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
36 Historic data such as last several folders visited, bookmarks, and recently used collections, as well as default print settings are contained in this text file:
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
37 <programlisting xml:space="preserve">.../history</programlisting>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
38 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
39 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
40 Keyboard shortcut maps are contained in this text file:
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
41 <programlisting xml:space="preserve">.../accels</programlisting>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
42 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
43 <para>
2518
8d368d89a7c0 Minor doc update - config file locations
Colin Clark <colin.clark@cclark.uk>
parents: 2388
diff changeset
44 The location for Collections is in the folder:
8d368d89a7c0 Minor doc update - config file locations
Colin Clark <colin.clark@cclark.uk>
parents: 2388
diff changeset
45 <programlisting xml:space="preserve">$XDG_DATA_HOME/geeqie/collections</programlisting>
8d368d89a7c0 Minor doc update - config file locations
Colin Clark <colin.clark@cclark.uk>
parents: 2388
diff changeset
46 <programlisting xml:space="preserve">($~/.local/share/geeqie/collections)</programlisting>
2388
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
47 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
48 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
49 The lirc
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
50 <link linkend="GuideReferenceLIRC" endterm="titleGuideReferenceLIRC" />
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
51 configuration file must be located at:
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
52 <programlisting xml:space="preserve">$HOME/.lircrc</programlisting>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
53 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
54 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
55 Thumbnails are stored in a location specified in
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
56 <link linkend="PreferencesThumbnails">Thumbnail Preferences</link>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
57 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
58 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
59 Metadata is stored either in the image file or in the location specified in
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
60 <link linkend="Delete">Safe Delete</link>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
61 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
62 <para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
63 The safe delete folder is specified in the
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
64 <link linkend="MetadataWritingProcess">Metadata</link>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
65 tab of main Preferences
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
66 </para>
4879d0fc9a81 Revised Help files
Colin Clark <cclark@mcb.net>
parents: 1773
diff changeset
67 </section>