xXx

Hexid M1n1 5h3ll MobiLe

C:/www/familytree/mods/textplus_charts_v10.1.0.13b/English/_[ Writable ]

File:C:/www/familytree/mods/textplus_charts_v10.1.0.13b/English/textplus_help.php

<?php
# Installed by the Text Plus Charts mod
$imagepath = "textplus_"; #path to images plus image prefix
$tngModNames['TextPlus Charts']['textplus_help.php'] = '13a'; #Register this mod

include("../../helplib.php");
?>

<body class="helpbody">
<a name="top"></a>
<table width="100%" border="0" cellpadding="10" cellspacing="2" class="tblback normal">
<tr class="fieldnameback">
	<td class="tngshadow">
		<p style="float:right; text-align:right" class="smaller menu">
			<a href="http://tngforum.us" target="_blank" class="lightlink">TNG Forum</a> &nbsp; | &nbsp;
			<a href="http://tng.lythgoes.net/wiki" target="_blank" class="lightlink">TNG Wiki</a><br />
			<a href="pedconfig_help.php" class="lightlink">&laquo; Help: Chart Settings</a> 
		</p>
		<span class="largeheader">Help: Text+ Charts </span>
	</td>
</tr>
<tr class="databack">
	<td class="tngshadow">
		<h3>The Text+ Charts</h3>
		<p>
		There are two Text+ Charts - a pedigree chart, and a descendant chart.
		The Text+ Charts are not standard TNG charts; they are implemented by a TNG Mod.
		If you are reading this page on your site, then the Text+ Charts mod has been installed on the site. </p>
		<p>See the <a href="http://tng.lythgoes.net/wiki/index.php?title=TextPlus_Charts" target="_blank">TextPlus Charts Wiki Page</a> for descriptions and examples of Text+ Charts.
		</p>
		<h4>Table Of Contents</h4>
		<ol type='I'>
			<li><a href='#options'>Overview of Run-Time Options</a></li>
			<li><a href='#content'>The Inner Menu and Content Controls</a></li>
			<li><a href='#margins'>Margins and Line-Wrapping, and Printer Configuration Controls</a></li>
			<li><a href='#links'>Links in the Text+ Charts Inner Menus</a></li>
			<li><a href='#textplusadmin'>Administrative Settings</a></li>
			<li><a href='#navigate'>Navigating the Family Tree</a></li>
			<li><a href='#boundary'>Boundary Conditions</a></li>
			<li><a href='#author'>Author's Notes</a></li>
		</ol>
	</td>
</tr>
<tr class="databack" id="options">
	<td class="tngshadow">
		<h3>I. Overview of Run-time Options</h3>
		<p>The Text+ Charts have several run-time options, some of which are unique to the Text+ Charts. There are 3 types of run-time options:
			<ol>
				<li><em>Content Control options</em> - including a "Generations" control like the one in the standard TNG Ancestor and Descendant charts - can fine-tune the data that is included in the charts, and are part of the "Inner Menu" of the chart programs. The Text+ Descendant Chart menu is shown here.<br>
				<img src="{$imagepath}descend1.png" alt="Text+ Descendant Innermenu"></li>
			<li>
				<em>Printer Configuration</em> options that are unique to the Text+ Charts are used to control line-wrapping.  These options are necessary because the standard line-wrapping capabilities of web browsers cannot deal with the vertical bars printed in the left margins of the Text+ Charts as those left margins shift with the indentation for each generation in the charts. These options are available only on the "Format for Printing" page that pops up when you click 
				<ul><li>The "Format for Printing" button in the Text+ Charts Inner Menus, or</li>
					<li>The the standard TNG "Print" buton near the upper right of the page.</li>
				</ul>
				The Text+ Descendant Chart menu is shown here, but the same four controls are used in the Text+ Ancestor Chart. 
				<img src="{$imagepath}printmenu.png" alt="Text+ Printer Configuration Menu">
			</li>
			<li>
				<em>Tree Pruning</em> in the Text+ Descendant Chart works exactly like it does in the Text version of the standard Descendant Chart.  That is, you can click on the tiny minus sign next to a spouse's name to hide all of that spouse's descendants.  When you ado so, the minus sign becomes a plus sign that you can click on to re-display that branch of the family.  The Text+ Descendant Chart is distinct in that a count of the people who have been hidden is displayed in a chart summary at the bottom of the page. Here you can see a Text+ Descendant Chart in which the branches with outlined plus signs have been pruned and the the branches with double-outlined minus signs have not been pruned.
				<img src="{$imagepath}pruning.png" alt="Text+ Tree Pruning">
			</li></ol>
		<a href='#'>Back to top</a>
	</td>
