Terry's TMG Tips

Journal Introduction and Conclusion

This page updated 26 Apr 2008

Version note: Applies to TMG 7

TMG's Journal reports may optionally include an introduction section that precedes the normal genealogy section, and a concluding section that follows the traditional report. Both sections are useful for discussions that apply to the contents of the report as a whole, as opposed to being linked to a specific person in the report. Some material that might be placed in these sections include the following:

• General comments about the family line.
• A description of one's research methods, state of the research, or general issues with the material included.
• Notes about conventions used in the report.

The material for the Introduction and the Conclusion is entered into special Tags – JournalIntro and JournalConclusion. The following sections describe how these special Tags are work, and discuss some considerations that may be helpful in making use of them.

Overview

The JournalIntro and JournalConclusion Tags are entered for the person who will be the focus person (starting person) of the Journal report. They have these characteristics:

• The output of the JournalIntro Tag will appear at the very beginning of the report, before the Title which is produced by the Report Title field on the General tab of Report Options.
• The output of the JournalConclusion Tag will appear after the end of the normal text from the report.
• If you have more than one JournalIntro or JournalConclusion Tag for a person Sort Dates must be entered to properly sequence the individual Tags.
• JournalIntro and JournalConclusion Tags are totally ignored by other types of reports, and in Journals when they exist for people who are not the focus person in the current report.
• Standard Sentence rules apply to these tags, so the output can consist of text in Memos and other fields, controlled by the Tag Sentence.

Considering the points discussed in the following section will help produce the desired results.

Creating a Report Title

Since the normal report title created by values entered in the Report Title field on the General tab of Report Options appears after the Introduction section, most users will want to create an overall title for the report as part of the Introduction. Some useful controls for construction this title include:

Font Control – There are two sections on the right-click menu of Sentences and Memos that can be used to control the font used for the title. The font weight can be directly controlled by using the Format codes for Bold, and the size of the text can be controlled by the Format code for Point Size. With the Point Size control you indicate the point size of the text directly:

[SIZE:]14;My Report Title[:SIZE] would produce a title in 14 point text.

An alternate method is to use the standard Font settings on the right-click menu, in which case the actual font characteristics used are controlled by the Fonts tab of Report Options when the report is generated. For example, if one specifies the "Titles" font, the report Options settings for Titles are applied. This will result in the same font setting that are used for the normal report title. The "Labels" font settings seems to be little used by reports, so specifying that font would allow one to use settings for the main title entered as part of the Introduction that are different than those used for the normal report title. These Font controls allow control of the typeface used in addition to the weight and size.

Centering – Most titles are centered. The new centering control, described below, can be used to achieve that effect.

Placing Font Controls – Best results are probably achieved by placing the font controls in the Memo. Some, such as Point Size, cannot be used in the Sentence to control the way text placed in the Memo or other fields is rendered. Others, such as Bold and Centering can be placed in the Sentence and still apply to the output of fields referenced by variables if the report output is sent to a word processor file. Test your work to ensure the desired results are produced.

Since the title produced by the Report Title field in Report Options appears as a subtitle when you add an Introduction section, consider whether it should be changed from the default settings. By default, the Report Title field for a Descendants Journal is

Descendants of [F]

which produces a title similar to

Descendants of Robert Edwards Gapsch

You can enter any title you like, with or without the use of the variable [F], which produces the name of the focus person of the report.

How Many Tags?

The default Sentence for both Tag Types is <[M]> so the default usage would be to enter the desired text in the Memo of the Tag. The report title, and section titles used, as well as the entire text of the Introduction can be placed in the Memo of a single JournalIntro Tag. Similarly, the text of the entire Conclusions section can be placed in a single JournalConclusion Tag. Alternately, one may choose to create a series of Tags of each type, perhaps one for the Title, one for each paragraph of text, and if subtitles are used, one for each subtitle. If multiple Tags are used sort dates must be assigned to sequence them correctly.

The decision as to which method to use seems to be largely personal preference. Some may find it easier to work with the entire text in one tag, while others will prefer to break the Introduction and Conclusion into smaller sections. If citations will be used, placing the entire text in a single or very few Tags will likely require use of Embedded Citations.

One advantage to using separate Tags for various parts is that Roles can be constructed for each different type of section, and those Roles can appear in the Person view for each Tag. For example, one could create Roles for title, subtitles, body text, and indented text.

