diff --git a/gramps/doc/gramps-manual/C/gramps-manual.sgml b/gramps/doc/gramps-manual/C/gramps-manual.sgml index 9db575b1e..9a9169d4c 100644 --- a/gramps/doc/gramps-manual/C/gramps-manual.sgml +++ b/gramps/doc/gramps-manual/C/gramps-manual.sgml @@ -7,7 +7,7 @@
- gramps User Manual + GRAMPS User Manual 2001 Donald N. Allingham @@ -80,7 +80,7 @@ - This is version 1.0 of the gramps manual. + This is version 1.0 of the GRAMPS manual. @@ -91,7 +91,7 @@ Introduction - gramps is an acronym for the + GRAMPS is an acronym for the Genealogical Research and Analysis Management Programming System. It was conceived under the concept that most genealogy programs were designed to provide the researcher the capability to input @@ -106,11 +106,11 @@ being researched. Various other enhancements may also be provided in the genealogical program that allows for different degrees 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 programs, but, more importantly, to provide a capability not 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 (in any order or sequence) to assist the user in doing research, analysis and correlation with the potential of filling @@ -120,7 +120,7 @@ instead of pencils and unmanageable reams of paper. - To run gramps, select + To run GRAMPS, select Programs Applications @@ -131,7 +131,7 @@ This document describes version &version; of - gramps. + GRAMPS. @@ -139,10 +139,10 @@ - Running gramps for the first time. + Running GRAMPS for the first time. The first time you run the program, - gramps will display its Getting Started + GRAMPS will display its Getting Started screens.
@@ -173,14 +173,14 @@ Getting Started - Starting gramps opens the + Starting GRAMPS opens the Main window, shown in . The window is at first empty.
- gramps Main Window + GRAMPS Main Window - gramps Main Window + GRAMPS Main Window @@ -189,7 +189,7 @@ Importing data 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 File Import Import from GEDCOM . The GEDCOM @@ -211,13 +211,13 @@ Entering Data 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 - away. From the main window click the Add + GEDCOM file to import, you can start creating your database + right away. From the main window click the Add Person button and the Edit - Person dialog will open. Start entering in the - information you have on the first person. Start with their - general information (Name, Birth and Death Date/Place) and then - move on to the Names, + Person dialog will open. Enter in the information + you have on the first person. Start with their general + information (Name, Birth and Death Date/Place) and then move on + to the Names, Events, Attributes, Addresses, Notes, @@ -262,11 +262,11 @@ Selecting and Editing Individuals - The People View lists the individuals in the database. An in - dividual can be selected as the active person by clicking on an - entry in the list. Once a person has been selected as the active - person, the person's name appears in the status bar in the lower - left hand corner of the window. + The People View lists the individuals in the database. An + individual can be selected as the active person by clicking on + an entry in the list. Once a person has been selected as the + active person, the person's name appears in the status bar in + the lower left hand corner of the window. Once the active person has been selected, pressing the @@ -296,7 +296,7 @@ Applying Filters - gramps allows you to apply filters to + GRAMPS allows you to apply filters to the People View. When a filter is applied, the People View will only display the entries matching the filter. All of the entries remain in the database, but are temporarily hidden. @@ -309,7 +309,7 @@ information for the filter. Many filters do not require the qualifier, and it will be grayed out if not needed. The third part of the filter is the invert selection. When this option is - selected, gramps will display the + selected, GRAMPS will display the entries that do not match the filter. @@ -324,7 +324,7 @@ Four columns are shown in the People View display. The entries in the list can be sorted by three of the fields: Name, Birth 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 order. @@ -332,8 +332,8 @@ If the list is already sorted by a particular column, clicking on the same column label will switch sorting order. For example, if the list is currently sorted in ascending order by - Name, clicking on the Name column header will resort the list in - descending order. + Name, clicking on the Name column header will re-sort the list + in descending order. @@ -374,10 +374,10 @@
- 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 - names. Examples would be a person changing his or her name due - to marriage or adoption. gramps + names. An example would be a person changing his or her name due + to marriage or adoption. GRAMPS allows multiple alternate names to be specified for each person. @@ -394,9 +394,9 @@ The Events tab allows information about various events in a person's life to be - recorded. gramps provides a list of + recorded. GRAMPS provides a list of common events, but allows you to name an event anything that you - want. + choose. An event consists of a name of an event (such as "Baptism" or @@ -412,10 +412,10 @@ to limit information provided to others. - gramps allows you to specify your + GRAMPS allows you to specify your confidence in the information you have. By default, a confidence 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 information. For example, if Aunt Martha thinks that her grandmother was born in a particular year, you may wish to mark @@ -491,8 +491,8 @@ Addresses are used to record information about where a person has lived. Addresses are different from - gramps' concept of a place. A address - as gramps sees it consists of an + GRAMPS' concept of a place. A address + as GRAMPS sees it consists of an equivalent of a mailing address and the date or date range when the person lived at the address. @@ -531,7 +531,7 @@ Notes Tab In addition to the notes that may be attached to any particular - event, attribute, or address, gramps + event, attribute, or address, GRAMPS has a generic note attached to the person.
@@ -556,13 +556,13 @@ PNG. - gramps can either refer to an + GRAMPS can either refer to an existing file, or make its own copy. By default, - gramps will make its own copy. There + GRAMPS will make its own copy. There are advantages and disadvatages to both approaches. Refering to an external copy reduces disk space. Allowing - gramps to make its own copy - eliminates allows gramps to still have the image if the orignal + GRAMPS to make its own copy + eliminates allows GRAMPS to still have the image if the orignal is altered, deleted, or moved. It also simplifies the transfer of a database from one machine to another. @@ -583,10 +583,10 @@ Prmimary button. Images may be added by clicking the Add button, and deleted by clicking the Delete button. If the image is a - reference to another file, gramps + reference to another file, GRAMPS will remove the reference to the file. If the file is a copy - maintained by gramps, then - gramps will remove the file from the + maintained by GRAMPS, then + GRAMPS will remove the file from the file system. @@ -626,8 +626,8 @@ This option is only displayed if the image is a reference to a file that is not controlled by - gramps. Selecting the option - causes gramps to make its own + GRAMPS. Selecting the option + causes GRAMPS to make its own copy of the image. @@ -662,7 +662,7 @@ Clicking on the internet address displayed at the top part of - the window will cause gramps to attempt + the window will cause GRAMPS to attempt to display the site using the GNOME default browser. @@ -710,7 +710,7 @@ On the right hand side of the window displays the parents of the active person. By default, a birth relationship is - assumed. gramps supports multiple + assumed. GRAMPS supports multiple family relationships for each person. For example, a person may have natural birth parents and adopted parents. In this case, an option menu will appear below the parents names, allowing you to @@ -819,13 +819,13 @@ - - Pedegree View + + Pedigree View - 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 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 View @@ -833,10 +833,10 @@ entry from the menus. -
- Pedegree View +
+ Pedigree View - Pedegree View + Pedigree View @@ -854,11 +854,11 @@ ways. Clicking on the arrow next to the active person will display a menu listing the children of the active person. Selecting a 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 the left side of the screen will make the select either the active 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 the button on the left hand side of the screen will not appear. Similarly, if the active person does have a father or @@ -941,14 +941,14 @@ Bookmarking People - gramps supports two mechanisms to + GRAMPS supports two mechanisms to quickly find people - the home person and bookmarks. Home Person The home person is the default person of the database. Upon - loading the database, gramps will set + loading the database, GRAMPS will set the active person to the default person. At any time, clicking the Home button will return the active person to the home person. @@ -1043,7 +1043,7 @@
The General Preferences tab contains basic information to - control the operation of gramps. + control the operation of GRAMPS. General Preferences options @@ -1060,10 +1060,10 @@ Do not compress XML data file - gramps normally compresses its + GRAMPS normally compresses its data file to conserve disk space. If you do not which to have the file compressed, selecting this option will cause - gramps to leave the file + GRAMPS to leave the file uncompressed. This may be desirable if other applications need to process the generated XML file. @@ -1080,11 +1080,11 @@ - Display gramps ID in list + Display GRAMPS ID in list This will add a new column to the Person View with the - Gramps ID for each individual. + GRAMPS ID for each individual. @@ -1137,7 +1137,7 @@ Numerical date formats can be ambiguous. Some people enter the day, month, and year (European style), while others prefer month, day, year (American style). Selecting the - option here informs gramps how + option here informs GRAMPS how it should interpret numerical dates. @@ -1178,7 +1178,7 @@ (3) preferences you can chose from. The first is Active person's name only - this will display the active person's 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 ). The last option is Active person's name and attribute - this is just like the second option but shows the @@ -1213,7 +1213,7 @@
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 GEDCOM files as being the researcher/author of the file) @@ -1229,7 +1229,7 @@
- Many of the reports that gramps + Many of the reports that GRAMPS produces can be generated in different file formats and different paper sizes. Selecting a Preferred Output Format and a Preferred Output @@ -1260,7 +1260,7 @@ Generating Reports - gramps can produce a wide variety of + GRAMPS can produce a wide variety of reports. New report generators can be written by the user without modifying the main program. For this reason, there may be more reports available than are documented by this manual @@ -1274,9 +1274,9 @@
- Unlike many genealogy programs, gramps + Unlike many genealogy programs, GRAMPS does not directly print reports. Instead, - gramps produces reports in formats that + GRAMPS produces reports in formats that are understood by other programs. These formats include OpenOffice, AbiWord, PDF, and HTML, among others. This allows the 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 face, size, color, and options) for each Paragraph Style along 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 choose the options (if any for that specific report) and then Choose the Templete (for HTML format only) and click OK. Your @@ -1313,7 +1313,7 @@ option of modifying hundreds of files by hand. - To solve this problem, gramps allows + To solve this problem, GRAMPS allows the user to specify a template to be used for generating HTML 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 @@ -1321,26 +1321,26 @@ different template may be chosen each time, allowing the user to change the appearence of the generated files at any time. Nearly any existing HTML file can be used as an HTML template - for gramps. + for GRAMPS. When a file has been established as the HTML template file, - gramps uses the template for each - file that it generates. gramps starts + GRAMPS uses the template for each + file that it generates. GRAMPS starts each file by copying data from the template until it reaches an HTML comment uses as a marker. At that point, - gramps inserts its data into the - output file. gramps the continues + GRAMPS inserts its data into the + output file. GRAMPS the continues reading the until it reaches a second comment that tells it to resume copying from the template. - gramps uses the string + GRAMPS uses the string <!-- START --> to indicate where it should start inserting its information, and the string <!-- STOP --> to indicate where it should resume copying data from the template. The effect is - that gramps will create a new + that GRAMPS will create a new document, replacing everything between the <!-- START --> and <!-- STOP --> comments with the report information. @@ -1352,7 +1352,7 @@ If no HTML template is specified, or if the specified template - cannot be read, gramps will use a + cannot be read, GRAMPS will use a default, predefined template.
@@ -1370,14 +1370,14 @@ This is a simple template. This text will appear in the html output. </P> <!-- START --> <P> -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, -will not appear in the gramps generated output. +will not appear in the GRAMPS generated output. </P> <!-- STOP --> <P> This text, since it appears after the stop comment, will also -appear in every gramps generated file. +appear in every GRAMPS generated file. </P> </BODY> </HTML> @@ -1391,7 +1391,7 @@ appear in every gramps generated file. Running Tools - gramps supports standard and user + GRAMPS supports standard and user written tools. These tools can operate on the database to perform a specified task. @@ -1464,10 +1464,10 @@ appear in every gramps generated file. - Reorder gramps ID's + Reorder GRAMPS ID's - Reorders the gramps ID's according to gramps' default rules. + Reorders the GRAMPS ID's according to GRAMPS' default rules. @@ -1508,10 +1508,10 @@ appear in every gramps generated file. Authors - gramps was written by Don Allingham + GRAMPS was written by Don Allingham (dallingham@users.sourceforge.net). To find more - information about gramps, please visit - the gramps + information about GRAMPS, please visit + the GRAMPS Web page. diff --git a/gramps/src/WriteXML.py b/gramps/src/WriteXML.py index f029b7bbe..c58c02640 100644 --- a/gramps/src/WriteXML.py +++ b/gramps/src/WriteXML.py @@ -213,6 +213,32 @@ def dump_name(g,label,name,index=1): g.write('%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): "Writes the location information to the output file" city = fix(loc.get_city()) @@ -234,6 +260,46 @@ def dump_location(g,loc): g.write(' country="%s"' % country) 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(' \n' % \ + (place.getId(),fix(title))) + if place.get_longitude() != "" or place.get_latitude() != "": + g.write(' \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(" \n") + for url in place.getUrlList(): + g.write(' \n') + if place.getNote() != "": + writeNote(g,"note",place.getNote(),3) + dump_source_ref(g,place.getSourceRef(),3) + g.write(" \n") + #------------------------------------------------------------------------- # # @@ -465,39 +531,7 @@ def exportData(database, filename, callback): if len(placeList) > 0: g.write(" \n") for place in placeList: - g.write(' \n' % \ - (place.getId(),fix(place.get_title()))) - if place.get_longitude() != "" or place.get_latitude() != "": - g.write(' \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(" \n") - if len(place.getUrlList()) > 0: - for url in place.getUrlList(): - g.write(' \n') - if place.getNote() != "": - writeNote(g,"note",place.getNote(),3) - dump_source_ref(g,place.getSourceRef(),3) - g.write(" \n") + write_place_obj(g,place) g.write(" \n") if len(database.getBookmarks()) > 0: diff --git a/gramps/src/gramps_main.py b/gramps/src/gramps_main.py index f0b5e862b..2b68d4ad2 100755 --- a/gramps/src/gramps_main.py +++ b/gramps/src/gramps_main.py @@ -998,7 +998,12 @@ def on_delete_place_clicked(obj): msg = t % (fname,e[0].getId(),e[1].getName()) textbox.insert_defaults(msg) - + else: + map = database.getPlaceMap() + del map[place.getId()] + utils.modified() + update_display(0) + #------------------------------------------------------------------------- # #