* doc/gramps-manual/C/gramps-manual.xml: Update manual. * doc/gramps-manual/C/filtref.xml: Add file -- split appendix into a separate file. * doc/gramps-manual/C/cmdline.xml: Likewise. * doc/gramps-manual/C/getstart.xml: Likewise. * doc/gramps-manual/C/mainwin.xml: Likewise. * doc/gramps-manual/C/usage.xml: Likewise. * doc/gramps-manual/C/custom.xml: Likewise. * doc/gramps-manual/C/Makefile.am: Ship new files. * doc/gramps-manual/C/Makefile.in: Likewise. svn: r2157
		
			
				
	
	
		
			372 lines
		
	
	
		
			13 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
			
		
		
	
	
			372 lines
		
	
	
		
			13 KiB
		
	
	
	
		
			XML
		
	
	
	
	
	
<?xml version="1.0" encoding="UTF-8"?>
 | 
						|
 | 
						|
<!-- ================ Customization ================================ -->
 | 
						|
 | 
						|
  <sect1 id="gramps-prefs"> 
 | 
						|
    <title>Settings</title> 
 | 
						|
    <para>To configure &app;, choose 
 | 
						|
      <menuchoice><guimenu>Settings</guimenu>
 | 
						|
      <guimenuitem>Preferences...</guimenuitem></menuchoice>. 
 | 
						|
      The <guilabel>Preferences</guilabel> dialog contains the following 
 | 
						|
      categories: </para>
 | 
						|
      
 | 
						|
      <itemizedlist>
 | 
						|
      <listitem><para><xref linkend="gramps-prefs-usage"/></para></listitem>
 | 
						|
      <listitem><para><xref linkend="gramps-prefs-display"/></para></listitem>
 | 
						|
      <listitem><para><xref linkend="gramps-prefs-db"/></para></listitem>
 | 
						|
      </itemizedlist>
 | 
						|
 | 
						|
<!-- =============== Customization Subsection ================ -->
 | 
						|
    <sect2 id="gramps-prefs-usage"> 
 | 
						|
      <title>Usage</title> 
 | 
						|
	<para> This category contains preferences relevant to the 
 | 
						|
	general usage of &app;. It has the following subcategories:</para>
 | 
						|
 | 
						|
  <!-- =============== Customization Sub-subsection ================ -->
 | 
						|
      <sect3 id="prefs-usage-find"> 
 | 
						|
        <title>Find</title> 
 | 
						|
 | 
						|
	<variablelist>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Enable autocompletion</guilabel></term>
 | 
						|
	<listitem><para>If this box is checked, &app; will attempt to complete
 | 
						|
	the text as you type it into text entry fields such as family name,
 | 
						|
	place of birth, etc. Completion is attempted based on the match 
 | 
						|
	between the beginning of the text being typed and the corresponding 
 | 
						|
	data already stored in the database. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	</variablelist>
 | 
						|
 | 
						|
      </sect3>
 | 
						|
 | 
						|
  <!-- =============== Customization Sub-subsection ================ -->
 | 
						|
      <sect3 id="prefs-usage-report"> 
 | 
						|
        <title>Report Preferences</title> 
 | 
						|
 | 
						|
	<variablelist>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Preferred text format</guilabel></term>
 | 
						|
	<listitem><para> Select the preferred format for text reports 
 | 
						|
	from the available formats listed in this menu. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Preferred graphical format</guilabel></term>
 | 
						|
	<listitem><para> Select the preferred format for graphical reports 
 | 
						|
	from the available formats listed in this menu.
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Preferred paper size</guilabel></term>
 | 
						|
	<listitem><para> Select the preferred paper size used for reports 
 | 
						|
	from the available sizes listed in this menu.
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Default report directory</guilabel></term>
 | 
						|
	<listitem><para> Choose the default directory for the reports using the 
 | 
						|
	<guibutton>Browse...</guibutton> button or type it in the text entry
 | 
						|
	field. </para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Default web site directory</guilabel></term>
 | 
						|
	<listitem><para> Choose the default directory for the web site using the 
 | 
						|
	<guibutton>Browse...</guibutton> button or type it in the text entry
 | 
						|
	field. </para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	</variablelist>
 | 
						|
 | 
						|
      </sect3>
 | 
						|
 | 
						|
  <!-- =============== Customization Sub-subsection ================ -->
 | 
						|
      <sect3 id="prefs-usage-res"> 
 | 
						|
        <title>Researcher Information</title> 
 | 
						|
 | 
						|
	<variablelist>
 | 
						|
 | 
						|
	<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>
 | 
						|
 | 
						|
      </sect3>
 | 
						|
 | 
						|
  <!-- =============== Customization Sub-subsection ================ -->
 | 
						|
      <sect3 id="prefs-usage-guess"> 
 | 
						|
        <title>Data Guessing</title> 
 | 
						|
 | 
						|
	<variablelist>
 | 
						|
	
 | 
						|
	<varlistentry><term><guilabel>Surname guessing</guilabel></term>
 | 
						|
	<listitem><para> This option is not currently implemented. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	</variablelist>
 | 
						|
 | 
						|
      </sect3>
 | 
						|
 | 
						|
    </sect2>
 | 
						|
 | 
						|