The Center and Left Indent Formats

The Center and Left Indent (Block Indent) format options (introduced with version 7.01) can be very useful in formatting Introductions and Conclusion sections, but are also available in any other context.

Both formats can only be applied to whole paragraphs of output text. This leads to the following considerations:

Centering – uses the following construct:

[CENTER:]This text will be centered.[:CENTER]

The closing [:CENTER] code automatically includes a carriage return to set it off from the following paragraph. But the opening [CENTER:] code does not; if it did there would be an undesired blank line preceding the title when used in that context. If you use this code where there is text preceding it, add a carriage return before the centered text, as follows:

[:CR:][CENTER:]This text will be centered.[:CENTER]

When using this format for a title, which does not normally include a closing period, a No Change to Punctuation code – [:NP:] – is generally necessary in the Sentence to avoid having one automatically added:

[CENTER:]This Is the Title[:CENTER][:NP:]

Left Indent – also known as block indent, is often used for a larger quotation. It uses the following construct:

[LIND:]This text will be indented on the left side.[:LIND]

Generally indented text should be in a separate paragraph, so a carriage return should be added before the start of the indented text. Any following text must be in new paragraph if it is not to be indented also. Unlike the closing center code, a carriage return is not automatically included. If it were, any source note reference number at the end of the paragraph would appear on the next line. If the indented text is not cited, a [:CR:] code can be added at the end of the indented text. But if a citation is included, the [:CR:] code must be at the beginning of the following Tag.

The following example shows how these codes might be used:

This text was generated with the following Sentence:

[:CR:][:TAB:]The following newspaper report of her wedding appeared< in the [LCI]><, [LS]>< [LD]>< [D] >:[:CR:][M]

The contents of the Memo show how the center and left indent codes were applied:

[CENTER:]Schoolday Love Leads to Wedding[:CENTER]
[CENTER:]Miss Irma Sander, Handsome Heiress, Becomes Mrs. Howard Fenker[:CENTER]
[CENTER:]Cupid Undaunted Through College and Business Separated the Lovers[:CENTER]
[CENTER:]Romance That Began in Intermediate School Led to the Bridal Affair[:CENTER]
[LIND:]Back of the quiet wedding Wednesday night of beautiful Irma Sander, daughter of Adolph Sander, millionaire pork packer, of 3430 Brookline avenue, Clifton, and Howard Fenker, 930 West Ninth street, has developed a romance dainty enough to have formed the plot of a piece of fiction. Miss Sander and her young husband, who are now on their honeymoon trip, met when they attended the First Intermediate. Howard and Irma were "sweethearts" those days and when they entered Hughes High school in the same class the romance grew apace. The boy and girl were ardent lovers all through High school, and the fact that Miss Irma was the daughter of wealthy and admiring parents and had a social career in prospect didn't make a difference with the lovers. Irma was elected the captain of the girl's basket ball team, and Howard was made the captain of the Hughes football team. Both the "captains" graduated in the class of 1902 of old Hughes. Mr. Fenker entered the business world, and Irma went off to Baltimore to school. But the love of yesteryear did not fade, and a steady correspondence was maintained, and the wedding Wednesday was the result. Mr. Fenker and his bride have fitted up a dainty flat in Avondale[:LIND]

Some observations on this application:

• There is a [:CR:] code before the first centered section (in this case in the Sentence, before the [M] variable, but it could have been within the memo itself just as well) to set it off from the introductory line if text.
• Since the closing [:CENTER] code includes a carriage return automatically, there is no need to add a [:CR:] code at the end of each centered line. In fact, the "Enter" I typed into the text effectively added a second [:CR:] code, so I got a blank line between each centered line. If I didn't want that, I'd have to run all the centered lines together in the memo and not press Enter at the end of each of them.
• The same is true after the last centered line, where a return is required to set off the left indented section. The last [:CENTER] code includes a carriage return automatically and there is no need to add one. The "Enter" I typed in effectively adds a second one, so again there is a blank line between the last centered heading and the indented text.
• I did not put a [:CR:] code at the end, after the final [:LIND] code because I want a citation to appear there. But one is required to set that paragraph off from the following normal text, so the next Tag must begin with a [:CR:] code.

Copyright 2000-2008