Adobe FrameMaker: What to know about working with generated files
By Barb Binder, Adobe Certified Instructor on FrameMaker
FrameMaker will happily create, or generate, files for you. A table of contents, a list of tables, a list of figures, a list of effective pages and an index are all examples of generated files. They are fairly easy to set up, and once working, you can update them as you update your book, so they will always reflect the latest edits.
That said, there are a set of rules that all generated files follow. Work within the rules, and these files work like a dream. If you don’t know the rules, or try to break the rules, it quickly becomes a nightmare. (Note: These rules apply to all versions of unstructured FrameMaker.)
Here are the key rules to successfully managing generated files:
- Initial formatting. A new generated file will copy the formatting commands from the first non-generated file the book window. Problems in that file will be copied to the generated files, so finalize the first non-generated file before you start adding generated files to your book. Examples of formatting that is copied into the new generated file include the paper size, margins, columns, headers, footers, colors, etc.
- Filenames. Generated files always use the bookname + suffix.fm. For example, if my book name is Press.book and the suffix for a table of contents is TOC, the table of contents is automatically named PressTOC.fm.
- Book icons. Generated files use an orange and black icon in the book window to distinguish them from user files, which have an orange and white icon.
- Paragraph styles. Paragraph styles are assigned automatically to the generated text, and their names will end with the suffix for the generated file.
- Edits. Never type on a generated page! If you type on a generated page and then update your book, FrameMaker will remove your edits. If you see a typo in a generated file, fix it on the body page and update your book.
- Document title. The only exception to “Never type on a generated page!” is made for a document title. If you want to add a document title to a generated page it must be the first paragraph in the flow, and its paragraph style name cannot end with the suffix for that type of generated file. For example, in a table of contents, the title style can be named ContentsTitle, but FrameMaker will remove it if you name it ContentsTitleTOC.
- Controlling the presentation. Changes to the presentation of the generated files are made on the reference pages. For example, a table of contents has a TOC reference page. An index has an IX reference page. You can rearrange the building blocks to change the order of presentation, or replace the default space in front of the page numbers with a tab. Remember that reference page changes don’t take effect until you update your book.
- Editing your initial choices. If you made a mistake when you were setting up the generated file, you can right click the file in the book window > Set up XXX, where XXX is equal to the type of generated file you are working with. For example, if you forgot to add a heading level to the TOC, right-click the TOC in the book window and choose Set up Table of Contents. Add the missing heading and update your book.
Feel free to ask a specific question about the generated files using the form at the bottom of this post. I am also available for hourly, online coaching and can help you set up your own basic generated file in about an hour. See One-on-One Online Coaching.