All Ancestors Report – Miscellaneous Help…

Command Line Parameters

AAR remembers your program settings (customizations) from session to session by storing them in an XML config file. By default, AAR starts for the first time using the…

“C:\Documents and Settings\<username>\Application Data\Zipper Software\All Ancestors Report\default.xml”

… config file, which you see listed in the title bar. (Note: the location of this config file will be different if you are using Vista.)

You can tell AAR to use a different XML file by passing AAR a startup (or command line) parameter. For example…

“C:\Program Files\Zipper Software\All Ancestors Report\aar.exe” /ini=myfamily

… will start AAR using the myfamily.xml config file. This feature allows you to have several sets of AAR program settings, perhaps for multiple sets of AAR reports for different family files or family lines.

Note: AAR will create a new XML file if the specified file doesn’t exist.

Report Flexibility

Because AAR uses XML, XSL, and CSS, the user has the ability to tailor the AAR reports to his/her heart’s content. Doing this does require knowledge of XSL and/or CSS.

AAR comes with a default aar.xsl and aar2.css (aartoc.xsl for the Table of Contents) which AAR places in your (Internet) Destination Folder. You can make any changes you like to these files, but I advise making a backup first. AAR will not overlay them if it finds an existing copy in your Destination Folder.

Note: If you mess these files up while playing around with them (and you didn’t make a backup), you can just delete them and the next time AAR runs it will place a new default copy back in your  Destination Folder.

Legacy’s Individual Private & Invisible flags

AAR ignores Legacy’s individual Private & Invisible flags. If you do not wish AAR to display individuals marked Private or Invisible, you must export your Legacy database to a new Legacy database, excluding any individuals marked Private or Invisible. Then run AAR against this new database.

Legacy’s Marriage Tag#9

In Legacy V7 you have the ability to mark a marriage as “Private”. AAR respects this marking when generating web pages. To accomplish the same thing if you use Legacy V6, simply turn on marriage Tag#9 for any marriage that you wish AAR to ignore.

Special AAR Master Events

AAR does special things if it encounters the following Master Events attached to an individual in your Legacy database:

  • AAR Note

If, for an individual, you add an AAR Note event with some text in the Notes field, AAR will add a Note link after the name of the individual. When a user clicks the link, a small window will pop up and display whatever you entered in the Notes field.

  • AAR External Link

If, for an individual, you add an AAR External Link event with a valid hyperlink, for example…

… in the event’s Description field, AAR will create a hyperlink to the specified web page for that individual and stop processing that individual’s family (i.e. will not list any spouses or descendants). This is useful in situations where a fellow researcher has posted a particular family line to the Internet that you don’t want AAR to duplicate.

Note: If you wish to take advantage of any of these features, you need to create these Master Events by going to View > Master Lists > Event Definition in Legacy and adding them. You will probably wish to mark them as Private event types.

How AAR links to images

If you wish AAR to provide a hyperlink to an individual’s preferred image, first place a copy of the preferred image into the folder that you use for uploading to the Internet. For example, if I am generating my AAR web pages in…


… I might place all the genealogy related images that I want uploaded to the Internet in…


Then, in AAR’s Customize Reports dialog, I would enter…


… as the (Internet) Images Folder. (Note: “.” means “relative to the current folder”, while “..” means “relative to the parent folder”.) This tells AAR how to create the hyperlinks to your images.

One additional item worth mentioning … AAR will only generate a hyperlink to an image IF it finds the image file in the (Internet) Images Folder. So even though you may have hundreds of individual images connected to your Legacy database, if you don’t copy any to your (Internet) Images Folder AAR will not not link them.

No Sources in AAR

Since I don’t believe in publishing sources on the Internet, AAR does not (and never will) include sources in any of its reports.

Comments are closed.