</tr>
<tr class="databack" id="content">
	<td class="tngshadow">
		<h3>II. The Inner Menu and Content Control Options</h3>
		<p>
		In most end-user TNG programs, the Inner Menu is just one line long, and contains only links.
		TNG Admin programs, the Inner Menu tends to have a second line that links to a help page.
		In the Text+ Chart programs, the inner menu contains 
		<ol>
		<li>Hyperlinks to other Pedigree or Descendant charts (just like the standard Pedigree and Descendant Charts), </li>
		<li>Some instant-action form fields that control the content of the chart, </li>
		<li>A help button, and</li>
		<li>A "Format for Printing" button, which does exactly the same thing as the normal TNG "Print" button to the upper right on the page.</li>
		</ol>
		<span class="optionhead">Content-Control Options in the Text+ Inner Menu</span>
		<ol type="A">
		<li><b>Options Common to both Text+ Chart Programs</b>
			<ol>
			<li><b>Generations</b>. This parameter appears in both Text+ Chart programs, 
				as well as the standard TNG chart programs. 
				The Text+ Charts allow the value zero, which means "process as many generations as you find".
				The Text+ Charts can fit close to 20 generations in a chart.</li>
			</ol></li>
		<li><b>Content-Control Options for Text+ Descendant Charts</b>
			<br/><img src="{$imagepath}descend2.png" alt="Text+ Descendant Chart Content Controls">
			<ol>
			<li><b>Hide data of living and private people</b>. This option is shown <b>only if you are logged in</b>.
				When this option is checked, living and private people treated as though you were not logged in, 
				and are shown only as "Living" or "Private", without a name, dates, or places.
				This option defaults to unchecked.</li>
			<li><b>Hide descendants of "Living" people</b>.
				If you are logged in, this option only appears if you have selected "Hide data of living and private people".
				<br/> 
				When this is unchecked, the chart may show two or three, even four generations of descendants identified only as "living"
				(possibly along with some deceased descendants with full information.)
				<br/>When this is checked, NO descendants, living or not, of living people are shown.
				<br>This option defaults to unchecked.</li>
			</ol></li>
		<li><b>Content-Control Options for Text+ Ancestor Charts</b><br/>
			<img src="{$imagepath}ancestor2.png" alt="Text+ Ancestor Chart Content Controls">
			<ol>
			<li><b>Siblings</b>. 
				When this option is checked, the siblings of the starting person, and of each ancestor, are listed. (That is, Aunts and Uncles are shown in each generation.)
				It defaults to unchecked.</li>
			<li><b>Blank lines</b>.
				When this option is checked, blank lines are inserted in the Ancestor chart at strategic points to aid readability. It defaults to unchecked.</li>
			<li><b>Show Generation Numbers</b>.
				When this option is checked, Generation Numbers are placed before each name.
				blank lines are inserted in the Ancestor chart at strategic points to aid readability. It defaults to unchecked.<br/>
				<img src="{$imagepath}coungenerations.png" alt="Text+ Ancestor Chart Generation Counts"></li>
			<li><b>Show Sibling Count</b>.
				This option is available only if the Siblings option and the Show Generation Numbers are both checked. When it is checked, a sibling count is displayed along with the generation count in front of each name. It defaults to unchecked.<br/>
				<img src="{$imagepath}countsiblings.png" alt="Text+ Ancestor Chart Sibling Counts"></li>
			</ol></li>
		</ol>
		<a href='#'>Back to top</a>
	</td>
