svn: r5582
This commit is contained in:
Don Allingham 2005-12-19 05:01:05 +00:00
parent 1c5ad3f57f
commit 4482378716

View File

@ -967,18 +967,15 @@
<note id="alt-add-image"> <note id="alt-add-image">
<title>Alternate way of adding images to galleries</title> <title>Alternate way of adding images to galleries</title>
<para> <para>
An image can always be added to any gallery by using An image can always be added to any gallery by using
drag-and-drop. Items can be dragged from the Media View, any drag-and-drop. Items can be dragged from the Media View, any
gallery, the desktop, the file manager or a web browser and gallery, the desktop, the file manager or a web browser and
dropped on the target gallery, adding the image to the dropped on the target gallery, adding the image to the
gallery. gallery.
</para> </para>
</note> </note>
<para> <para>
In any gallery, you can also use the In any gallery, you can also use the
<guibutton>Edit</guibutton> to edit image information and the <guibutton>Edit</guibutton> to edit image information and the
<guibutton>-</guibutton> button and to remove the image <guibutton>-</guibutton> button and to remove the image
@ -988,7 +985,6 @@
<note id="remove-image-from-gallery"> <note id="remove-image-from-gallery">
<title>Removing an image from a gallery</title> <title>Removing an image from a gallery</title>
<para> <para>
In all galleries, removing the reference to the image does In all galleries, removing the reference to the image does
not remove the image from the database, but just from the not remove the image from the database, but just from the
gallery. To completely remove the image from the database, gallery. To completely remove the image from the database,
@ -1028,29 +1024,41 @@
<sect1 id="gramps-edit-complete"> <sect1 id="gramps-edit-complete">
<title>Editing Data: Complete Description</title> <title>Editing Data: Complete Description</title>
<para> <para>
This section provides a complete description of all editing The previous section offered you a quick overview of how to enter
options for all pieces of data in the &app; database. It refers and edit data in GRAMPS. This section continues that discussion in
mainly to the menu items and buttons as the main way of much greater detail.
interacting with &app;. In addition to this, &app; provides an </para><para>
extensive set of keybindings. The detailed reference to the As we have seen above, GRAMPS offers you a series of Views. Each
keybindings is found in the <xref linkend="append-keybind"/>. of these Views gives you opportunities to enter and edit
information. In fact, you can often get to the same information
from different Views.
</para><para>
In GRAMPS, information is entered and edited through what we call
dialogs. Since we use that term frequently, we should define what
we mean by it:
</para><para>
A dialog is a pop-up window that provides one or more forms for
entering and editing data that fits a certain category. Examples
in GRAMPS include the Edit Person dialog and the
Marriage/Relationship dialog, among many others.
</para><para>
A dialog often includes a series of &quot;notebook tabs&quot; that
group the information into subcategories. For example, the Edit
Person dialog has notebook tabs for subcategories such as Events,
Attributes, Addresses, and Notes, among others.
</para> </para>
<note id="edit-button-note"> <note id="edit-button-note">
<title>Add, Remove, and Edit buttons</title> <title>Add, Remove, and Edit buttons</title>
<para> <para>
In order to save precious screen space, most of the In most cases, GRAMPS uses a <guibutton>+</guibutton> to
<guibutton>Add</guibutton>, <guibutton>Remove</guibutton>, correspond to <guibutton>Add</guibutton>, a
and <guibutton>Edit</guibutton> buttons no longer are labeled <guibutton>-</guibutton> correspond to
with text. Instead, the first two use <guibutton>Remove</guibutton>, and an icon of a pen on a sheet
<guibutton>+</guibutton> and <guibutton>-</guibutton> icons, of paper to denote <guibutton>Edit</guibutton>. We will continue
and the third uses the icon depicting a pen on top of a paper referring to the latter as the <guibutton>Edit</guibutton>
sheet. button, while using <guibutton>+</guibutton> and
</para> <guibutton>-</guibutton> to denote the two former buttons.
<para>
Reference the latter as the
<guibutton>Edit</guibutton> button, while using
<guibutton>+</guibutton> and <guibutton>-</guibutton> to
denote the former two buttons.
</para> </para>
</note> </note>
@ -1131,41 +1139,38 @@
<!-- ==== End of Figure ==== --> <!-- ==== End of Figure ==== -->
<para> <para>
The top of the window shows the name of the person whose
data is being edited. The main part of the window displays The top of the window shows the name of the person whose data is
ten notebook tabs containing different categories of being edited. Below this name are ten &quot;notebook tabs&quot;
available information. You can bring any tab to the top for containing different categories of available information. Click
viewing or editing by clicking on the appropriate tab any tab to view and edit its contents. Clicking the
heading. The bottom part has <guibutton>OK</guibutton> and <guibutton>OK</guibutton> button at the bottom will apply all
<guibutton>Cancel</guibutton> buttons. Clicking the the changes made in all tabs and close the dialog
<guibutton>OK</guibutton> button at any time will apply all window. Clicking the <guibutton>Cancel</guibutton> button will
the changes made in all tabs and close the dialog close the window without applying any changes. If any data in
window. Clicking the <guibutton>Cancel</guibutton> button at any tabs were modified, an alert window will appear, prompting
any time will close the window without applying any you to choose from the following options: close the dialog
changes. If any of the data in any tab were modified, the without saving changes, cancel the initial cancel request, or
alert window will appear with the choices of closing the save the changes.
dialog without saving changes, canceling the initial cancel
request, or saving the changes.
</para> </para>
<note> <note>
<para> <para>
Clicking <guibutton>OK</guibutton> will immediately save Clicking <guibutton>OK</guibutton> will immediately save
changes to the database (write on disk). This version of changes to the database. There is no need for a Save
&app; does not have a separate saving function, all operation, since all changes are immediate.
changes are immediate.
</para> </para>
</note> </note>
<tip> <tip>
<para> <para>
The tab labels reflect the presence of corresponding If a tab label is in boldface type, this means it contains
information: if the tab contains any data, its label data. If not, it has no data.
appears boldface; if the tab has no data then its label
appears regular (not bold).
</para> </para>
</tip> </tip>
<para> <para>
The tabs provide the following information categories of The tabs provide the following information categories of
personal data: personal data:
</para> </para>
<variablelist> <variablelist>
<varlistentry> <varlistentry>
@ -1174,50 +1179,52 @@
</term> </term>
<listitem> <listitem>
<para> <para>
The <guilabel>General</guilabel> tab allows editing of The <guilabel>General</guilabel> tab contains general
general information about the person. This includes information about the person. This includes
the text entry fields of <guilabel>Given <guilabel>Given name</guilabel>, <guilabel>Family
name</guilabel>, <guilabel>Family name</guilabel>, name</guilabel>, <guilabel>Family prefix</guilabel> (such
<guilabel>Family prefix</guilabel> (such as de or as &quot;de&quot; or &quot;van&quot;),
van), <guilabel>Suffix</guilabel> (e.g. Jr. or III), <guilabel>Suffix</guilabel> (e.g. Jr. or III),
<guilabel>Title</guilabel> (e.g. Dr. or Rev.), <guilabel>Title</guilabel> (e.g. Dr. or Rev.),
<guilabel>Nickname</guilabel> (Bob for Robert), <guilabel>Nickname</guilabel> (Bob for Robert),
<guilabel>Type</guilabel> of the name (birth name, <guilabel>Type</guilabel> of the name (birth name, married
married name, etc.) and <guilabel>Date</guilabel> and name, etc.) and <guilabel>Date</guilabel> and
<guilabel>Place</guilabel> of birth and death. Some of <guilabel>Place</guilabel> of birth and death. Some of
these (<guilabel>Family name</guilabel>, these (<guilabel>Family name</guilabel>,
<guilabel>Type</guilabel>, and both <guilabel>Type</guilabel>, and both
<guilabel>Place</guilabel> fields), also provide <guilabel>Place</guilabel> fields), also provide
autocompletion feature: as you type in these fields, &quot;autocompletion&quot; feature: as you type in these
the menu is displayed below the field with the fields, the menu is displayed below the field with the
available entries from the database that are available entries from the database that match your
compatible with your partial input. This allows for a partial input. This gives you a shortcut by letting you
quick selection of an available entry by selecting it select an entry that already exists in the database rather
from the menu, either using the mouse or arrows and than having to type it all out. You can select the entry
<keycap>Enter</keycap> key. using your mouse or using your arrow and
<keycap>Enter</keycap> keys.
</para> </para>
<para> <para>
The <guilabel>Edit</guilabel> button located by the The <guilabel>Edit</guilabel> (that is, the &quot;pen and
<guilabel>Family name</guilabel> entry allows editing paper&quot; icon) next to the <guilabel>Family
the preferred name in complete detail, by invoking name</guilabel> entry field invokes the <guilabel>Name
the <guilabel>Name Editor</guilabel> dialog (see Editor</guilabel> dialog. This dialog allows editing the
<xref linkend="adv-an"/>). preferred name in full detail (see <xref
linkend="adv-an"/>).
</para> </para>
<para> <para>
The <guilabel>Gender</guilabel> radio buttons offer the The <guilabel>Gender</guilabel> radio buttons offer the
choice of person's gender between choice of person's gender :
<guilabel>male</guilabel>, <guilabel>female</guilabel>, <guilabel>male</guilabel>, <guilabel>female</guilabel>,
and <guilabel>unknown</guilabel>. Clicking the colored and <guilabel>unknown</guilabel>. Clicking the colored
circle buttons (green, yellow, or red, also called LED &quot;LED&quot;
buttons) located next to the birth and death Date fields buttons located next to the birth and death Date fields
will bring up the <guilabel>Date Selection</guilabel> will bring up the <guilabel>Date Selection</guilabel>
dialog allowing detailed modification of the date, see dialog allowing detailed modification of the date, see
<xref linkend="adv-dates"/>. Clicking either <xref linkend="adv-dates"/>. Clicking either the
<guibutton>Edit</guibutton> button located next to the <guibutton>Edit</guibutton> button located next to the
birth and death LED buttons will bring up a dialog birth and death LED buttons will bring up a dialog
allowing you to edit the corresponding event (birth or allowing you to edit the birth or
death) details, see <xref linkend="adv-ev"/>. The field death details (see <xref linkend="adv-ev"/>). The field
<guilabel>ID</guilabel> displays an internal &app; ID <guilabel>ID</guilabel> displays an &app; ID
number which identifies the user in the database. The number which identifies the user in the database. The
<guilabel>Image</guilabel> area shows the first image <guilabel>Image</guilabel> area shows the first image
available in the <guilabel>Gallery</guilabel> of this available in the <guilabel>Gallery</guilabel> of this
@ -1226,9 +1233,9 @@
<para> <para>
Finally, the <guilabel>Information is Finally, the <guilabel>Information is
complete</guilabel> and <guilabel>Information is complete</guilabel> and <guilabel>Information is
private</guilabel> check buttons provides the way to private</guilabel> check buttons let you mark whether
mark whether this person's record is complete or not and or not the person's record is complete and
whether it is a private record. whether or not the record is private.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1238,10 +1245,27 @@
<term> <term>
<guilabel>Names</guilabel> <guilabel>Names</guilabel>
</term> </term>
<listitem>
<!-- ==== Figure: Edit Person dialog - Names ==== --> <!-- ==== Figure: Edit Person dialog - Names ==== -->
<listitem>
<para>
The <guilabel>Names</guilabel> tab displays information
concerning alternate names of the person and the controls
allowing their modification. The bottom part displays the
list of all alternate names of the person stored in the
database. The top part shows the details of the currently
selected name in the list (if any). The buttons
<guibutton>+</guibutton>, <guibutton>Edit</guibutton>, and
<guibutton>-</guibutton> allow the addition, modification,
and removal of an alternate name record from the database.
Note that the <guibutton>Edit</guibutton> and
<guibutton>-</guibutton> buttons become available only
when an alternate name is selected from the list.
</para>
<figure id="edit-pers-names-fig"> <figure id="edit-pers-names-fig">
<title>Edit Person dialog - Names</title> <title>Edit Person dialog - Names</title>
<screenshot> <screenshot>
@ -1259,22 +1283,6 @@
<!-- ==== End of Figure ==== --> <!-- ==== End of Figure ==== -->
<para>
The <guilabel>Names</guilabel> tab displays information
concerning alternate names of the person and the
controls allowing their modification. The bottom part
displays the list of all alternate names of the person
stored in the database. The top part shows the details
of the currently selected name in the list (if any). The
buttons <guibutton>+</guibutton>,
<guibutton>Edit</guibutton>, and
<guibutton>-</guibutton> allow the addition,
modification, and removal of an alternate name record
from the database. Note that the
<guibutton>Edit</guibutton> and <guibutton>-</guibutton>
buttons become available only when an alternate name is
selected from the list.
</para>
</listitem> </listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>