[Framers] Best way to import/add select paragraph formats?

Robert Lauriston robert at lauriston.com
Fri Mar 27 09:59:26 PDT 2020


>From an old job, this is the documented procedure for creating a new book.
This is probably overkill for your question but it covers the TOC issue.

1. In Perforce, do a Get Latest Revision on the Shared directory.

2. Create an appropriate directory (e.g. Install or OnlineHelp) under the
\Documentation\<Product>\ directory.

3. Copy MyCompanyStyles.fm (body) and MyCompanyFrontMatter.fm from
\Documentationo\Shared\to the new directory.

4. Select both copies, right-click, select Properties, uncheck Read-only,
and click OK.

5. Rename the copies appropriately, for example, ProductUserGuide.fm and
ProductUserGuideFrontMatter.fm. (Do not use spaces or slashes in FrameMaker
file names.)
6. Open the body file, select all text, and delete.

7. Type the name of the first chapter (usually “Welcome to <ProductName>”
for a user guide, or “System Requirements” for an installation guide)
followed by two returns.
8. Format the chapter title with the ChapterTitle paragraph tag.

9. Place the cursor at the end of the file, select File > Import > File,
make sure Import By Reference is selected, navigate to the
\Documentation\Shared directory, double-click the file
AdditionalResourcesAndSupportInfo.fm, make sure the settings are as shown
at right, and click OK.
10. Save the body file.

11. Select File > New > Book, click Yes to add the body file, and save the
book with an appropriate name, for example, Product.book.

12. Close the body file, leaving the book open.

13. Select Add > Files, find the front-matter file, and double-click it.

14. Select Add > Table of Contents, double-click ChapterTitle, Heading1,
and Heading2 to move them to the left column, click Add, and click Update.

15. In the error log window that appears, click the Unresolved Text Inset
link and click OK.

16. The front-matter file will open. Scroll to the second page, click the
copyright boilerplate, select File > Import > File, make sure Import By
Reference is selected, navigate to the \Documentation\Shared directory,
double-click MyCompanyLegal.fm, make sure the settings are as shown at
right, and click OK.

NOTE:. The gray box at the top of the first page is an EPS drawing of the
company logo. Framemaker can’t render it, hence the gray box, but it will
appear correctly when you generate a PDF.
17. Scroll back up to the top of the document, double-click
BookNameVariable, and click Edit Definition.

18. In the Definition field, enter the book's title (for example, “Product
User Guide”), click Done, and click Replace.

19. Save and close the front-matter file.

20. Close the Book Error Log window.

21. Restore the TOC file window (minimized at the bottom of the FramemMaker
workspace).

22. At the top of the page, type “Table of Contents” followed by a return,
format it with the ~TOCTitle paragraph tag, then save and close the file.

23. If this is a user guide or some other document long enough to require
an index (installation guides typically do not), select Add > Standard
Index, click Add, and click Update.

24. Restore the minimized IX file window.

25. At the top of the page, type “Index” followed by a return, format it
with the ~IndexTitle paragraph tag, then save and close the file.

26. Drag the file entries in the book up or down to put them in the proper
order (front matter, TOC, body, index).

27. Open the front-matter file

28. With the front-matter file open, return to the book file, select all
the other files, and select File > Import > Formats.

29. From the Import from Document drop-down, select the front-matter file.

30. Click Deselect All, select Variable Definitions, and click Import.
(Remember to do this again any time you edit the BookNameVariable to change
the title of the book.)

31. Close the front-matter file.

32. Select all files in the book, right-click, and select Numbering.

33. Select the Chapter tab and select Continue Numbering from Previous Page
in Book.

34. Select the Page tab, select Continue Numbering from Previous Page in
Book, and click Set.

35. Select Edit > Update Book, check Apply Master Pages, click Update, and
click OK.

36. Save the book.


More information about the Framers mailing list