</tr>
<tr class="databack" id='margins'>
	<td class="tngshadow">
		<h3>III. Margins and Line-Wrapping, and Printer Configuration Controls</h3>
		<h4>Margins and Line Wrapping</h4>
		<p>
		In most web pages, the content of the page can re-wrap or float as the margins, window size, or page size changes.
		This is not true of the Text+ charts.  
		Because the Text+ charts draw lines connecting the generations, 
		these charts cannot simply allow long lines of data to wrap at the browser window's (or printed page's) right margin, 
		as that wrapping would disrupt the lines on the left side of the page.
		As a result, the Text+ chart programs have to know the window width, the font size,
		and the font face so that they can wrap lines of data at the appropriate point.
		Therefore, the Text+ chart programs contain a form with fields that specify printing parameters.
		</p>
		<p>
		That form is on the black-and-white "Pretty-Print" or "Print Format" page that you reach by clicking on 
		the "Print" button in the upper right of the page.<br/>
		<img src="{$imagepath}printmenu-wrap.png" alt="Text+ Printer Configuration Menu">
		<br/>
		(Note that there is still a "Print" button in the upper right of this screen shot, 
		but on the "Pretty-Print" screen, the "Print" button actually prints.
		Note also that the Content-control parameters appear in the printer control form,
		but they are not instant-action on this form; you must click the Submit button for them to take effect.)
		</p>
		<span class="optionhead">Printer Configuration Controls</span>
			<br/>(These controls are the same in both Text+ programs.</span>
		<ol>
		<li><b>Indentation for each generation</b>, in compressed fixed-font characters. 
			The default is 6 fixed-font-size characters.  
			(But the indentation is done at approximately 80% of the specified font size.)</li>
		<li><b>Font size</b>.The default is 11 points (approximately 11 characters per inch). </li>
		<li><b>Page Width</b>. The three possible sizes are Portrait, Landscape, and "Legal" (which is really legal landscape).
			On the pretty-print screen, the program sets its right margin according to the selected Page Width, 
			not according to the window size on the computer display. 
			The default is Landscape (which is most appropriate for a typical computer's browser window.</li>
		<li><b>+/- n characters</b>. 
			A fudge factor that you can apply to the right margin if you find that, with your computer or your printer, 
			lines of data seem to wrap too late (or maybe too soon.) The default is none.</li>
		<li><b>Submit</b>. This button submits the form and draws another chart.</li>
		<li><b>Save Settings</b>. This button saves the current values of the Generations field and the print control fields (i.e., the underlined fields) 
			to a persistent cookie for use on subsequent charts.
			Because the settings are saved to a cookie, not to a database, 
			they are remembered only by a specific browser on a specific computer.
			The Text+ Descendant chart and the Text+ Pedigree chart have separate cookies, and thus separate defaults.
			<br/>Note that the content control checkboxes (Siblings and Blank Lines for Ancestors, and two checkboxes about living people for Descendants) are not saved; they always default to "unchecked".
		</ol>

		<h4>Because the printer settings control form is on the "Pretty-Print" window, 
		you should almost always use the "Pretty-Print" window to print Text+ Charts.</h4>

		<p>
		<span class="optionhead">When and Where the Defaults are Applied</span>
		As noted above, you can use the "Save Settings" button on the printer-configuration form to save default values in a persistent cookie on your computer.
		The printer characteristics are not relevant on the "main" screen (with template colors);
		they are relevant only on the black-and-white Pretty Print screen.
		But the default number of generations is applied immediatedly, on the "main" screen.
		The report width on the "main" screen is "landscape" (i.e. 10 inches wide) in most cases,
		and is "portrait" (i.e. 7.5 inches) when you are in mobile device mode.
		</p>
		<p>The user can modify the content control parameters on the "main" screen,
		and those values will be passed to the Pretty-Print screen,
		where the other saved defaults are applied.</p>
		<p>For the Generations parameter, the initial default (before you have saved your own defaults) 
		is determined by the Pedigree and Descendant Chart defaults that are set in the Administration / Setup  / Chart Settings form.
		</p>
		<a href='#'>Back to top</a>
	</td>
</tr>
<tr class="databack" id="links">
	<td class="tngshadow">
		<h3>IV. Links in the Text+ Charts Inner Menus</h3>
		<p>
			<img src="{$imagepath}descendlinks.png" alt="Text+ Descendant Innermenu"><br>
		In the Descendant Text+ program, the <i>Text+</i> link and the <i>Count</i> link have been added to the standard Descendants Inner Menu <b>by separate mods</b>.
		The TextPlus Charts mod and the Count Descendants Mod coordinate with each other,
		in that they are each aware of presence of the programs installed by the other mod, 
		and they display the relevant links if and only if the program is installed.
		</p><p>
			<img src="{$imagepath}ancestorlinks.png" alt="Text+ Pedigree Innermenu"><br>
		In the Inner Menu of the Ancestor Text+ program, the <i>Text+</i> link has been added by the TextPlus Charts mod.  The <i>Fan Chart</i> link is native to TNGv11, but in TNGv10, it must be added by a mod.  In addition, a <i>Map</i> link - to the Ancestor Map - may be installed by the Ancestor Map mod. The Fan Chart and Ancestor Map mods modify the Inner Menus of the standard Ancestor Chart programs to add their links, but those mods do not add the <i>Text+</i> link to the Fan Chart or Ancestor Map programs.  So, if the Fan Chart and/or Ancestor Map programs are present when the TextPlus Charts mod is installed, then the TextPlus Charts mod modifies them to add the <i>Text+</i> link.  The Text+ Ancestor Chart program also includes code that adds the <i>Fan Chart</i> and <i>Map</i> links to the Text+ Ancestor Chart Inner Menu if and only if the applicable programs exist (at run-time).</p>
		<p>
		Note that, if the Fan Chart and/or Ancestor Map mods are installed <i>after</i> the TextPlus Charts mod, then the Fan Chart and/or Ancestor Map will not have a <i>Text+</i> link in their Inner Menus.
		</p>
		<p>
		In truth, several other mods install programs that are placed on the Ancestors or Descendants Inner Menus, but the TextPlus Charts mod does not affect them.
		As a result,
		<ol type='a'>
		<li>Those programs will not appear on the Inner Menu in the Text+ Charts programs, and</li>
		<li>The Text+ Charts programs will not appear on the Inner Menu of those program (unless the mod authors specifically adds them).</li>
		</ol>
		<h4>Removing the <i>Text</i> link from the long Ancestor Chart Inner Menus</h4>
		As you can see from the screen clip above (which cuts off at least the <i>PDF</i> link from the Inner Menu) the Inner Menu for Ancestor Charts can get awkwardly long when several mods have added several links.  But since the Text+ Ancestor Chart essentially supercedes the regular Text version of the Ancestor Chart, some administrators like to remove the <i>Text</i> link to shorten the menu just a bit.
		</p>
		<p>The TextPlus Charts mod installs a program that can remove the <i>Text</i> link from all of the standard Ancestor Chart programs.  That program can be run from a link in the TextPlus Charts mod description within the Mod Manager.  It checks for the string that "comments out" the <i>Text</i> links, and allows you to disable those links by adding a comment, or to restore the <i>Text</i> links by removing the comment.
		</p>
		<a href='#'>Back to top</a>
	</td>
</tr>
<tr class="databack" id="textplusadmin">
	<td class="tngshadow">
		<h3>V. Administrative Settings for Text+ Charts</h3>
		<p style='margin-bottom;0'>
		The TextPlus Charts mod modifies two fields in the <b>Admin >> Setup >> Configuration >> Chart Settings</b> form.</p>
		<ol style='margin-top:0;margin-bottom:0;'>
		<li>In the <b>Pedigree Chart</b> subform, the <b>Initial Display</b> field now has an entry called "Text+" 
			that allows the Text+ Descendancy Chart to become the default descendancy chart in the Person Profile.</li>
		<li>Similarly, in the <b>Descendancy Chart</b> subform, the <b>Initial Display</b> field also now has an entry called "Text+"
			that allows the Text+ Pedigree Chart to become the default Person Profile pedigree chart.</li>
		</ol>
		<img src="{$imagepath}setup.png" alt="Text+ Administrative Setup">
		<br/><a href='#'>Back to top</a>
	</td>
</tr>
<tr class="databack" id='navigate'>
	<td class="tngshadow">
		<h3>VI. Navigating the Family Tree</h3>
		(That is, following links in the Text+ Charts.)
		<p>
		As with the regular TNG family charts, person's names in the Text+ charts are hyperlinks to that person's profile.
		Also, at the ends of some lines of data, the character string <b>=></b> forms a hyperlink to that person's Text+ Pedigree or Descendant Chart.
		(A bold red arrow points to one of those end-of-line continuation links in the illustration above.)
		</p>
		<p>
		But on the Pretty-Print screen, with the printer-configuration form, those links are not defined.
		You must use the "main" screen (with your template colors) to navigate within the family tree,
		and then use the black-and-white Pretty-Print screen just to set up the printer settings.
		</p>
		<a href='#'>Back to top</a>
	</td>
</tr>
<tr class="databack" id='boundary'>
	<td class="tngshadow">
		<h3>VII. Boundary Conditions</h3>
		<br>(What happens as the number of generations grows and the vertical lines approach the right margin.)
		<p>
		There is no specific limit to the number of generations you can <em>try to</em> print with any given set of parameters, 
		though things will start to break down as the vertical lines drawn by the programs approach the right margin. 
		Specifically:
		<ol>
		<li>The last generation or two that fits on a line will be wrapped in a small-enough area to make each person's data take several lines to print.
		<li>A person's name is never wrapped, so there is not room on a line for the entire name, the name will wrap to the far-left margin when you print.</li>
		<li>If there are fewer than nine available spaces for data on a line, an error message will be displayed indicating that the data will not fit on the chart with the current print parameters.</li>
		</ol>
		<p>
		If any of these conditions occur, you can simply decrease the indentation or font size, or increase the page width. 
		(Or, of course, decrease the number of generations.)</p>
		<a href='#'>Back to top</a>
	</td>
</tr>
<tr class="databack" id='author'>
	<td class="tngshadow">
		<h3>VIII. Author's Notes</h3>
		<h4>Limiting Line-Wrapping by abbreviating place names</h4>
		<p style="margin-bottom:0;">
		Both Text+ charts include (a) the the date and place of birth and
		(b) the date and place of death OR the date and place of last-known residence for each person.
		And the Text+ Pedigree report includes (c) the date and place of marriage.  
		This amount of data can result in a fair amount of line-wrapping.
		To reduce that line-wrapping, the author has implemented a scheme that adds some database fields to the TNG 
		database and that uses algorithms to create shortened copies of each place name.  For example, it can use "Chicago, Cook, IL" and "Harris Co, TX" as <i>alternatives</i>, not <i>replacements</i> for "Chicago, Cook County, Illinois, USA" and "Harris County, Texas, USA". 
		This scheme affects only USA place names, and
		</p>
		<ul style="margin-top:0;">
		<li>Abbreviates or eliminates the word "County",</li>
		<li>Uses state abbreviations in place of full state names where the place name includes a town or county,</li>
		<li>Recognizes and eliminates several funky census locales such as ("Magisterial Disctrict 3"), and</li>
		<li>Eliminates county names when showing the place of residence.</li>
		</ul>
		<p>
		The effectiveness of this scheme, of course, depends on one's data, 
		and increases with the number of generations of ancestors or descendants in a chart.
		For charts that display several generations of ancestors or descendants, 
		this scheme can reduce the number of lines in a report by as much as 10%, 
		which may or may not be significant to a specific user.</p>
		<p>
		This scheme has been implemented in an unpublished TNG mod.  If you are interested in it, 
		contact the mod author via the links on the 
		<a href="http://tng.lythgoes.net/wiki/index.php?title=TextPlus_Charts" target="_blank">TextPlus Charts Wiki Page</a>.
		</p>
		<hr>
		<span class="optionhead">Using HTML rather than PDF</span>
		<p>FWIW, most web applications that do their own line-wrapping like the Text+ Charts generate PDF files, which allow print characteristics to be controlled with more specificity that is possible with HTML.
		But I first wrote HTML versions of the Text+ charts long before the PDF format became standard (and before I implemented them in TNG), 
		and I've simply continued to use HTML with each new implementation. 
		<a href='#'>Back to top</a>
	</td>
</tr>

</table>
</body>
</html>

Your Access Expired	Date. in : 02-11-2025
Regist : 09-12-2024	Expired : 01-12-2027