Adobe FrameMaker: Creating a simple glossary for a book
by Barb Binder, Adobe Certified Instructor on FrameMaker
Updated: Mar 07, 20203
FrameMaker is a master at generating lists. You can quickly create a chronologic list of headings with page numbers (AKA a table of contents), or a chronologic list of TableTitles (AKA a list of tables) or an alphabetized list like an index. A glossary list is just an alphabetized index of terms with their accompanying definitions, and is a terrific asset to any technical manual that uses terms that your audience may not know when they open your manual for the first time.
(Note: this process describes how to generate a glossary for print or published to PDF. If you are exporting to HTML5 or WebHelp, etc. you will want to follow the steps listed in Adobe’s Helpx file on glossaries so that the if the user encounters a term in the content, the user can find the definition dynamically. Google: “helpx FrameMaker glossary”)
Here’s how to create a simple glossary for the back of your book with terms and their definitions:
- Select a term that you would like to add to your glossary. In this example, I am selecting the word “Hue”.
- Choose Special > Marker. The selected word will appear automatically in the Marker panel.
- Change the marker type to Glossary (on the top row). Then add a colon and the definition after the term. (The colon serves to separate the term from its definition.) Click the New Marker button.
- Repeat this process for all of the terms you would like to add to your glossary.
- When you are ready to generate the glossary, select the last file in your book window. Choose Insert > Index of > Markers.
- Use the left-pointing arrow to move Glossary from the Don’t Include list on the right to the Include Markers of Type list on the left. Click Add.
- FrameMaker generates the glossary. From this point on, treat this file like any other generated index.
- You can add the title to the top of the page—but don’t forget to name the title with a paragraph tag that doesn’t end with the suffix for the generated file (in this case, IOM) or it will disappear when you update your book.
- Use the Paragraph Designer to format the title, GroupTitlesIOM, Level1IOM and Level2IOM paragraphs.
- Use the Reference Pages to control the presentation, including resizing those pesky page numbers after you update your book.