<chapter id="gramps-settings"> <!-- User Manual for Gramps - a GTK+/GNOME based genealogy program Copyright (C) 2003-2005 Alexander Roitman This document is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This document is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA --> <!-- $Id$ --> <title>Settings</title> <sect1 id="gramps-prefs"> <title>Preferences</title> <para>Most of the settings in &app;, are configured in the <guilabel>Preferences</guilabel> dialog. To invoke it, choose <menuchoice><guimenu>Edit</guimenu> <guimenuitem>Preferences...</guimenuitem></menuchoice>. </para> <!-- ==== Figure: Type-ahead find ==== --> <figure id="prefs-fig"> <title>Preferences dialog</title> <screenshot><mediaobject><imageobject><imagedata fileref="figures/prefs.png" format="PNG"/></imageobject> <textobject> <phrase>Shows Preferences dialog. </phrase> </textobject></mediaobject></screenshot></figure> <!-- ==== End of Figure ==== --> <para>The pane on the left displays the tree of available option categories. Selecting a tree node will display the corresponding options in the right side of the dialog. </para> <sect2 id="gramps-prefs-db"> <title>Database</title> <para> This category contains preferences relevant to the database itself. It has the following subcategories: </para> <variablelist> <varlistentry><term><guilabel>General</guilabel></term> <listitem> <variablelist> <varlistentry><term><guilabel>Automatically load last database</guilabel></term> <listitem><para> Check this box to automatically load the last open database on startup. </para></listitem> </varlistentry> <varlistentry><term><guilabel>Family name guessing</guilabel></term> <listitem><para> This option affects the initial family name of a child when he/she is added to the database. </para> <tip><para>This option only affects the initial family name guessed by &app; when the <guilabel>Edit Person</guilabel> dialog is launched. You can modify that name the way you see fit. Set this option to the value that you will most frequently use, as it will save you a lot of typing.</para></tip> <para>If <guilabel>None</guilabel> is selected, no guessing will be attempted. Selecting <guilabel>Father's surname</guilabel> will use the family name of the father. Selecting <guilabel>Combination of mother's and father's surname</guilabel> will use the father's name followed by the mother's name. Finally, <guilabel>Icelandic style</guilabel> will use the father's given name followed by the "sson" suffix (e.g. the son of Edwin will be guessed as Edwinsson). </para></listitem> </varlistentry> </variablelist> </listitem> </varlistentry> <varlistentry><term><guilabel>GRAMPS IDs</guilabel></term> <listitem><para> Enter ID prefixes for various kinds of database entries into the corresponding text entry fields. </para> <tip><para>The ID prefixes use formatting conventions common for C, Python, and other programming languages. For example, the %04d expands to an integer, prepended with zeros to have the total width of four digits. If you would like IDs to be 1, 2, 3, etc, simply set the formatting parameter to %d. </para></tip> </listitem> </varlistentry> <varlistentry><term><guilabel>Researcher Information</guilabel></term> <listitem><para> Enter your personal information in the corresponding text entry fields. Although &app; requests information about you, this information is used only so that &app; can create valid GEDCOM output files. A valid GEDCOM file requires information about the file's creator. If you choose, you may leave the information empty, however none of your exported GEDCOM files will be valid. </para> </listitem> </varlistentry> </variablelist> </sect2> <sect2 id="gramps-prefs-display"> <title>Display</title> <para> This category contains preferences relevant to displaying database records and controls in &app;. It has the following subcategories:</para> <variablelist> <varlistentry><term><guilabel>General</guilabel></term> <listitem> <variablelist> <varlistentry><term><guilabel>Default view</guilabel></term> <listitem><para> This determines which view will appear when you start &app;. Choose between Person and Family views. </para></listitem> </varlistentry> <varlistentry><term><guilabel>Family view style</guilabel></term> <listitem><para> This selects between the two available styles of the Family view layout. The <guilabel>Left to right</guilabel> style is similar to the Family Tree Maker (tm), while the <guilabel>Top to bottom</guilabel> is similar to the Reunion. </para></listitem> </varlistentry> <varlistentry><term><guilabel>Always display the LDS ordinance tabs</guilabel></term> <listitem><para> Check this box to have LDS ordinance tabs displayed. If you do not know what LDS is then you probably should not check it. </para></listitem></varlistentry> <varlistentry><term><guilabel>Display Tip of the Day</guilabel></term> <listitem><para> Check this box to have the <guilabel>Tip of the Day</guilabel> dialog appear on every startup. The tips are displayed randomly from the large collection of information bits on &app;. </para> <tip><para>The <guilabel>Tip of the Day</guilabel> is likely to be useful for new user of &app;. </para></tip> </listitem></varlistentry> </variablelist> </listitem> </varlistentry> <varlistentry><term><guilabel>Dates</guilabel></term> <listitem> <para> Select the display format for the dates from the available formats listed in this menu. </para> <tip><para>Available date display formats are language-specific. Depending on whether or not there is a &app; date displayer available for your language, you may or may not have a lot of choices. </para></tip> </listitem> </varlistentry> <varlistentry><term><guilabel>Toolbar and Statusbar</guilabel></term> <listitem> <variablelist> <varlistentry><term><guilabel>Toolbar</guilabel></term> <listitem><para> Select the desired appearance of the toolbar icons from the menu. Selecting <guilabel>GNOME Settings</guilabel> will use the overall settings selected for your GNOME desktop. </para></listitem> </varlistentry> <varlistentry><term><guilabel>Statusbar</guilabel></term> <listitem><para> Select the desired contents displayed in the statusbar using the radio buttons. </para></listitem> </varlistentry> </variablelist> </listitem> </varlistentry> </variablelist> </sect2> </sect1> <sect1 id="gramps-prefs-other"> <title>Other settings</title> <para>Besides <guilabel>Preferences</guilabel> dialog, there are other settings available in &app;. For various reasons they have been made more readily accessible, as listed below.</para> <variablelist> <varlistentry> <term>Column Editor</term> <listitem> <para>The columns of the list views may be added, removed, or reordered in a <guilabel>Column Editor Dialog</guilabel>, see <xref linkend="column-editor-fig"/>. Only checked columns will be shown in the view. To change their order, drag any column to its desired place inside the editor. Clicking <guibutton>OK</guibutton> will reflect the changes in the appropriate view. To invoke <guilabel>Column Editor Dialog</guilabel>, choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Column Editor...</guimenuitem></menuchoice>. </para> <tip> <para>The <guilabel>Column Editor</guilabel> is available and works in the same way for all list views. Specifically, it is available for People View, Family View (children list). Sources View, Places View, and Media View.</para> </tip> </listitem> </varlistentry> <varlistentry><term>Setting Home person</term> <listitem><para>The Home person is the person who becomes active when database opened, when <guibutton>Home</guibutton> button is clicked or the <guimenuitem>Home</guimenuitem> menu item is selected from either <guimenu>Go</guimenu> menu or the right-click context menu anywhere.</para> <para>To set Home person, make the desired person active and then choose <menuchoice><guimenu>Edit</guimenu><guimenuitem>Set Home person...</guimenuitem></menuchoice>.</para> </listitem> </varlistentry> <varlistentry><term>Adjusting viewing controls</term> <listitem><para>Whether the toolbar, the sidebar, or the filter (People View only) are displayed in the main window is adjusted through the <guimenu>View</guimenu> menu. </para></listitem> </varlistentry> </variablelist> </sect1> <sect1 id="gramps-prefs-adv"> <title>Advanced manipulation of settings</title> <warning><para>The contents of this section is outside the scope of interest of a general user of &app;. If you proceed with tweaking the options on the low level you may damage your &app; installation. Be careful. YOU HAVE BEEN WARNED! </para></warning> <para>By default, &app; stores its settings using gconf2 system. All the settings used in this version of &app; are stored in subdirectories under <filename>/apps/gramps/</filename> in the gconf2 namespace. Accessing the keys can be done either using <command>gconftool-2</command> command line tool, or the <command>gconf-editor</command> GUI tool. </para> <para>All keys are documented, and the notification mechanisms are used as appropriate. Therefore, updating keys from outside of &app; should lead to updating &app; in real time, without necessarily restarting it.</para> </sect1> </chapter>