 |
Indexed GEDCOM Method
for Genweb Authoring |
 |
Try Worldconnect Instead...We host your database so you don't have to !!
FEATURES
-
Uses unmodified GEDCOM (users can't get entire GEDCOM file)
-
Fast. Optional DBM indexing speeds large database access.
-
Space efficient (space required is about 2-3x the GEDCOM file size vs. 5-6x
for most other methods)
-
Quick and easy updates when a newer GEDCOM is available
-
HTML files are created on-the-fly - no need for thousands of files.
-
Automatic logs each user access. Logs are automatically rolled when full.
-
Supports good research by including sources for all data when available
-
Every-surname index
-
Supports GenDex Indexing (master
name index of all genealogical databases on the Web)
-
Allows users to add links from your database to another - without your
intervention!
-
IGMPed - Generates pedigree
charts
-
IGMDesc - Generates
descendency charts
-
IGMGed - Allows users
to extract GEDCOM data starting from any individual
-
IGMSrch - Quick search
for names and/or places
-
IGMMak - Faster index
building
-
IGMLivng - Removal of
birth information for living individuals
-
Can be modified (knowledge of Perl required)
DESCRIPTION
The Indexed GEDCOM Method is simple to operate and to use. When a new or
updated GEDCOM is to be made available, the program IGMMak is run. This program
creates an index file as well as several HTML index files. This process takes
about 1-2 minutes to index a 7,000+ person GEDCOM file, although this may
vary based upon the system you are using.
Once the GEDCOM is indexed by IGMMak, users can access the automatically
generated HTML index files to find the person they are interested in. When
they request information on any person in the database, the HTML index instructs
the Web Server to run the IGMGet program. IGMGet opens the GEDCOM and goes
directly to the person directed. It then loads all of the information for
that person and his/her family, generates an HTML file, and sends it back
to the user.
The HTML files allow the user to search the database either by a range of
names, or by an every surname index. The user can also search names and places
with the IGMSrch program or the ENTIRE GEDCOM for any text with the program
IGMFind.
An added feature is the ability for users to submit 'links' to other databases
on the web for any individual. This is accomplished by the program IGMLink.
All of the scripts, IGMMak, IGMGet, IGMFind, IGMSrch, IGMLink, IGMPed, IGMDesc,
IGMGed, IGMLib, and IGMIni are written in the Perl programming language and
can be modified, provided that the original copyright information is not
removed or modified.
INSTALLATION
These instructions are very detailed to make it easy for a novice to install.
It really is easier than it looks at first glance.
-
Make sure your system has an http server (and not just an ftp server).
-
Make sure you have access to the cgi-bin directory on your system or a user
cgi-bin directory.
-
Make sure your system has Perl installed. To do this, type 'perl -v' from
the prompt. You'll either get information about the current version of Perl
or you'll get a message indicating that Perl was not found. You should also
type 'which perl' to find out the directory where perl lives.
-
Map out your directory structure on paper. This will help you with the
installation. My system is as follows:
-
Your web directory: /home/gumby/public_html
-
Your cgi-bin directory: /home/gumby/public_html/cgi-bin
-
Your GenWeb directory: /home/gumby/public_html/genweb
-
Your database directory: /home/gumby/public_html/genweb/Winch
I have referenced my directories listed above as examples in the steps below.
This should help you in determining exactly which directory the steps are
referring to.
-
Get the IGM Perl scripts.
-
Unpack the scripts. (pkunzip igm.zip).
-
Modify the first line of each script (except igmini and igmlib) and replace
the top line with the correct path for your perl.
-
Use an FTP program to place all of the IGM scripts (except IGMMake, IGMMak
and IGMLivng) in the cgi-bin directory [/home/gumby/public_html/cgi-bin].
Make sure that they are all set as executable programs (chmod a+x igmget,
etc.). You might need to rename the scripts so that your server can execute
them (igmget to igmget.cgi or igmget.pl).
-
Create your GenWeb directory [/home/gumby/public_html/genweb] under your
web directory [/home/gumby/public_html].
-
Place IGMMake, IGMMak, IGMLivng, photo.gif, and back.gif in your GenWeb directory
[/home/gumby/public_html/genweb]. Make sure that IGMMake, IGMMak and IGMLivng
are set as executable programs (chmod +x igmmak then chmod +x igmlivng).
-
Edit IGMIni and change all of the variables to match
your system configuration.
-
Under your genweb directory [/home/gumby/public_html/genweb], create your
database directory [/home/gumby/public_html/genweb/Winch]. It should have
the same name as the name of the GEDCOM that it will hold (Upper/lower case
is important). If you will be using the link functions, this directory needs
to be world writable (chmod a+w Winch).
-
Place your GEDCOM [Winch.ged] in your database directory
[/home/gumby/public_html/genweb/Winch].
-
Using Notepad or edit, create a two line file containing your name on line
1 and your email address on line 2. Place this file in your database directory
[/home/gumby/public_html/genweb/Winch].
-
Go to your GenWeb directory [/home/gumby/public_html/genweb].
-
[Optional] Run IGMLivng with the name of your database [IGMLivng Winch].
The program should begin running and should create a new GEDCOM file that
has the living people's birth information removed.
-
Run IGMMak with the name of your database [IGMMak Winch]. The program should
begin running and should create the index file and several html files.
-
[Optional] Add your database to Gendex.
-
[Optional] Add a link from your home page to the main index
[http://www.rootsweb.com/~gumby/genweb/Winch/Winch.html]
for your database.
-
Use any Web browser [Microsoft IE, Netscape, Mosaic, WinWeb, Lynx, etc.]
to access the main html for your database
[http://www.rootsweb.com/~gumby/genweb/Winch/Winch.html].
-
Access an individual in your database from the index.
-
If you want to add more databases, start with step #10 above.
-
If you want to update your database, start with step #11 above.
Original Programs © Copyright 1996 by Tim Doyle
<tdoyle@doit.com>
Some programs © Copyright 1996 by Randy Winch
<gumby@edge.net>