FrameMaker 7.0 Tutorial:
Book Building & Tables of Contents
FrameMaker version 9 tutorials are now available.
This tutorial is provided for advanced documentation students on a free, as-is
basis, without guarantee of accuracy. If you find any errors or think we should
include other tasks, let us know!
This tutorial discusses the following topics:
Subsequent tutorials focus on tags, tables,
anchored frames, graphics,
pages, reference pages, cross-references,
text, book building, conversion
techniques, and structured documents.
These tutorials provide an overview of each topic discussed. If you required
information about advanced FrameMaker topics, refer to the Adobe FrameMaker
User Guide or Adobe FrameMaker Classroom in a Book for the current
version of FrameMaker.
|| Note: For the sake of brevity, we use an abbreviated
style for menu commands throughout this lesson. For example, "Select File
> New" means "Select New from the File menu."
A book is a FrameMaker file that joins several files together to form one document.
The book file includes the filenames of the individual documents, as well as any
generated files. (For more information about indexes as generated files, see Indexes.)
The files in a book can be numbered continuously throughout the book, or they
can contain their own number settings and pagination. When you update a book,
the generated files, as well as cross-references and variables, are updated
across all documents.
A table of contents can be generated from either a single document or a book.
The document or book from which the table of contents is generated is called the
source document. For this tutorial, the source document has already been
created for you.
Downloading and Saving the Source Documents
To download the source documents:
- Select each of the following links and save them one your computer:
|| Note: Earlier versions of Netscape may attempt
to display this file directly. To force Netscape to download this file,
right-click the link above, and select Save Link Target As.
- Select the directory in which to save the file, and click Save.
||Note: If you are working in the TCM computer
lab, save the file to your lab account. If you do not have a lab account,
please contact your instructor.
To save the source documents:
- Open FrameMaker, and select File > Open.
- Change to the directory in which you saved the source documents.
- Open each .mif file, and select File > Save As.
- Select the directory in which to save each file.
- In the File name box, change .mif to .fm.
- Click Save.
Adding Automated Chapter Numbers and Footers to Files
Modify the three files so that their chapter numbers and footers will increment and update automatically:
- Open headings.fm.
- With your cursor located in the text at the top of the document (either a Heading1 or Title tag), open the Paragraph Designer.
- In the autonumbering blank of the Numbering tab, type Chapter <chapnum>.
- Click Update All.
- Click Format > Page Layout > Pagination and select Double Sided and Make Page Count Even.
- Switch to master pages and set a left-aligned page number in the footer of the left page.
- In that same footer, add a space, an em dash (Ctrl+q, Shift+q), and the book title to the right of the page number. The result should look similar to the following:
- Set a right-aligned page number in the footer of the right page.
- In that same footer, add the variable for the chapter title: click Special > Variable and select Running H/F 1. Click Edit Definition, change the name of the paragraph tag in brackets to Heading1 (or whatever your document uses for the chapter title). Click Edit and then Insert. The result should look similar to the following:
- Open lists.fm and notices.fm.
- With lists.fm as the current file, click File > Import > Format and import everything from headings.fm into the lists.fm. Do the same for notices.fm.
Setting Up By-Chapter Page Numbering
To enable each file in your book to pick up the chapter number automatically and add it it to the page number in the footer:
- Go to the master pages in one of your files.
- Double-click the # (page number symbol).
- In the variable popup, select Current Page.
- Click Edit Definition and add <$chapnum>- just in front of <$curpagenum>:
- Click Edit and then Replace.
Building Book Files
Next, build a book by adding source files to the book file.
To build a book file:
- Select Window > headings.fm to view the headings.fm file.
- Select File > New > Book.
The following message appears.
- Click Yes to continue.
Your new book contains one document file.
- Select File > Save Book.
- In the File Name box, type myBook.book, and click Save.
- With the book file active, select Add > Files (or click
in the book window).
- Select lists.fm, and click Add.
The file is added to the book immediately following headings.fm.
- Repeat the previous steps to add notices.fm to your book.
Your book should look similar to the following.
Tip: You can rearrange files within the book window
by selecting the file and dragging it to a new location. To delete a file
from the book, select the file and click
located at the bottom of the book window.
Setting up Page Numbering and Pagination
After you the add documents to your book file, you can set up page numbers and
pagination to be consistent across all documents in the book.
To set up page numbering:
To set up pagination, do the following to each of the three files:
- In the book window, select headings.fm, and then select Format
> Document > Numbering.
The Numbering dialog box appears.
- From the Chapter tab, select the Chapter # option, and type 1
in the text box.
- From the Format: pull-down menu, select Numeric .
- From the Page tab, select the First Page # option, and type 1
in the text box.
- From the Format pull-down menu, select Numeric .
- Click Set.
- In the book window, select lists.fm, and then select Format
> Document > Numbering.
- From the Chapter tab, select Continue Numbering From Previous File in
- From the Page tab, select Continue Numbering From Previous Page in Book,
and click Set.
- Repeat the previous steps to set the page numbering for notices.fm.
- Select Format > Page Layout > Pagination.
- From the Pagination dialog box, select Double Sided.
- From the 1st Page Side pull-down menu, select Right, and click Set.
Generating the Table of Contents
In this section, you will learn how to generate a table of contents (TOC) for
a single document.
To generate a table of contents:
- Select Special > Table of Contents, and click Yes
to create a standalone Table of Contents for this document.
The Set Up Table of Contents dialog box appears.
- In the Don't Include list, select the Heading1 and Heading2 paragraph tags and press the left arrow to include them in the Include Paragraphs Tagged list.
- Click Set.
A new file containing the table of contents appears. Framemaker names this file
using the name of the source document plus the suffix "TOC."
Formatting the Table of Contents
To make your table of contents more readable, you must format the contents. This
section discusses procedures necessary to format your table of contents.
This section discusses the following topics:
Changing Paragraph Formats and Fonts
To change paragraph formats in the TOC:
- Open the Paragraph Designer (Ctrl + M).
- Place your cursor in the first paragraph.
This paragraph is called Heading1TOC and contains the text "Headings"
- In the Paragraph Designer, click the Basic tab, and select 14.0 pt (if it is not already set) from the
Space Above Pgf pull-down menu.
- Click the Default Font tab.
- Change Family to Arial and Size to 14 pt, and then click Update All.
- Place your cursor in the second paragraph, which should be a Heading2TOC.
- In the Default Font properties box, change Family to Arial and Size to 12 pt, and
then click Update All.
All Heading2TOC paragraph tags change to Arial 12 pt.
- Within the Indents area, type 0.5 in the First box, and then type
0.5 in the Left box.
- Click Update All, and save your document.
- To see the results of some TOC formatting, you must make the book window current and click Edit > Update Book.
Adding Tabs and Tab Leaders
To add a tab stop and tab leader:
- Place your cursor in the first paragraph (Heading1TOC).
- Insert a right tab and leader:
- Within the Paragraph Catalog, click Edit located below the Tab
Stops area on the Basic tab.
- In the New Position box, type 5.5.
- Within the Alignment area, select the Right radio button.
- Create another tab, this one 5.1, left-aligned, with a leader-dot style.
- Click Continue, and then click Update All.
- Repeat the steps above to add a right tab to the Heading2TOC paragraph format. The result should look similar to the following (although some page numbers have been invented):
- Close the Paragraph Designer dialog box.
- Make sure the tab symbols are visible (select View > Text Symbols),
and place your cursor in the first paragraph between the word "Headings" and
the page number "1."
- Press the Tab key.
The page numbers should be right-aligned preceded by a dot leader.
- Repeat the steps above to insert a tab between the remaining paragraphs.
||Note: These changes affect the paragraph tags and
are now part of this document file. Whenever you update the table of contents,
it will retain its formatting. However, the tab symbols that you typed
between the text and the page number are not part of the paragraph tag.
If you want FrameMaker to automatically insert your tab symbols after a
TOC update, you must modify the reference page.
To ensure that the dot-leader tabs are retained in updates of the TOC, modify the TOC reference page:
- Select View > Reference Pages.
- Scroll down to the TOC reference page. (The title of the reference page
appears in the FrameMaker scroll bar.)
The reference page should look similar to the following.
- Place your cursor in the first paragraph between the <$paratext> and
the <$pagenum> building blocks.
This paragraph should be Heading2TOC. This may seem backwards: the items are listed in reverse order.
- Delete the space between the building blocks, and press the Tab key.
- Repeat the steps above for Heading1TOC.
- Select View > Body Pages to return to the body pages, and
then save your document.
Your table of contents should look similar to the following.
If you look closely at the preceding, you notice that the dot leaders of the first-level items do not align evenly with those of the second-level items.
There is no viable solution for the alignment problem involving dot leaders. However, you’ll notice that TOCs typically do not display page numbers or dot leaders for the chapter title. To make this change:
- Open the TOC file.
- Go to the TOC page of the reference pages. For the basics on reference pages, see the reference page tutorial.
- Find the Heading1TOC tag and delete the dots leaders and the <$pagenum> building block. Your results should like similar to the following:
Displaying Chapter Numbers
To display chapter numbers in the table of contents and add some interesting format:
- Create a character tag named blue_bold that uses Arial 16pt blue bold.
- In the Paragraph Designer for Heading1TOC, add a left tab of 0.5 inches.
- In the reference pages for the TOC, type <$chapnum>, highlight it, and apply the blue_bold character tag to it.
- Between <$chapnum> and <$paratext> insert a tab. The results should resemble the following:
||Note: Using <n+> in the Numbering tab of the paragraph tag for Heading1TOC is an alternative the preceding steps. However, if you change numbering style (for example, uppercase letters as opposed to arabic numerals), the TOC will not update accordingly.
Inserting a Title
To insert a title for the table of contents:
- Place your cursor at the very beginning of the first paragraph. (Press the
Home key to ensure you are at the beginning.)
- Type the word CONTENTS, and press Enter.
- Return to the line you just typed, and place your cursor anywhere in this
- Apply the paragraph tag Title to this paragraph, and save your document.
Updating the Table of Contents
As your document changes, you must update your table of contents so that it remains
To update the table of contents:
To enable an update to work when the chapter order changes:
- Select the main book file in the book window.
- Select Edit >
- Select your book in the Generate window.
- Press update.
FrameMaker updates your table of contents to reflect the change.
In this tutorial, you learned how to generate a table of contents, customize the
formatting of the contents page, and update the table of contents.
- Go to the master pages, press Enter to create a new line.
- Apply the tag in the TOC that contains the chapter number (for example, Heading1TOC).
- On this line, enter something like Chapter <$chapnum>. <$paratext></span> to it.
- Test this by switching the order of a chapter or two in your .book file.
Remember: if one of the files you switch is the first chapter file, you must change its Chapter and Page settings to Continue from previous. If you have a new first chapter, one that was originally later in the .book file, you must change its Chapter and Page settings to 1.
Information and programs provided by firstname.lastname@example.org.