<!-- =============== Customization Subsection ================ -->
 | 
						|
    <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>
 | 
						|
 | 
						|
  <!-- =============== Customization Sub-subsection ================ -->
 | 
						|
      <sect3 id="prefs-display-gen"> 
 | 
						|
        <title>General</title> 
 | 
						|
 | 
						|
	<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>Show index numbers in child list</guilabel></term>
 | 
						|
	<listitem><para> 
 | 
						|
	This option is not currently implemented.
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	</variablelist>
 | 
						|
      </sect3>
 | 
						|
 | 
						|
  <!-- =============== Customization Sub-subsection ================ -->
 | 
						|
      <sect3 id="prefs-display-date"> 
 | 
						|
        <title>Dates and Calendar</title> 
 | 
						|
 | 
						|
	<variablelist>
 | 
						|
	
 | 
						|
	<varlistentry><term><guilabel>Display: Date format</guilabel></term>
 | 
						|
	<listitem><para> Select the display format for the dates
 | 
						|
	from the available formats listed in this menu. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Name format</guilabel></term>
 | 
						|
	<listitem><para> Select the display format for the names  
 | 
						|
	from the available formats listed in this menu. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Entry: Date format</guilabel></term>
 | 
						|
	<listitem><para> Select the entry format for the dates
 | 
						|
	from the available formats listed in this menu. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Show calendar format selection menu</guilabel></term>
 | 
						|
	<listitem><para> Check this box to enable the calendar format selection 
 | 
						|
	menu when you are entering dates in the <guilabel>Event 
 | 
						|
	Editor</guilabel> dialog. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	</variablelist>
 | 
						|
      </sect3>
 | 
						|
 | 
						|
  <!-- =============== Customization Sub-subsection ================ -->
 | 
						|
      <sect3 id="prefs-display-bars"> 
 | 
						|
        <title>Toolbar and Statusbar</title> 
 | 
						|
	<variablelist>
 | 
						|
	
 | 
						|
	<varlistentry><term><guilabel>Toolbar</guilabel></term>
 | 
						|
	<listitem><para> Select the desired appearance of the toolbar icons
 | 
						|
	using the radio buttons. 
 | 
						|
	</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>
 | 
						|
      </sect3>
 | 
						|
 | 
						|
    </sect2>
 | 
						|
 | 
						|
