Quick Start Guide

Gigatrees is a standalone application. It does not require a separate installation program and does not modify your system registry, so you can move the installation folder at any time without affecting operation.

To Install

download the application and extract it. It will decompress itself into an installation folder ( /gigatrees5 ).

To Uninstall

Simply delete the installation folder. No fuss.

To Upgrade

Reinstall, but be careful. When you extract the distribution file, it will overwrite the default files located in the installation folder. To protect yourself, never edit the default files directly — always use copies.

Sample Website

Gigatrees provides several batch files that can be used to build sample websites. Instructions for doing so follow. A sample website can be found online at Live Demo. It is meant to demonstate many of the features available including a small integrated blog and photo gallery.

To Build an HTML Website

Building a website is quick and easy. In order to demonstrate this, try building the sample website in HTML first. This will allow you to view it on your computer immediately. To build the sample website in HTML, just run sample.bat. This will build the sample website and copy all of its files to the output path ( /sample ). After the build completes, click on the sample.html file to load the sample website in your default browser.

Now that you've seen how easy it is to build a website, you'll no doubt want to get started with your own right away. I recommend a quick review of the sample configuration files. You might also want to review the configuration options in the rest of the documentation. I've tried to keep the documentation concise so that it can be read through quickly. It is entirely up to you how many or few of these options you use. To build your own website, edit the user config file ( user.xml ) and fill in the missing GEDCOM File and Site Title options and then run user.bat. This will build your personal website and copy all of its files to the output path ( /user ). After the build completes, click on the user.html file to load your website in your default browser. For a more detailed explaination, please read the section on building your family tree in HTML at Build Your Family Tree.

To Build a Database

Building a website for actual deployment, requires that you generate a database rather than individual HTML files (though you can always deploy HTML files, but that's old school). For a detailed explaination, please read the section on building your family tree as a database and deploying it at Build and Deploy Your Family Tree.

Command Line Options

Gigatrees supports several command line options. Any number of configuration files can be included. The input file and output path are optional and can be set via the <Main> configuration option instead.

Configuration Files

The documentation will show the default values for configuration items in brackets, when they apply. Generally, it is not important which order options are specified in, nor is it important in what order the properties are specified within an option (unless otherwise noted). That being said, each property is processed in the order it is loaded, so if you redefine a property, it will overwrite previous definitions (in most cases). In some cases, such as redefning pages and images, you'll be notified during the build process. In other cases, such as when configuring the header and footer, the contents will be appended.

All configuration files use XML tags to define data. XML files are in plain-text, so you can edit them with any text editor. All configuration files must begin and end with the <Gigatrees> tag.

<Gigatrees>
  
  <!-- all configuration items go here -->
  
</Gigatrees>

For those unfamiliar with XML, XML tags are composed of opening and closing tag elements. Text falling between the opening and closing tags may include plain text, HTML (also JavaScript and PHP code) or additional XML tags. Since XML uses the left bracket ( < ) to deliniate the start of a tag, a special opening tag delimiter ( <![CDATA[ ) and closing tag delimiter ( ]]> ) must be used to embed HTML within an XML tag. Gigatrees supports embedding HTML in almost all record data. Given this, left brackets ( < ) unrelated to HTML tags when used in your record data can cause problems. Browsers will attempt to interpret these as HTML tags and the results may not be defined (nor pretty). Not to worry though, Gigatrees will automatically replace them with the HTML entity ( < ). Comments can also be embedded in both XML and HTML using a special tag structure ( <!-- and --> ). A generic example might look like this:

<Tag>

   <Tag>
     Hello World                       <!-- plain text -->
   </Tag>
   
   <Tag> 
     <![CDATA[
       <b>Hello World</b>              <!-- HTML -->
     ]]>
   </Tag>
   
</Tag>

Additionally, Gigatrees will automatically hotlink all standalone URLs found in your record data (See <AutoHyperlinkUrls>). By default, all images will be opened using FancyBox.

The remaining documentation discusses additional configuration options that can be used to extend the capabilities of your website. The Blog includes articles that cover some of these topics in greater detail.