Customizing your Reports - A User Guide

<body> <p id="noframes"> This <b>genealogy report</b> is about <i>Customizing your Reports - A User Guide</i>.It contains 16 individuals and 1 families, and also 7 Pictures from the family tree. <br />This GenoPro file contains documentation on the 'Custom Markup' features available in the Narrative Report. These allow a user to customize the generated report without requiring further programming of the scripts in the skin and without needing to edit the HTML files after generation.<br /><br />The documentation can be found below. There is also an example GenoMap illustrating many of the types of markup available.<br /><br />After reading the documentation it is suggested that you then display details of each family and individual in this report. You will then be able to view the results of the markup.<br /> <br />The first thing many users want to do is use their own background image and change fonts etc. The Narrative Report's theme feature is used to achieve this. There is a Config Presentation section parameter 'theme' that can be set via a Document Custom Tag StyleSheet, or via the Change Parameters dialog, to specify a folder containing replacements for some of standard styles in style.css. It is suggested that users look at the theme.css in the built-in 'GreenLeaf' theme folder (Code\themes\GreenLeaf) in a custom skin folder for more information and then create their own folder below Code\themes and add a file theme.css and possibly image files to it to create their own theme.. When the Report is generated the contents of theme.css will be appended to style.css, replacing any earlier definitions. To replace a background image the file specified in the custom style sheet must exist in the user's theme folder, normally in a subfolder 'images'. ¶¶<br /><?c Custom Markup Documentation+|Most of the descriptive text fields can contain 'Custom Markup'. This provides a shorthand way of including extra HTML in your report to provide functions to add many useful features such as custom 'containers/subsections' (similar to the standard Occupations, Educations etc.) and custom note entries. There are also easy ways to add photos and to add 'multimedia' links to appear in the 'popup' frame. These can even be used on the home page. ¶¶<br />N.B. In the documentation below a \ character is used to seperate alternative equivalent tokens e.g. in <?lt?>e\email\mail ..... <?gt?> e, email & mail are equivalent. ¶¶<br />The Custom Markup instructions are:¶¶<br /><?c Plain Text | <?lt?>a\alt\plain<?gt?> indicates the following text up to next Custom Markup instruction is plain text (displayed on text  reports only)?><br /><?c Hidden Text / Blank|<?lt?>b\blank\hide<?gt?> indicates the following text up to next Custom Markup instruction is not to be generated.?><br /><?c Container or Section|<?lt?>c\container heading+|content<?gt?> gives a collapsible section that can also contain further nested custom markup commands. The + after heading is optional and if present the section will be intially expanded. content is a mixture of text and additional custom markup, including including further nested <?lt?>c ......<?gt?> markup.?><br /><?c Email link|<?lt?>e\email\mail emailaddress<?gt?> insert a 'mailto' link e.g. <?lt?>email me@here.com<?gt?>?><br /><?c Format Phrase|<?lt?>f\format\phrase  <?q?>phrase1<?q?> arg1 arg2 .... argn<?gt?> invokes genoro's phrase generator using <?q?>phrase1<?q?> as the template and the arguments that follow it.¶<br />The arguments in the list are each separated by a space. Each param is either text or HTML enclosed in double quotes (<?q?>....<?q?>)excluding Custom Markup instructions or Tag Names (custom or standard) that can contain text or HTML. N.B. If arg is HTML use the 'h' suffix in phrase template.?><br /><?c Grid or Table|<?lt?>g\grid data column_separator row_separator?<?gt?> where data is either "some text" or a tag name inserts a grid or table using data from a string literal in double quotes or a custom/standard tag. 1st row is used as heading.¶default column_separator is a comma, and row_separator is semi-colon.¶<br />e.g. <?lt?>g? <?q?>dividend,divisor,quotient;100,20,5;18,6,3;28,8,3.5;<?q?>?<?gt?> or <?lt?>g mytag<?gt?>¶<br />or    <?lt?>g? <?q?>dividend@divisor@quotient$100@20@5;$8@6@3$28@8@3@5$<?q?><?gt?>?><br /><?c HTML| <?lt?>h\html<?gt?> indicates the following text up to next Custom Markup instruction is HTML (displayed on HTML reports only)?><br /><?c Image|<?lt?>i\image ref width height<?gt?>inserts an image/photo. 'ref' is either the path to the required image in the generated Report (Web) folder enclosed in double quotes (<?q?>...<?q?>) or the 'ID' of a picture within the .gno file e.g. pic00051. In the latter case the picture may also have an associated image map in its Custom _AreaMap tag. 'width' & 'height' are in pixels and are optional.¶They must be omitted if the image has an associated image map, otherwise the mapping is invalidated. If omitted the image is shown full size, with scroll bars if required. Using the picture ID means to image gets included in the Report automatically. To get other pictures/images into the Report folder see above regarding the background image.?><br /><?c Join or Merge|<?lt?>j\join\merge param1 param2 .... paramn<?gt?> inserts items specified in param list.¶The params in the list are each separated by a space. Each param is either HTML enclosed in double quotes (<?q?>....<?q?>) excluding Custom Markup instructions or Tag Names (custom or standard) that can contain HTML and/or Custom Markup instructions.?><br /><?c Flash Movie/Video|<?lt?>m\movie\video flash ref name width height align quality wmode background-color<?gt?> inserts a flash (.swf) movie/video. 'ref' is either the path to the required image in the generated Report (Web) folder enclosed in double quotes (<?q?>...<?q?>) or the 'ID' of a 'picture' within the .gno file e.g. pic00051.Using the picture ID means that the image gets included in the Report automatically. Although GenoPro does not display .swf files internally they are still accepted as 'pictures'. 'width' & 'height' are in pixels. The align, quality, wmode and background-colour are optional values.?><br /><?c MP4 Video|<?lt?>m\movie\video mp4 ref uniqueID width height preload poster<?gt?><br />inserts a .mp4 movie/video using the html5 'video' tag. If the video.js plugin is included (see 'presentation' Config Params) fall-back to flash is also provided.¶<br />'ref' is either the path to the required image in the generated Report (Web) folder enclosed in double quotes (<?q?>...<?q?>) or the 'ID' of a 'picture' within the .gno file e.g. pic00051.Using the picture ID means that the image gets included in the Report automatically. Although GenoPro does not display .swf files internally they are still accepted as 'pictures'.¶<br />The width, height, preload and poster are optional values. 'width' & 'height' are in pixel, preload defaults to 'auto'. 'poster' is used to specify a .jpg file to used as a preview image. Google HTML5 video tag for more information.?><br /><?c Note or Comment|<?lt?>n\note <?q?>subtitle<?q?> param1 param2 .... paramn<?gt?> inserts 'note' style collapse/expand item containing content as per param list (see join above)?><br /><?c Stop Processing Markup| <?lt?>o\off<?gt?> Turns off custom markup processing for the rest of the current field. Any further tags are treated as text?><br /><?c 'Popup' Frame| <?lt?>p\popup <?q?>subtitle<?q?> <?q?>hyperlink text<?q?> param1 param2 .... paramn<?gt?> inserts a link <?q?>hyperlink text<?q?> to a 'popup' frame with <?q?>subtitle<?q?> as its title containing content as per param list (see 'join' above)?><br /><?c Subsection|<?lt?>s\subsection <?q?>subtitle<?q?> param1 param2 .... paramn<?gt?>  inserts 'subsection' style collapse/expand item containing content as per param list (see merge above)?><br /><?c Text|<?lt?>t\text<?gt?><br /> indicates the following text up to next Custom Markup instructionis text (displayed on both text and HTML reports)?><br /><?c Hyperlink|<?lt?>u\url href\text<?gt?> insert a link to another webpage 'href' with optional \text e.g. <?lt?>url www.genopro.com\GenoPro<?gt?>?> <br /><?c Evaluate Expression|<?lt?>v\value expression <?gt?> evaluates a VBScript/JScript expression. Variable 'obj' is the current GenoPro object ?><br /><?c Additional Markup|With tokens that have a parameter that includes quoted strings e.g. note, join, popup etc.then the quotedstrings cannot include double quotes <?q?>, or the custom markup delimiters <?lt?> and <?gt?>.  If these are required within a quoted string parameter then instead use the markup <?lt?>q<?gt?>  for <?q?>,  <?lt?>lt<?gt?> for <?lt?> and <?lt?>gt<?gt?> for <?gt?>?>?><br /><br /></p><ul> <li><a href='toc_individuals.htm#Custom Markup'>Find the Custom Markup family and its 15 ancestors.</a>.</li> <li><a href='toc_individuals.htm#One Place'>Search the One Place family and its 1 persons.</a>.</li> </ul><p> You may also search for the following family names: .<br /><br />Copyright © 1998-2011 GenoPro Inc. All rights reserved. Download GenoPro from <a href='http://www.genopro.com/'>http://www.genopro.com/</a> </p> </body>