Cyclone-Team/gramps
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Fixed delete place problem when no references are used.

Browse Source 
svn: r409
This commit is contained in:
Don Allingham 2001-09-17 02:42:57 +00:00
parent d6d24d4169
commit d217a04c3f
3 changed files with 165 additions and 126 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

184
gramps/doc/gramps-manual/C/gramps-manual.sgml
View File

@ -7,7 +7,7 @@
<article id="index"> <!-- please do not change the id --> <article id="index"> <!-- please do not change the id -->
<artheader> <artheader>
<title>gramps User Manual</title> <title>GRAMPS User Manual</title>
<copyright> <copyright>
<year>2001</year> <year>2001</year>
<holder>Donald N. Allingham</holder> <holder>Donald N. Allingham</holder>
@ -80,7 +80,7 @@
<!-- This is the manual version, not application version. --> <!-- This is the manual version, not application version. -->
<releaseinfo> <releaseinfo>
This is version 1.0 of the gramps manual. This is version 1.0 of the GRAMPS manual.
</releaseinfo> </releaseinfo>
</artheader> </artheader>
@ -91,7 +91,7 @@
<sect1 id="intro"> <sect1 id="intro">
<title>Introduction</title> <title>Introduction</title>
<para> <para>
<application>gramps</application> is an acronym for the <application>GRAMPS</application> is an acronym for the
Genealogical Research and Analysis Management Programming System. Genealogical Research and Analysis Management Programming System.
It was conceived under the concept that most genealogy programs It was conceived under the concept that most genealogy programs
were designed to provide the researcher the capability to input were designed to provide the researcher the capability to input
@ -106,11 +106,11 @@
being researched. Various other enhancements may also be provided being researched. Various other enhancements may also be provided
in the genealogical program that allows for different degrees of in the genealogical program that allows for different degrees of
importing and exporting data from other programs and printing of importing and exporting data from other programs and printing of
the data contained in the various reports. gramps, on the other the data contained in the various reports. GRAMPS, on the other
hand, attempts to provide all of the common capabilities of these hand, attempts to provide all of the common capabilities of these
programs, but, more importantly, to provide a capability not programs, but, more importantly, to provide a capability not
common to these programs. This is the ability to input any bits common to these programs. This is the ability to input any bits
and pieces of information directly into gramps and and pieces of information directly into GRAMPS and
rearrange/manipulate any/all data events in the entire data base rearrange/manipulate any/all data events in the entire data base
(in any order or sequence) to assist the user in doing research, (in any order or sequence) to assist the user in doing research,
analysis and correlation with the potential of filling analysis and correlation with the potential of filling
@ -120,7 +120,7 @@
instead of pencils and unmanageable reams of paper. instead of pencils and unmanageable reams of paper.
</para> </para>
<para> <para>
To run <application>gramps</application>, select To run <application>GRAMPS</application>, select
<menuchoice> <menuchoice>
<guisubmenu>Programs</guisubmenu> <guisubmenu>Programs</guisubmenu>
<guisubmenu>Applications</guisubmenu> <guisubmenu>Applications</guisubmenu>
@ -131,7 +131,7 @@
</para> </para>
<para> <para>
This document describes version &version; of This document describes version &version; of
<application>gramps</application>. <application>GRAMPS</application>.
</para> </para>
</sect1> </sect1>
@ -139,10 +139,10 @@
<!-- This section should describe basic usage of the application. --> <!-- This section should describe basic usage of the application. -->
<sect1 id="firsttime"> <sect1 id="firsttime">
<title>Running gramps for the first time.</title> <title>Running GRAMPS for the first time.</title>
<para> <para>
The first time you run the program, The first time you run the program,
<application>gramps</application> will display its Getting Started <application>GRAMPS</application> will display its Getting Started
screens. screens.
</para> </para>
<figure id="druidpg1"> <figure id="druidpg1">
@ -173,14 +173,14 @@
<sect1 id="gettingstarted"> <sect1 id="gettingstarted">
<title>Getting Started</title> <title>Getting Started</title>
<para> <para>
Starting <application>gramps</application> opens the Starting <application>GRAMPS</application> opens the
<interface>Main window</interface>, shown in <xref <interface>Main window</interface>, shown in <xref
linkend="mainwindow-fig">. The window is at first empty. linkend="mainwindow-fig">. The window is at first empty.
</para> </para>
<figure id="mainwindow-fig"> <figure id="mainwindow-fig">
<title>gramps Main Window</title> <title>GRAMPS Main Window</title>
<screenshot> <screenshot>
<screeninfo>gramps Main Window</screeninfo> <screeninfo>GRAMPS Main Window</screeninfo>
<graphic fileref="mainwin" format="png" srccredit="Don Allingham"> <graphic fileref="mainwin" format="png" srccredit="Don Allingham">
</graphic> </graphic>
</screenshot> </screenshot>
@ -189,7 +189,7 @@
<title>Importing data</title> <title>Importing data</title>
<para> <para>
If you already have a family file created using another If you already have a family file created using another
genealogy program you can import your GEDCOM file into Gramps. genealogy program you can import your GEDCOM file into GRAMPS.
To do this you select <menuchoice> <guimenu>File</guimenu> To do this you select <menuchoice> <guimenu>File</guimenu>
<guisubmenu>Import</guisubmenu> <guimenuitem>Import from <guisubmenu>Import</guisubmenu> <guimenuitem>Import from
GEDCOM</guimenuitem> </menuchoice>. The <interface>GEDCOM GEDCOM</guimenuitem> </menuchoice>. The <interface>GEDCOM
@ -211,13 +211,13 @@
<title>Entering Data</title> <title>Entering Data</title>
<para> <para>
If you have never used a genealogy program or you do not have a If you have never used a genealogy program or you do not have a
GEDCOM file to import you can start creating your database right GEDCOM file to import, you can start creating your database
away. From the main window click the <guibutton>Add right away. From the main window click the <guibutton>Add
Person</guibutton> button and the <interface>Edit Person</guibutton> button and the <interface>Edit
Person</interface> dialog will open. Start entering in the Person</interface> dialog will open. Enter in the information
information you have on the first person. Start with their you have on the first person. Start with their general
general information (Name, Birth and Death Date/Place) and then information (Name, Birth and Death Date/Place) and then move on
move on to the <interface>Names</interface>, to the <interface>Names</interface>,
<interface>Events</interface>, <interface>Events</interface>,
<interface>Attributes</interface>, <interface>Attributes</interface>,
<interface>Addresses</interface>, <interface>Notes</interface>, <interface>Addresses</interface>, <interface>Notes</interface>,
@ -262,11 +262,11 @@
<sect2 id="seleditindv"> <sect2 id="seleditindv">
<title>Selecting and Editing Individuals</title> <title>Selecting and Editing Individuals</title>
<para> <para>
The People View lists the individuals in the database. An in The People View lists the individuals in the database. An
dividual can be selected as the active person by clicking on an individual can be selected as the active person by clicking on
entry in the list. Once a person has been selected as the active an entry in the list. Once a person has been selected as the
person, the person's name appears in the status bar in the lower active person, the person's name appears in the status bar in
left hand corner of the window. the lower left hand corner of the window.
</para> </para>
<para> <para>
Once the active person has been selected, pressing the Once the active person has been selected, pressing the
@ -296,7 +296,7 @@
<sect2> <sect2>
<title>Applying Filters</title> <title>Applying Filters</title>
<para> <para>
<application>gramps</application> allows you to apply filters to <application>GRAMPS</application> allows you to apply filters to
the People View. When a filter is applied, the People View will the People View. When a filter is applied, the People View will
only display the entries matching the filter. All of the entries only display the entries matching the filter. All of the entries
remain in the database, but are temporarily hidden. remain in the database, but are temporarily hidden.
@ -309,7 +309,7 @@
information for the filter. Many filters do not require the information for the filter. Many filters do not require the
qualifier, and it will be grayed out if not needed. The third qualifier, and it will be grayed out if not needed. The third
part of the filter is the invert selection. When this option is part of the filter is the invert selection. When this option is
selected, <application>gramps</application> will display the selected, <application>GRAMPS</application> will display the
entries that do not match the filter. entries that do not match the filter.
</para> </para>
<para> <para>
@ -324,7 +324,7 @@
Four columns are shown in the People View display. The entries Four columns are shown in the People View display. The entries
in the list can be sorted by three of the fields: Name, Birth in the list can be sorted by three of the fields: Name, Birth
Date, or Death Date. Clicking on the column label will cause Date, or Death Date. Clicking on the column label will cause
the list to be resorted by that column. Arrows on the label the list to be re-sorted by that column. Arrows on the label
indicate whether the list is sort by ascending or descending indicate whether the list is sort by ascending or descending
order. order.
</para> </para>
@ -332,8 +332,8 @@
If the list is already sorted by a particular column, clicking If the list is already sorted by a particular column, clicking
on the same column label will switch sorting order. For on the same column label will switch sorting order. For
example, if the list is currently sorted in ascending order by example, if the list is currently sorted in ascending order by
Name, clicking on the Name column header will resort the list in Name, clicking on the Name column header will re-sort the list
descending order. in descending order.
</para> </para>
</sect2> </sect2>
</sect1> </sect1>
@ -374,10 +374,10 @@
</screenshot> </screenshot>
</figure> </figure>
<para> <para>
Its possible for people to use more than one name during their It is possible for people to use more than one name during their
lifetime. These may be legal names changes, or just informal lifetime. These may be legal names changes, or just informal
names. Examples would be a person changing his or her name due names. An example would be a person changing his or her name due
to marriage or adoption. <application>gramps</application> to marriage or adoption. <application>GRAMPS</application>
allows multiple alternate names to be specified for each person. allows multiple alternate names to be specified for each person.
</para> </para>
<para> <para>
@ -394,9 +394,9 @@
<para> <para>
The <interface>Events</interface> tab allows information about The <interface>Events</interface> tab allows information about
various events in a person's life to be various events in a person's life to be
recorded. <application>gramps</application> provides a list of recorded. <application>GRAMPS</application> provides a list of
common events, but allows you to name an event anything that you common events, but allows you to name an event anything that you
want. choose.
</para> </para>
<para> <para>
An event consists of a name of an event (such as "Baptism" or An event consists of a name of an event (such as "Baptism" or
@ -412,10 +412,10 @@
to limit information provided to others. to limit information provided to others.
</para> </para>
<para> <para>
<application>gramps</application> allows you to specify your <application>GRAMPS</application> allows you to specify your
confidence in the information you have. By default, a confidence confidence in the information you have. By default, a confidence
level of "Normal" is associated with each event. This can be level of "Normal" is associated with each event. This can be
changed either up ("High" or "Very High") or down ("Low" or increased ("High" or "Very High") or decreased ("Low" or
"Very Low") to indicate the confidence you have in the "Very Low") to indicate the confidence you have in the
information. For example, if Aunt Martha thinks that her information. For example, if Aunt Martha thinks that her
grandmother was born in a particular year, you may wish to mark grandmother was born in a particular year, you may wish to mark
@ -491,8 +491,8 @@
<para> <para>
Addresses are used to record information about where a person Addresses are used to record information about where a person
has lived. Addresses are different from has lived. Addresses are different from
<application>gramps'</application> concept of a place. A address <application>GRAMPS'</application> concept of a place. A address
as <application>gramps</application> sees it consists of an as <application>GRAMPS</application> sees it consists of an
equivalent of a mailing address and the date or date range when equivalent of a mailing address and the date or date range when
the person lived at the address. the person lived at the address.
</para> </para>
@ -531,7 +531,7 @@
<title>Notes Tab</title> <title>Notes Tab</title>
<para> <para>
In addition to the notes that may be attached to any particular In addition to the notes that may be attached to any particular
event, attribute, or address, <application>gramps</application> event, attribute, or address, <application>GRAMPS</application>
has a generic note attached to the person. has a generic note attached to the person.
</para> </para>
<figure id="ep_notes-fig"> <figure id="ep_notes-fig">
@ -556,13 +556,13 @@
PNG. PNG.
</para> </para>
<para> <para>
<application>gramps</application> can either refer to an <application>GRAMPS</application> can either refer to an
existing file, or make its own copy. By default, existing file, or make its own copy. By default,
<application>gramps</application> will make its own copy. There <application>GRAMPS</application> will make its own copy. There
are advantages and disadvatages to both approaches. Refering to are advantages and disadvatages to both approaches. Refering to
an external copy reduces disk space. Allowing an external copy reduces disk space. Allowing
<application>gramps</application> to make its own copy <application>GRAMPS</application> to make its own copy
eliminates allows gramps to still have the image if the orignal eliminates allows GRAMPS to still have the image if the orignal
is altered, deleted, or moved. It also simplifies the transfer is altered, deleted, or moved. It also simplifies the transfer
of a database from one machine to another. of a database from one machine to another.
</para> </para>
@ -583,10 +583,10 @@
Prmimary</guibutton> button. Images may be added by clicking the Prmimary</guibutton> button. Images may be added by clicking the
<guibutton>Add</guibutton> button, and deleted by clicking the <guibutton>Add</guibutton> button, and deleted by clicking the
<guibutton>Delete</guibutton> button. If the image is a <guibutton>Delete</guibutton> button. If the image is a
reference to another file, <application>gramps</application> reference to another file, <application>GRAMPS</application>
will remove the reference to the file. If the file is a copy will remove the reference to the file. If the file is a copy
maintained by <application>gramps</application>, then maintained by <application>GRAMPS</application>, then
<application>gramps</application> will remove the file from the <application>GRAMPS</application> will remove the file from the
file system. file system.
</para> </para>
<para> <para>
@ -626,8 +626,8 @@
<para> <para>
This option is only displayed if the image is a reference This option is only displayed if the image is a reference
to a file that is not controlled by to a file that is not controlled by
<application>gramps</application>. Selecting the option <application>GRAMPS</application>. Selecting the option
causes <application>gramps</application> to make its own causes <application>GRAMPS</application> to make its own
copy of the image. copy of the image.
</para> </para>
</listitem> </listitem>
@ -662,7 +662,7 @@
</para> </para>
<para> <para>
Clicking on the internet address displayed at the top part of Clicking on the internet address displayed at the top part of
the window will cause <application>gramps</application> to attempt the window will cause <application>GRAMPS</application> to attempt
to display the site using the GNOME default browser. to display the site using the GNOME default browser.
</para> </para>
<para> <para>
@ -710,7 +710,7 @@
<para> <para>
On the right hand side of the window displays the parents of the On the right hand side of the window displays the parents of the
active person. By default, a birth relationship is active person. By default, a birth relationship is
assumed. <application>gramps</application> supports multiple assumed. <application>GRAMPS</application> supports multiple
family relationships for each person. For example, a person may family relationships for each person. For example, a person may
have natural birth parents and adopted parents. In this case, an have natural birth parents and adopted parents. In this case, an
option menu will appear below the parents names, allowing you to option menu will appear below the parents names, allowing you to
@ -819,13 +819,13 @@
</para> </para>
</sect2> </sect2>
</sect1> </sect1>
<sect1 id="pedegreeview"> <sect1 id="pedigreeview">
<title>Pedegree View</title> <title>Pedigree View</title>
<para> <para>
The Pedegree View window displays the active person, the active The Pedigree View window displays the active person, the active
person's parents, and the active parent's grandparents in a person's parents, and the active parent's grandparents in a
somewhat graphical manner. At any time, you can return to the this somewhat graphical manner. At any time, you can return to the this
view either by pressing the Pedegree button at the top of the view either by pressing the Pedigree button at the top of the
screen, or by choosing the screen, or by choosing the
<menuchoice> <menuchoice>
<guimenu>View</guimenu> <guimenu>View</guimenu>
@ -833,10 +833,10 @@
</menuchoice> </menuchoice>
entry from the menus. entry from the menus.
</para> </para>
<figure id="pedegreeview-fig"> <figure id="pedigreeview-fig">
<title>Pedegree View</title> <title>Pedigree View</title>
<screenshot> <screenshot>
<screeninfo>Pedegree View</screeninfo> <screeninfo>Pedigree View</screeninfo>
<graphic fileref="pedegreeview" format="png" srccredit="Don Allingham"> <graphic fileref="pedegreeview" format="png" srccredit="Don Allingham">
</graphic> </graphic>
</screenshot> </screenshot>
@ -854,11 +854,11 @@
ways. Clicking on the arrow next to the active person will display ways. Clicking on the arrow next to the active person will display
a menu listing the children of the active person. Selecting a a menu listing the children of the active person. Selecting a
person from this list will change the active person to the person from this list will change the active person to the
selected child, effectively shifting the pedegree view to the selected child, effectively shifting the pedigree view to the
left, or down one generation. Clicking one of the arrow buttons on left, or down one generation. Clicking one of the arrow buttons on
the left side of the screen will make the select either the active the left side of the screen will make the select either the active
person's father (top button) or mother (bottom button), person's father (top button) or mother (bottom button),
effectively shifting the pedegree view to the right, or up one effectively shifting the pedigree view to the right, or up one
generation. If the active person does not have any children, then generation. If the active person does not have any children, then
the button on the left hand side of the screen will not the button on the left hand side of the screen will not
appear. Similarly, if the active person does have a father or appear. Similarly, if the active person does have a father or
@ -941,14 +941,14 @@
<sect1 id="bookmarks"> <sect1 id="bookmarks">
<title>Bookmarking People</title> <title>Bookmarking People</title>
<para> <para>
<application>gramps</application> supports two mechanisms to <application>GRAMPS</application> supports two mechanisms to
quickly find people - the home person and bookmarks. quickly find people - the home person and bookmarks.
</para> </para>
<sect2 id="homeperson"> <sect2 id="homeperson">
<title>Home Person</title> <title>Home Person</title>
<para> <para>
The home person is the default person of the database. Upon The home person is the default person of the database. Upon
loading the database, <application>gramps</application> will set loading the database, <application>GRAMPS</application> will set
the active person to the default person. At any time, clicking the active person to the default person. At any time, clicking
the <guibutton>Home</guibutton> button will return the active the <guibutton>Home</guibutton> button will return the active
person to the home person. person to the home person.
@ -1043,7 +1043,7 @@
</figure> </figure>
<para> <para>
The General Preferences tab contains basic information to The General Preferences tab contains basic information to
control the operation of <application>gramps</application>. control the operation of <application>GRAMPS</application>.
</para> </para>
<variablelist> <variablelist>
<title>General Preferences options</title> <title>General Preferences options</title>
@ -1060,10 +1060,10 @@
<term><guilabel>Do not compress XML data file</guilabel></term> <term><guilabel>Do not compress XML data file</guilabel></term>
<listitem> <listitem>
<para> <para>
<application>gramps</application> normally compresses its <application>GRAMPS</application> normally compresses its
data file to conserve disk space. If you do not which to data file to conserve disk space. If you do not which to
have the file compressed, selecting this option will cause have the file compressed, selecting this option will cause
<application>gramps</application> to leave the file <application>GRAMPS</application> to leave the file
uncompressed. This may be desirable if other applications uncompressed. This may be desirable if other applications
need to process the generated XML file. need to process the generated XML file.
</para> </para>
@ -1080,11 +1080,11 @@
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term><guilabel>Display gramps ID in list</guilabel></term> <term><guilabel>Display GRAMPS ID in list</guilabel></term>
<listitem> <listitem>
<para> <para>
This will add a new column to the Person View with the This will add a new column to the Person View with the
Gramps ID for each individual. GRAMPS ID for each individual.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1137,7 +1137,7 @@
Numerical date formats can be ambiguous. Some people enter Numerical date formats can be ambiguous. Some people enter
the day, month, and year (European style), while others the day, month, and year (European style), while others
prefer month, day, year (American style). Selecting the prefer month, day, year (American style). Selecting the
option here informs <application>gramps</application> how option here informs <application>GRAMPS</application> how
it should interpret numerical dates. it should interpret numerical dates.
</para> </para>
</listitem> </listitem>
@ -1178,7 +1178,7 @@
(3) preferences you can chose from. The first is Active (3) preferences you can chose from. The first is Active
person's name only - this will display the active person's person's name only - this will display the active person's
name only in the status bar. The second is Active name only in the status bar. The second is Active
person's name and gramps ID - This will display the name person's name and GRAMPS ID - This will display the name
and ID for the active person ( [I9] Edwin Michael Smith ). and ID for the active person ( [I9] Edwin Michael Smith ).
The last option is Active person's name and attribute - The last option is Active person's name and attribute -
this is just like the second option but shows the this is just like the second option but shows the
@ -1213,7 +1213,7 @@
</figure> </figure>
<para> <para>
This is where you are able to change the information you entered This is where you are able to change the information you entered
when you started gramps for the first time and was asked to when you started GRAMPS for the first time and was asked to
enter in some information. (This information shows up in your enter in some information. (This information shows up in your
GEDCOM files as being the researcher/author of the file) GEDCOM files as being the researcher/author of the file)
</para> </para>
@ -1229,7 +1229,7 @@
</screenshot> </screenshot>
</figure> </figure>
<para> <para>
Many of the reports that <application>gramps</application> Many of the reports that <application>GRAMPS</application>
produces can be generated in different file formats and produces can be generated in different file formats and
different paper sizes. Selecting a <guilabel>Preferred Output different paper sizes. Selecting a <guilabel>Preferred Output
Format</guilabel> and a <guilabel>Preferred Output Format</guilabel> and a <guilabel>Preferred Output
@ -1260,7 +1260,7 @@
<sect1 id="genreports"> <sect1 id="genreports">
<title>Generating Reports</title> <title>Generating Reports</title>
<para> <para>
<application>gramps</application> can produce a wide variety of <application>GRAMPS</application> can produce a wide variety of
reports. New report generators can be written by the user without reports. New report generators can be written by the user without
modifying the main program. For this reason, there may be more modifying the main program. For this reason, there may be more
reports available than are documented by this manual reports available than are documented by this manual
@ -1274,9 +1274,9 @@
</screenshot> </screenshot>
</figure> </figure>
<para> <para>
Unlike many genealogy programs, <application>gramps</application> Unlike many genealogy programs, <application>GRAMPS</application>
does not directly print reports. Instead, does not directly print reports. Instead,
<application>gramps</application> produces reports in formats that <application>GRAMPS</application> produces reports in formats that
are understood by other programs. These formats include are understood by other programs. These formats include
OpenOffice, AbiWord, PDF, and HTML, among others. This allows the OpenOffice, AbiWord, PDF, and HTML, among others. This allows the
generated reports to be modified after they are generated, stored generated reports to be modified after they are generated, stored
@ -1295,7 +1295,7 @@
Selecting one of those options you can then change the font (font Selecting one of those options you can then change the font (font
face, size, color, and options) for each Paragraph Style along face, size, color, and options) for each Paragraph Style along
with the Paragraph Options (Alignment, background color, margins, with the Paragraph Options (Alignment, background color, margins,
and morders). Once you are satisfied with the style you are ready and dorders). Once you are satisfied with the style you are ready
to proceed with the generation of your report. The next step is to proceed with the generation of your report. The next step is
to choose the options (if any for that specific report) and then to choose the options (if any for that specific report) and then
Choose the Templete (for HTML format only) and click OK. Your Choose the Templete (for HTML format only) and click OK. Your
@ -1313,7 +1313,7 @@
option of modifying hundreds of files by hand. option of modifying hundreds of files by hand.
</para> </para>
<para> <para>
To solve this problem, <application>gramps</application> allows To solve this problem, <application>GRAMPS</application> allows
the user to specify a template to be used for generating HTML the user to specify a template to be used for generating HTML
files. At the time the report is generated, if HTML is selected files. At the time the report is generated, if HTML is selected
as the target format, the user can select an HTML template to be as the target format, the user can select an HTML template to be
@ -1321,26 +1321,26 @@
different template may be chosen each time, allowing the user to different template may be chosen each time, allowing the user to
change the appearence of the generated files at any time. change the appearence of the generated files at any time.
Nearly any existing HTML file can be used as an HTML template Nearly any existing HTML file can be used as an HTML template
for <application>gramps</application>. for <application>GRAMPS</application>.
</para> </para>
<para> <para>
When a file has been established as the HTML template file, When a file has been established as the HTML template file,
<application>gramps</application> uses the template for each <application>GRAMPS</application> uses the template for each
file that it generates. <application>gramps</application> starts file that it generates. <application>GRAMPS</application> starts
each file by copying data from the template until it reaches an each file by copying data from the template until it reaches an
HTML comment uses as a marker. At that point, HTML comment uses as a marker. At that point,
<application>gramps</application> inserts its data into the <application>GRAMPS</application> inserts its data into the
output file. <application>gramps</application> the continues output file. <application>GRAMPS</application> the continues
reading the until it reaches a second comment that tells it to reading the until it reaches a second comment that tells it to
resume copying from the template. resume copying from the template.
</para> </para>
<para> <para>
<application>gramps</application> uses the string <application>GRAMPS</application> uses the string
<function>&lt;!-- START --&gt;</function> to indicate where it <function>&lt;!-- START --&gt;</function> to indicate where it
should start inserting its information, and the string should start inserting its information, and the string
<function>&lt;!-- STOP --&gt;</function> to indicate where it <function>&lt;!-- STOP --&gt;</function> to indicate where it
should resume copying data from the template. The effect is should resume copying data from the template. The effect is
that <application>gramps</application> will create a new that <application>GRAMPS</application> will create a new
document, replacing everything between the <function>&lt;!-- document, replacing everything between the <function>&lt;!--
START --&gt;</function> and <function>&lt;!-- STOP START --&gt;</function> and <function>&lt;!-- STOP
--&gt;</function> comments with the report information. --&gt;</function> comments with the report information.
@ -1352,7 +1352,7 @@
</para> </para>
<para> <para>
If no HTML template is specified, or if the specified template If no HTML template is specified, or if the specified template
cannot be read, <application>gramps</application> will use a cannot be read, <application>GRAMPS</application> will use a
default, predefined template. default, predefined template.
</para> </para>
<figure id="templateexample"> <figure id="templateexample">
@ -1370,14 +1370,14 @@ This is a simple template. This text will appear in the html output.
&lt;/P&gt; &lt;/P&gt;
&lt;!-- START --&gt; &lt;!-- START --&gt;
&lt;P&gt; &lt;P&gt;
This is where gramps will place its report information. Any This is where GRAMPS will place its report information. Any
information between the two comments, including this paragraph, information between the two comments, including this paragraph,
will not appear in the gramps generated output. will not appear in the GRAMPS generated output.
&lt;/P&gt; &lt;/P&gt;
&lt;!-- STOP --&gt; &lt;!-- STOP --&gt;
&lt;P&gt; &lt;P&gt;
This text, since it appears after the stop comment, will also This text, since it appears after the stop comment, will also
appear in every gramps generated file. appear in every GRAMPS generated file.
&lt;/P&gt; &lt;/P&gt;
&lt;/BODY&gt; &lt;/BODY&gt;
&lt;/HTML&gt; &lt;/HTML&gt;
@ -1391,7 +1391,7 @@ appear in every gramps generated file.
<sect1 id="runtools"> <sect1 id="runtools">
<title>Running Tools</title> <title>Running Tools</title>
<para> <para>
<application>gramps</application> supports standard and user <application>GRAMPS</application> supports standard and user
written tools. These tools can operate on the database to perform written tools. These tools can operate on the database to perform
a specified task. a specified task.
</para> </para>
@ -1464,10 +1464,10 @@ appear in every gramps generated file.
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry> <varlistentry>
<term>Reorder gramps ID's</term> <term>Reorder GRAMPS ID's</term>
<listitem> <listitem>
<para> <para>
Reorders the gramps ID's according to gramps' default rules. Reorders the GRAMPS ID's according to GRAMPS' default rules.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -1508,10 +1508,10 @@ appear in every gramps generated file.
<sect1 id="authors"> <sect1 id="authors">
<title>Authors</title> <title>Authors</title>
<para> <para>
<application>gramps</application> was written by Don Allingham <application>GRAMPS</application> was written by Don Allingham
(<email>dallingham@users.sourceforge.net</email>). To find more (<email>dallingham@users.sourceforge.net</email>). To find more
information about <application>gramps</application>, please visit information about <application>GRAMPS</application>, please visit
the <ulink url="http://gramps.sourceforge.net" type="http">gramps the <ulink url="http://gramps.sourceforge.net" type="http">GRAMPS
Web page</ulink>. Web page</ulink>.
</para> </para>
<para> <para>

100
gramps/src/WriteXML.py
View File

@ -213,6 +213,32 @@ def dump_name(g,label,name,index=1):
g.write('%s</%s>\n' % (sp,label)) g.write('%s</%s>\n' % (sp,label))
def append_value(orig,val):
if orig:
return "%s, %s" % (orig,val)
else:
return val
def build_place_title(loc):
"Builds a title from a location"
city = fix(loc.get_city())
state = fix(loc.get_state())
country = fix(loc.get_country())
county = fix(loc.get_county())
value = ""
if city:
value = city
if county:
value = append_value(value,county)
if state:
value = append_value(value,state)
if country:
value = append_value(value,country)
return value
def dump_location(g,loc): def dump_location(g,loc):
"Writes the location information to the output file" "Writes the location information to the output file"
city = fix(loc.get_city()) city = fix(loc.get_city())
@ -234,6 +260,46 @@ def dump_location(g,loc):
g.write(' country="%s"' % country) g.write(' country="%s"' % country)
g.write('/>\n') g.write('/>\n')
def write_place_obj(g,place):
title = place.get_title()
if title == "":
title = build_place_title(place.get_main_location())
g.write(' <placeobj id="%s" title="%s">\n' % \
(place.getId(),fix(title)))
if place.get_longitude() != "" or place.get_latitude() != "":
g.write(' <coord long="%s" lat=%s"/>\n' % \
(fix(place.get_longitude()),fix(place.get_latitude())))
dump_location(g,place.get_main_location())
for loc in place.get_alternate_locations():
dump_location(g,loc)
for photo in place.getPhotoList():
path = photo.getPath()
l = len(fileroot)
if len(path) >= l:
if fileroot == path[0:l]:
path = path[l+1:]
g.write(" <img src=\"" + fix(path) + "\"")
g.write(" description=\"" + fix(photo.getDescription()) + "\"")
proplist = photo.getPropertyList()
if proplist:
for key in proplist.keys():
g.write(' %s="%s"' % (key,fix(proplist[key])))
g.write("/>\n")
for url in place.getUrlList():
g.write(' <url href="%s"' % fix(url.get_path()))
if url.getPrivacy() == 1:
g.write(' priv="1"')
if url.get_description() != "":
g.write(' description="%s"' % fix(url.get_description()))
g.write('/>\n')
if place.getNote() != "":
writeNote(g,"note",place.getNote(),3)
dump_source_ref(g,place.getSourceRef(),3)
g.write(" </placeobj>\n")
#------------------------------------------------------------------------- #-------------------------------------------------------------------------
# #
# #
@ -465,39 +531,7 @@ def exportData(database, filename, callback):
if len(placeList) > 0: if len(placeList) > 0:
g.write(" <places>\n") g.write(" <places>\n")
for place in placeList: for place in placeList:
g.write(' <placeobj id="%s" title="%s">\n' % \ write_place_obj(g,place)
(place.getId(),fix(place.get_title())))
if place.get_longitude() != "" or place.get_latitude() != "":
g.write(' <coord long="%s" lat=%s"/>\n' % \
(fix(place.get_longitude()),fix(place.get_latitude())))
dump_location(g,place.get_main_location())
for loc in place.get_alternate_locations():
dump_location(g,loc)
for photo in place.getPhotoList():
path = photo.getPath()
l = len(fileroot)
if len(path) >= l:
if fileroot == path[0:l]:
path = path[l+1:]
g.write(" <img src=\"" + fix(path) + "\"")
g.write(" description=\"" + fix(photo.getDescription()) + "\"")
proplist = photo.getPropertyList()
if proplist:
for key in proplist.keys():
g.write(' %s="%s"' % (key,fix(proplist[key])))
g.write("/>\n")
if len(place.getUrlList()) > 0:
for url in place.getUrlList():
g.write(' <url href="%s"' % fix(url.get_path()))
if url.getPrivacy() == 1:
g.write(' priv="1"')
if url.get_description() != "":
g.write(' description="%s"' % fix(url.get_description()))
g.write('/>\n')
if place.getNote() != "":
writeNote(g,"note",place.getNote(),3)
dump_source_ref(g,place.getSourceRef(),3)
g.write(" </placeobj>\n")
g.write(" </places>\n") g.write(" </places>\n")
if len(database.getBookmarks()) > 0: if len(database.getBookmarks()) > 0:

7
gramps/src/gramps_main.py
View File

@ -998,7 +998,12 @@ def on_delete_place_clicked(obj):
msg = t % (fname,e[0].getId(),e[1].getName()) msg = t % (fname,e[0].getId(),e[1].getName())
textbox.insert_defaults(msg) textbox.insert_defaults(msg)
else:
map = database.getPlaceMap()
del map[place.getId()]
utils.modified()
update_display(0)
#------------------------------------------------------------------------- #-------------------------------------------------------------------------
# #
# #