diff --git a/gramps/doc/gramps.1 b/gramps/doc/gramps.1 new file mode 100644 index 000000000..3b29e9c2c --- /dev/null +++ b/gramps/doc/gramps.1 @@ -0,0 +1,47 @@ +.TH "gramps" "1" "0.1.x" "Brandon L. Griffith" "" +.SH "NAME" +.LP +gramps \- Genealogical Research and Analysis Management Programming System +.SH "SYNTAX" +.LP +gramps [\fIno option\fP] +.br +Currently \fBgramps\fR does not accept any command line arguments +.SH "DESCRIPTION" +.LP +Gramps is an open source genealogy program. It is written in Python, using the GTK/GNOME interface. +.br +Gramps should seem familiar to anyone who has used other geneology programs before such as \fIFamily Tree Maker for Windows(TM)\fR or the GNU Geneweb. +.br +It supports importing of the ever popular GEDCOM format which is used world wide by almost all other geneology software. +.SH "Concepts" +Supports a python\-based plugin system, allowing import and export writers, report generators, tools, and display filters to be added without modification of the main program. +.LP +Data is stored in an gzip'ed XML format +.LP +Instead of generating direct printer output, report generators target other systems, such as \fIOpen Office\fR, \fIAbiWord\fR, HTML or LaTeX to allow the user to modify the format to suit his or her needs. +.SH "FILES" +.LP +\fI${PREFIX}/bin/gramps\fP +.br +\fI${PREFIX}/share/gramps\fP +.br +\fI${HOME}/.gramps\fP +.SH "Authors" +Donald Allingham \fI\fR +.br +\fIhttp://gramps.sourceforge.net\fR +.LP +This manpage was written by: +.br +Brandon L. Griffith \fI\fR +.br +Any ammendants or errors should be reported to him. +.br +It was originally written for inclusion in the Debian GNU/Linux system. +.SH "DOCUMENTATION" +See also the file \fBgramps.sgml\fR +.br +On a Debian system this can be found in \fI/usr/doc/gramps\fR +.br +Or in the doc directory of the official source distribution. diff --git a/gramps/doc/gramps.sgml b/gramps/doc/gramps.sgml index df6769982..d1cb5629a 100644 --- a/gramps/doc/gramps.sgml +++ b/gramps/doc/gramps.sgml @@ -2,7 +2,7 @@ - + ]> @@ -164,7 +164,6 @@ - @@ -175,47 +174,176 @@ This section describes basic usage of gramps. - - - - Person List - - Starting gramps opens the - Main window, shown in . The window is at first empty. - - -
- gramps Main Window - - gramps Main Window - - - -
- - - - - - Family View - - - - - - Pedegree View - - - - - - Entering data - - - + + Running gramps for the first time. + + This section should discuss the start up druid. + + + + + Main Window + + Starting gramps opens the + Main window, shown in . The window is at first empty. + + +
+ gramps Main Window + + gramps Main Window + + + +
+ + + + + + + Person List + + The Person List window is the initial view seen on the main + window. It displays the name, gender, birth date, and death + date of all individuals in the database. At any time, you can + return to the this view either by pressing the People button at + the top of the screen, or by choosing the + + View + Person List + + entry from the menus. + + + Selecting and Editing Individuals + + The Person List view lists the individuals in the database. A + 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 Edit + Person button will display the Edit Person dialog allowing you + to edit the individual's personal information. If the Edit + Person button is pressed without an active person being set, a + blank Edit Person dialog is presented, allowing you to enter a + new person. Double-clicking on a entry will set the active + person and bring up the individual in the Edit Person dialog. + + + Pressing the Add Person button will display a blank Edit Person + dialog, allowing you to add a new person to the database. + + + If the Delete Person button is pressed, the active person and + all of the personal information related to the active person are + removed from the database. + + + + Applying Filters + + gramps allows you to apply filters to + the Person List. When a filter is applied, the Person List will + only display the entries matching the filter. All of the entries + remain in the database, but are temporarily hidden. + + + There are three parts to a filter. The first part is the + selection of the filter to be applied. A filter is selected from + the option menu directly above the Person List. The second part + is an option qualifier. This qualifier provides more specific + 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 + entries that do not match the filter. + + + A filter is not applied until the Apply button is pressed. The + filter will remain in effect until the next time the Apply + button is pressed. + + + + Sorting + + Four columns are shown in the Person List display. The entries in + the list can be sorted by three of the field: 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 indicate whether + the list is sort by ascending or descending order. + + + 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. + + + + + + + Family View + + The Family View window displays the spouses, parents, and children + of the active person. At any time, you can return to the this view + either by pressing the Family button at the top of the screen, or + by choosing the + + View + Family View + + entry from the menus. + + + This section should describe the family view. + + + + + Pedegree View + + The Pedegree 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 screen, or + by choosing the + + View + Pedgree + + entry from the menus. + + + This section should describe the pedegree view. + + + + + Source List + + The Source List window displays the different sources which have been + entered into the database. At any time, you can return to the this view + either by pressing the Sources button at the top of the screen, or + by choosing the + + View + Sources + + entry from the menus. + + + This section should describe the source list. + + @@ -519,22 +647,48 @@ def need_qualifier():
Sample report implementation -"Category/report name" +import intl +_ = intl.gettext def report(database,person): ... actual code ... def get_description(): - return "A detailed text description of what the report generator does" + return "A detailed text description of what the report generator does" + +def get_name(): + return _("Category/report name") def get_xpm_image(): - return [ - "... XPM image data" - ] + return [ + "... XPM image data" + ]
- + + A little help - Format Interfaces + + gramps provides some help with writing + reports. Several generic python classes exist that aid in the + writing of report generators. These classes provide an abstract + interface for a type of document, such as a drawing, word + processor document, or a spreadsheet. From these core classes, + gramps derives interfaces to various + document formats. This means that by coding to the generic word + processing class (TextDoc), a report + generator can instant access to multiple file formats (such as + HTML, OpenOffice, and AbiWord). + + + This scheme of deriving a output format from a generic base class + also makes it easier to add new formats. Creating a new + derivied class targeting a different format (such as + KWord or + LaTeX) makes it easy for existing + report generators to use the new formats. + + @@ -640,4 +794,3 @@ def get_xpm_image(): -