About Arbortext Styler > Adding Generated Text > Creating Repeating Titles
  
Creating Repeating Titles
You can use generated text to output repeating titles in your document. A repeating title repeats the content of a title element when the element breaks across columns or pages. You can set the title to repeat at the top of the column or page after it breaks across a column or page, or at the bottom of a column or page before it breaks.
Note that you can only implement a repeating title for print or PDF output.
Example: Creating a Repeating Title
This procedure describes how to automatically repeat a table's title when the table breaks across a page. The title will repeat at the top of the following page.
1. In Arbortext Editor, open the transport.xml document located at Arbortext-path/samples/styler
2. Choose Styler > Edit Stylesheet to open the stylesheet currently associated with the document for edit. This is a read only stylesheet so you will need to save a local copy if you want to make amendments.
3. In Arbortext Styler, select the table element in the Elements list, and apply the Formal Block style to it via the Edit > Style menu option.
4. In Arbortext Editor, click in the title for the table “Titanic II's Destinations” in Chapter 2. Revert to Arbortext Styler and note that the title context that applies to this title is highlighted in the Elements list.
5. With the context (in this instance title in table anywhere in chapter) selected in the Elements list, go to the Generated text category in the properties area.
6. In the Repeat title or continuation text (Print/PDF only) field, set the At top after break field to Yes.
7. Click the Edit button next to the At top after break list. The Generated Text Editor opens.
8. Select the default text (cont'd) and replace it with continued.
This is an image of the Generated Text Editor for the title in table anywhere in chapter, showing a Space element, followed by an ElementContent element, followed by a space and the text “continued”
9. Choose File > Apply and Close to save the generated text setting and exit the editor. The description of the title in table anywhere in chapter context contains the property Gentext: Repeating Title (yes) for the selected output.
10. In Arbortext Editor, locate the table titled “Titanic II's Destinations,” copy the first row of the table, and paste it into the table five or six times.
11. In Arbortext Styler, choose Preview > Print.
In the Print Preview window, note that when the “Titanic II's Destinations” table splits across pages, the title Titanic II's Destinations continued displays at the top of the table on the following page.
In Arbortext Styler, choose Preview > HTML File.
In the browser window, note that when the “Titanic II's Destinations” table splits across pages, the table does not break and hence there is no need for a title for the table on a following page. This is because the repeating title feature only applies for print or PDF output.
Controlling Space Before or After Repeating Titles
Print engines take different spacing measures into account when assessing the space to be output before or after a repeating title:
Spacing after titles that repeat At top after break
PTC ALD refers to the Space after settings for both the title and _sfe:RepeatingTitle. It merges the two values using the normal rules for vertical space merging:
1. The space with the highest priority setting wins
2. If priorities are the same, the largest space is used, except:
3. If both priorities are the same and have the value force, the two spaces are added
FOSI and XSL-FO refer to the Space after setting for _sfe:RepeatingTitle.
Space after settings are made in the Spacing category for elements, contexts, and conditions.
Spacing before titles that repeat At bottom before break
PTC ALD refers to the Space after setting for the block immediately preceding the repeating title and the Space before setting for _sfe:RepeatingTitleBottom. It merges the two values using the normal rules for vertical space merging (see above):
FOSI and XSL-FO refer to the Space before setting for _sfe:RepeatingTitleBottom.
Space after and Space before settings are made in the Spacing category for elements, contexts, and conditions.