English Narrative Report with Enhanced Privacy
==============================================

This GenoPro skin is designed to enable you to expose part of your family tree on a public
website, while keeping selected pages private by storing them in a separate subdirectory which
can be password protected. As a separate, non-privacy-related feature, the skin also resolves
URLs written in the comments sections of your report into active hyperlinks. 

The public part of your website is the normal web directory to which you upload your tree, as
specified in the "Destination folder for generated report" box in the "Report Generator" tab of
the "Generate Report" dialog, and in the "Web Directory (optional)" and "URL Equivalent to Web
Connection" boxes in the "Web Publishing" dialog, which you reach by pressing the "Web Publishing"
button in the "Generate Report" dialog. The private part of your website is created in a sub-
directory named "private" within the specified folder.

NOTE THAT THIS SKIN DOES NOT, AND CANNOT, MAKE THE FILES PRIVATE ITSELF. YOU *MUST* ARRANGE
TO MAKE THE private SUBDIRECTORY PASSWORD-CONTROLLED BY USING WEBSERVER DIRECTIVES APPROPRIATE
TO THE SERVER WHERE YOUR TREE IS STORED.

This skin is based on the standard "English Narrative Report" skin supplied with Version 2.0.0.2
of GenoPro 2007.

To use it, unzip all the files in Enhanced-Privacy-Skin.zip into a convenient directory, and
specify that directory in the "Folder where the skins are located" box in the "Options" tab of
the "Generate Report" dialog. Then return to the "Report Generator" tab, and select the "English
Narrative Report with Enhanced Privacy" skin in the "Skin Name" pulldown list. 
IMPORTANT: You should deselect the "Remove All Living Individuals" checkbox in the "Privacy" tab
before using this skin, otherwise no living individuals will included in the private section of
the report. Finally, press the "Generate" button to produce the report.

Note that, when using this skin, you MUST upload directly to the intended website when you generate
the web files. You cannot generate to a local directory and upload later with another FTP program.
This is because many of the files use the <base> tag to specify an absolute base URL from which to
resolve relative URLs. 

Customizing which individuals are private
-----------------------------------------

By default, this skin will make all living individuals private and all deceased individuals public.
You can customize this action by creating a "Private" Custom Tag that can be associated with individuals.
To do this use the Tag Editor, which you can access from the "Tools" pulldown in the main GenoPro
window:
-- Select the "Individual" tab, to create Custom Tags for individuals.
-- Press the "New" button in the "Dialog Layouts" section to create a new Layout.
-- Specify a Layout Name of "Extended Privacy" and a Layout Description of "_Extended Privacy Option".
   The initial underscore in the Description prevents the tag value from being written to the report.
-- Select the name of the "Extended Privacy" layout that you just created. This should change the name of
   the lower section of the "Tag Editor" dialog to "Tags for Dialog Layout 'Extended Privacy'".
-- Press the "New" button in the lower section of the dialog to create a new custom tag for the layout.
-- Specify "Tag Permanent Name" as "Private"
           "Tag Display Name"   as "Private"
           "Tag Description"    as "Store details in private folder".
-- Press "OK" to exit the Custom Tag dialog.

The "Private" tag should now be available for use. You should see it as a column in the
"Table Layout - Individuals" table accessed from the "View" pulldown on the main GenoPro window,
or as an "Extended Privacy" tab in the Propeties dialog for an individual.

In either place, specify a value for the "Private" tag of Y to make the individual private, or N to make
the individual public. (The Y and N are case sensitive, and must be entered in capitals.)

If you want to make further customizations of privacy, you should alter the "isPrivate" function in
Code/Util.vbs, where all the privacy decisions are made.

Which pages are made private
----------------------------

As well as making the individuals private, this skin makes unions involving a private person
private too. Private children of a public union are listed on the family page, but no personal details
are included. Private individuals and families are excluded from the Picture index and the Picture
Gallery. For private individuals in a public genomap, only the gender symbol is shown, and no personal
details or hyperlinks are included. If a genomap consists entirely of private individuals, it is classified
as private, and is not displayed at all in the public pages.

However, all places are deemed to be public. If a place is associated with an individual, that individual
is shown with the place, but the hyperlink for the individual resolves into the private folder, so cannot
be viewed without a password. (Place pages containg Google maps should not be password-protected, as I think
that would violate the terms of use for the Google Maps API, which say: "The API may be used only for services
that are generally accessible to consumers without charge.")

Each of the four main sidebar tables of contents (Individual, Families, Genomaps, and Pictures) has a
public version and a private version. The public tables of contents contain only links to public pages,
but the private tables contain links to public and private pages.

Converting URLs in commentary sections into active hyperlinks
-------------------------------------------------------------

As a separate non-privacy-related feature, this skin resolves fully-qualified URLs that you include
in your GenoPro Comment boxes into active hyperlinks. This feature recognizes URLs that begin with
http://, https://, and ftp://. You can just enter the URL into your text, delimited by white space,
or you can immediately follow the URL with a link description enclosed in braces {}. There must be no
space between the end of the URL and the opening brace.
For example:
  http://www.genopro.com
links to the GenoPro website, and displays the actual URL as the linkable text, whereas
  http://www.genopro.com{Link to the Genopro website}
links to the GenoPro site but displays the text "Link to the GenoPro website" as the linkable text
in your report. The links all have the attribute target="_top", so that the target site is not enclosed
inside the GenoPro frame structure.

Which skin files are modified
-----------------------------

The following files in the "English Narrative Report" reference skin are modified:
  Code/Lang.vbs
  Code/Util.vbs
  Config.xml
  default.htm
  family.htm
  genomap.htm
  genomap.svg
  home.htm
  individual.htm
  Init.htm
  pictures.htm
  script.js
  toc_families.htm
  toc_genomaps.htm
  toc_individuals.htm
  toc_names.htm
  toc_pictures.htm

The code to resolve URLs into active hyperlinks is contained entirely within the
"WriteHtmlAnnotation" function in Code/Util.vbs, so could be extracted and used separately
if desired.

Copyright and Licence
---------------------

The customizations in this skin and this documentation are 
Copyright © Peter Havercan 2007.
However, you are free to use and alter them as you wish, provided you include an acknowledgement
to the author in the modified code.

These modifications are offered under the "Creative Commons Attribution-Noncommercial 3.0 License",
which means you are free to use or modify these changes for your personal non-commercial use,
provide you attribute Peter Havercan as the author and refer back to this site <http://roots.havercan.net/GenoPro-Skins/>.

Although this customization is designed to keep personal data private, I do not accept any
liability for data that may become exposed due to its use. Please see the highlighted paragraph
at the start of this document. You are responsible for ensuring that the private directories
created by this skin are, in fact, kept private.

Please report any errors to peter at havercan.net.