view release on metacpan or  search on metacpan

README  view on Meta::CPAN

    Note that the tree shows the "genetic" family tree. It contains no
    information about marriages and adaptation.

    For a demonstration of this software, visit
    http://www.ilab.sztaki.hu/~bodon/Simpsons/cgi/ftree.cgi or
    http://www.ilab.sztaki.hu/~bodon/ftree2/cgi/ftree.cgi.

    The program is written in Perl. It runs as a CGI program - its output
    is the HTML of the page that you see. The program reads in the data
    file, and analyzes the relationships to determine the ancestors,
    siblings and descendants of the person selected. HTML tables are
    generated to display these trees, linking in the portrait images where
    they exist.

INSTALLATION INSTRUCTIONS:

    1. Set up your web server (apache or IIS) so that it can run Perl
    scripts (e.g. mod-perl).

    2. Uncompress and copy the demo package (make sure that you reserve the
    rights, i.e. files with extension pm, gif, jpg, png, tif, csv, txt, xls
    must be readable, files with extension cgi and pl must be executable).

    3. Modify tree.xls so that it contains the details of your family. Tip:
    Select the second row, click on menu Window and select Freeze Panels.
    This will freeze the first row and you can see the title of columns.
    See format description below.

    4. Update the config/PerlSettingsImporter.pm file (you can specify the
    administrator's email, homepage, default language etc.).

    5. Copy the pictures of your family members to the pictures directory.

    6. That's it. Call the ftree.cgi script with no parameters to get your
    index page.

    7. If you are unhappy with the style and colors of the output then
    point the css_filename entry in PerlSettingsImporter.pm into your stly
    sheet.

INSTALLATION INSTRUCTIONS FOR XAMPP for Windows 5.6.12:

    Download I use xampp XAMPP for Windows 5.6.12
    (https://www.apachefriends.org/ru/download.html) to install and
    configure Apache

      <IfModule alias_module>
      ScriptAlias /cgi-bin/ "C:/xampp/cgi-bin/ftree/cgi/"
      </IfModule>
    
      <Directory "C:/xampp/cgi-bin/ftree/cgi">
      AllowOverride All
      Options None
      Require all granted
      </Directory>

    My shebang in ftree.cgi is #!"c:\Dwimperl\perl\bin\perl.exe" (by Gabor
    Sabo)

      copy c:\xampp\cgi-bin\ftree\graphics\
      to
      c:\xampp\htdocs\graphics\

    to correct show images

    I catch error couldn't create child process: 720002
    ------------------------ It was the first line in the .cgi file that
    needed to be adapted to Xamp's configuration:

      #!"c:\xampp\perl\bin\perl.exe"
      Instead of:
    
      #!"c:\perl\bin\perl.exe"

    https://forum.xojo.com/20697-couldn-t-create-child-process-720002-error-when-deploying-on-wi/0
    http://open-server.ru/forum/viewtopic.php?f=6&t=1059

NAME OF THE PICTURE:

      One picture may belong to each person.
      No image put here and name=id.jpg
      c:\xampp\cgi-bin\ftree\pictures\

DATAFILE FORMAT:

      The program can handle excel, csv (txt), gedcom, serialized files and can get data from database. Follow these rules to decide which one to use:
      1, Use gedcom if you already have your family tree data in a gedcom file and the fields that the program is able to import is sufficient.
      2, Use the excel format if you just started to build your family tree data.
      3, Convert your data file into serialized format if the data file contains many people (like some thousand) and you would like to reduce response time and memory need.
    
      Data format history:
      Originally the input file was a csv flat file with semicolon as the separator. It could store 6 fields for each person (name, father name, mother name, email, webpage, date of birth/death). As new fields were required (like gender, place of bir...
    
      We encourage everybody to use the excel format. To convert from the csv format to the excel format, use script script/convertFormat.pl
    
      TIP 1.: Maintain your family tree data in excel using the Form option. Select all the columns, then press DATA->Form. It is convenient to add new people or to modify information of existing persons.
      TIP 2.: Freeze the first line so that header does not disappear when scrolling down.

The excel format:

      The excel format is quite straightforward based on the example file. Each row (except the header) represents a person. The fields are:
       * ID: the ID of the person. It can be anything (like 123 or Bart_Simpson), but it should only contain alphanumeric characters and underscore (no whitespace is allowed).
       * title: like: Dr., Prof.
       * prefix: like: sir
       * first name
       * middle name
       * last Name
       * suffix: like: VIII
       * nickname
       * father's ID
       * mother's ID
       * email
       * webpage
       * date of birth: the format is day/month/year, like: 24/3/1977
       * date of death: the format is day/month/year, like: 24/3/1977
       * gender: 0 for male, 1 female
       * is living?: 0 for live 1 for dead
       * place of birth: the format is: "country" "city". The city part may be omitted. Quotation marks are mandatory.
       * place of death: the format is: "country" "city". The city part may be omitted. Quotation marks are mandatory.
       * cemetery: the format is: "country" "city" "cemetery", like: "USA" "Washington D.C." "Arlington National Cemetery"
       * schools: use comma as separator, like: Harward, MIT
       * jobs: use comma as separator