doc/handbook/configuration-files.docbook

0001 <!--
0002     SPDX-FileCopyrightText: 2000-2003 Shie Erlich <erlich@users.sourceforge.net>
0003     SPDX-FileCopyrightText: 2000-2003 Rafi Yanai <yanai@users.sourceforge.net>
0004     SPDX-FileCopyrightText: 2004-2010 Frank Schoolmeesters <codeknight@users.sourceforge.net>
0005     SPDX-FileCopyrightText: 2000-2022 Krusader Krew <https://krusader.org>
0006 -->
0007 <appendix id="config_files">
0008   <title>Configuration Files</title>
0009   <indexterm>
0010     <primary>Configuration files</primary>
0011   </indexterm>
0012   <para>This appendix gives an overview of the configuration files
0013   used by &krusader;.</para>
0014   <para>
0015     <emphasis role="bold">krusaderui.rc</emphasis>
0016   </para>
0017   <para>This file stores the users toolbar settings and the menu
0018   structure.</para>
0019   <para>Location:
0020   <filename>/usr/share/kxmlgui5/krusader/krusaderui.rc</filename>, or
0021   <filename>
0022   ~/.local/share/kxmlgui5/krusader/krusaderui.rc</filename>, or <filename>kxmlgui5/krusader/krusaderui.rc</filename> in the folder which can be determined using the <userinput>qtpaths --paths GenericDataLocation</userinput> command</para>
0023   <para>
0024     <emphasis role="bold">krusaderrc</emphasis>
0025   </para>
0026   <para>This file stores the &krusader;
0027   configuration.</para>
0028   <para>Location:
0029   <filename>~/.config/krusaderrc</filename></para>
0030   <para>The following settings are &eg; stored:</para>
0031   <itemizedlist>
0032     <listitem>
0033       <para>Actions Toolbar</para>
0034     </listitem>
0035     <listitem>
0036       <para>Archives</para>
0037     </listitem>
0038     <listitem>
0039       <para>Colors</para>
0040     </listitem>
0041     <listitem>
0042       <para>Dependencies</para>
0043     </listitem>
0044     <listitem>
0045       <para>DiskUsage</para>
0046     </listitem>
0047     <listitem>
0048       <para>DiskUsageViewer</para>
0049     </listitem>
0050     <listitem>
0051       <para>General</para>
0052     </listitem>
0053     <listitem>
0054       <para>&HTML; Settings</para>
0055     </listitem>
0056     <listitem>
0057       <para>KFileDialog</para>
0058     </listitem>
0059     <listitem>
0060       <para>KFileDialog Speedbar</para>
0061     </listitem>
0062     <listitem>
0063       <para>KrDetailedViewLeft</para>
0064     </listitem>
0065     <listitem>
0066       <para>KrDetailedViewRight</para>
0067     </listitem>
0068     <listitem>
0069       <para>KrViewerWindow</para>
0070     </listitem>
0071     <listitem>
0072       <para>KrViewerWindow Toolbar extraToolBar</para>
0073     </listitem>
0074     <listitem>
0075       <para>Look &amp; Feel</para>
0076     </listitem>
0077     <listitem>
0078       <para>Notification Messages</para>
0079     </listitem>
0080     <listitem>
0081       <para>Panel Profiles</para>
0082     </listitem>
0083     <listitem>
0084       <para>Private</para>
0085     </listitem>
0086     <listitem>
0087       <para>Protocols</para>
0088     </listitem>
0089     <listitem>
0090       <para>Search</para>
0091     </listitem>
0092     <listitem>
0093       <para>Startup</para>
0094     </listitem>
0095     <listitem>
0096       <para>Synchronize</para>
0097     </listitem>
0098     <listitem>
0099       <para>Locate</para>
0100     </listitem>
0101     <listitem>
0102       <para>SynchronizerProfile - 1</para>
0103     </listitem>
0104   </itemizedlist>
0105   <para>
0106     <emphasis role="bold">krbookmarks.xml</emphasis>
0107   </para>
0108   <para>This file stores the &krusader; bookmarks and
0109   uses the <ulink url="http://grail.sourceforge.net/info/xbel.html">XBEL standard</ulink>.</para>
0110   <para>Location:
0111   <filename>
0112   ~/.local/share/krusader/krbookmarks.xml</filename> or <filename>krusader/krbookmarks.xml</filename> in the folder which can be determined using the <userinput>qtpaths --paths GenericDataLocation</userinput> command</para>
0113   <para>
0114     <emphasis role="bold">useractions.xml</emphasis>
0115   </para>
0116   <para>This file stores the <link linkend="useractions">UserActions</link>
0117   configuration.</para>
0118   <para>Location:
0119   <filename>
0120   ~/.local/share/krusader/useractions.xml</filename> or <filename>krusader/useractions.xml</filename> in the folder which can be determined using the <userinput>qtpaths --paths GenericDataLocation</userinput> command</para>
0121   <para>
0122     <emphasis role="bold">useraction-examples.xml</emphasis>
0123   </para>
0124   <para>This is the default UserActions provided by developers.</para>
0125   <para>Location:
0126   <filename>
0127   $KDEDIR/share/krusader/useraction-examples.xml</filename></para>
0128   <para>
0129     <emphasis role="bold">foo.keymap</emphasis>
0130   </para>
0131   <para>This is a <literal role="extension">.ini</literal> file that holds a
0132   <link linkend="configure-shortcuts">Key binding profile</link>.
0133   Until &krusader;-1.70.0 this was a binary file.
0134   &krusader; is backwards compatible for importing this
0135   legacy binary format.</para>
0136   <para>Location:
0137   <filename>
0138   /usr/share/krusader/foo.keymap</filename></para>
0139   <para>
0140     <emphasis role="bold">foo.color</emphasis>
0141   </para>
0142   <para>This is a binary file that holds the
0143   <link linkend="konfig-color">Color Scheme</link>.</para>
0144   <para>Location:
0145   <filename>/usr/share/krusader/foo.color</filename></para>
0146 </appendix>