<!-- =============== Customization Subsection ================ -->
 | 
						|
    <sect2 id="gramps-prefs-db"> 
 | 
						|
      <title>Database</title> 
 | 
						|
	<para> This category contains preferences relevant to the 
 | 
						|
	database itself. It has the following subcategories: </para>
 | 
						|
 | 
						|
  <!-- =============== Customization Sub-subsection ================ -->
 | 
						|
      <sect3 id="prefs-db-gen"> 
 | 
						|
        <title>General</title> 
 | 
						|
 | 
						|
	<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>Do not compress XML data file</guilabel></term>
 | 
						|
	<listitem><para> Check this box to disable compression of the XML
 | 
						|
	data file. Compression significantly reduces the file size. While it 
 | 
						|
	creates an overhead in performance (some processor cycles must be spent
 | 
						|
	to decompress the file before use), this overhead is extremely small. 
 | 
						|
	Now that the compression-related bugs have long been fixed, there is 
 | 
						|
	virtually no reason to disable data file compression. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Capitalize surnames</guilabel></term>
 | 
						|
	<listitem><para> Check this box to capitalize surnames entered into the
 | 
						|
	database. </para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Autosave interval</guilabel></term>
 | 
						|
	<listitem><para> Set the interval (in minutes) after which &app; will
 | 
						|
	automatically save your database. Setting the interval to zero (0) 
 | 
						|
	disables autosaving. </para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Default database directory</guilabel></term>
 | 
						|
	<listitem><para> Choose the default directory in which &app; starts
 | 
						|
	looking when saving the database using the <guibutton>Browse...</guibutton> 
 | 
						|
	or type its path into the text entry field. </para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	</variablelist>
 | 
						|
      </sect3>
 | 
						|
 | 
						|
  <!-- =============== Customization Sub-subsection ================ -->
 | 
						|
      <sect3 id="prefs-db-media"> 
 | 
						|
        <title>Media Objects</title> 
 | 
						|
 | 
						|
	<para>Before describing preferences for media objects, let us
 | 
						|
	review the background on local and non-local objects. A local object 
 | 
						|
	is the object whose file is stored inside the same directory in which 
 | 
						|
	the &app; database file resides. A non-local object is stored 
 | 
						|
	elsewhere, so that the database has only the reference to the file's 
 | 
						|
	location and some records of the object's properties. </para>
 | 
						|
	
 | 
						|
	<para>You may choose to store your media objects either locally 
 | 
						|
	or externally. Making your objects local will increase the amount 
 | 
						|
	of disk space consumed by the &app; database directory. However, 
 | 
						|
	if the external file is deleted or removed, &app; will still be able 
 | 
						|
	to use the local copy. In contrast, leaving your objects non-local 
 | 
						|
	will decrease the disk space requirements. However, losing the 
 | 
						|
	original file will render your media object unusable.
 | 
						|
	</para>
 | 
						|
	
 | 
						|
	<para>Note that exporting your database to any format will compile
 | 
						|
	all medial objects, no matter whether they are local or not. 
 | 
						|
	Specifically, export to gramps package will include all the media 
 | 
						|
	object files in the package and change the references accordingly. 
 | 
						|
	Export to CD will copy all media object files to the directory under 
 | 
						|
	the <guilabel>burn:///</guilabel> location in Nautilus and change the 
 | 
						|
	references accordingly. Finally, export to GEDCOM will place all 
 | 
						|
	media object files next to the GEDCOM file with the appropriate 
 | 
						|
	changes in the path names. 
 | 
						|
	</para>
 | 
						|
	
 | 
						|
	<variablelist>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Drag and drop from an external 
 | 
						|
	source</guilabel></term>
 | 
						|
	<listitem><para> Choose between a reference and a local copy made when
 | 
						|
	the object is dropped into the gallery. The reference saves disk 
 | 
						|
	space as it does not copy the object. The local copy makes your 
 | 
						|
	database portable as it does not depend on an external file. Consult
 | 
						|
	your needs to make best choice.</para> 
 | 
						|
	
 | 
						|
	<para>Check the <guilabel>Display global properties editor when 
 | 
						|
	object is dropped</guilabel> box to invoke the global properties 
 | 
						|
	editor after you drop an external object into the gallery. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Drag and drop from an internal 
 | 
						|
	source</guilabel></term>
 | 
						|
	<listitem><para> Check the <guilabel>Display local properties editor 
 | 
						|
	when object is dropped</guilabel> box to invoke the local properties 
 | 
						|
	editor after you drop an internal object into the gallery. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	</variablelist>
 | 
						|
      </sect3>
 | 
						|
 | 
						|
  <!-- =============== Customization Sub-subsection ================ -->
 | 
						|
      <sect3 id="prefs-db-id"> 
 | 
						|
        <title>&app; internal IDs</title> 
 | 
						|
 | 
						|
	<variablelist>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel> GRAMPS ID prefixes</guilabel></term>
 | 
						|
	<listitem><para> Enter ID prefixes for various kinds of database 
 | 
						|
	entries into the corresponding text entry fields. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Allow internal GRAMPS ID numbers to be
 | 
						|
	edited</guilabel></term>
 | 
						|
	<listitem><para> Check this box to enable editing of the internal &app;
 | 
						|
	ID numbers. Unless you know what you are doing, leave it unchecked.
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	</variablelist>
 | 
						|
      </sect3>
 | 
						|
 | 
						|
  <!-- =============== Customization Sub-subsection ================ -->
 | 
						|
      <sect3 id="prefs-db-rcs"> 
 | 
						|
        <title>Revision Control</title> 
 | 
						|
 | 
						|
	<variablelist>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Use revision control</guilabel></term>
 | 
						|
	<listitem><para> Check this box to enable &app; to use the revision control
 | 
						|
	system for your database. If you choose this option, select the
 | 
						|
	particular revision control system from the menu. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	<varlistentry><term><guilabel>Prompt for comment on save</guilabel></term>
 | 
						|
	<listitem><para> Check this box to instruct &app; to prompt you to enter
 | 
						|
	the comment when you save the database. 
 | 
						|
	</para></listitem>
 | 
						|
	</varlistentry>
 | 
						|
 | 
						|
	</variablelist>
 | 
						|
 | 
						|
      </sect3>
 | 
						|
 | 
						|
    </sect2>
 | 
						|
 | 
						|
  </sect1> <!-- ================ End Customization ================== -->
 |