FrameMaker tips article in Indus

FrameMaker iconI recently contributed an article on my favorite FrameMaker tips to Indus, the newsletter of the India chapter of STC. Check out the article here!

Embed a TOC in a FrameMaker document

FrameMaker iconLet’s discuss an easy way to embed a file-level TOC in a FrameMaker document. We’ll generate a standalone TOC for the document and then import it by reference into the same document.

Here’s how:

  1. Open the FrameMaker document.
  2. Click Special > Table of Contents. When FrameMaker prompts if you want to create a standalone TOC, say Yes.
  3. In the Set Up Table of Contents dialog, select the paragraph tags that you want to include in the TOC. Click Set. FrameMaker creates a separate TOC file and stores it in the directory where your FrameMaker document is stored.
  4. Open the new TOC and format it as necessary. You may want to change the font styles/sizes for the TOC paragraphs and set tab stops/leaders.
  5. 1.jpg

  6. Now, open the parent FrameMaker document, place the cursor at the intended insertion point (usually the beginning of the file), and then click File > Import > File. Select the external TOC file and click Import.
  7. Retain the default settings in the Import Text Flow by Reference dialog box and click Import. FramaMaker imports the TOC by reference into the parent document.
  8. 2.jpg

Now, whenever you update the external TOC, simply select the embedded text inset in the parent document and click Update in the Text Inset Properties pod.

3.jpg

Here’s some further suggested reading:

Top ten FrameMaker conversion tips

Simon Bate has posted his top ten FrameMaker conversion tips over at the Scriptorium blog. Pretty interesting stuff! Do take a look.

As for our FrameMaker tips that he refers to in his post, you can download the PDF from this link.

Enjoy!

RoboHelp: Printed documentation error

The Word VBA macro version registered is incorrect. Please reinstall printed documentation.

If you encounter the above error message while trying to generate printed documentation from a RoboHTML project, change the macro security settings in Microsoft Word.

Follow these steps to change the macro security settings in Word 2007:
  1. Click the Office button > Word options > Trust Center > Trust Center Settings.
  2. Change Macro Settings to Enable all macros and then click OK.
  3. Generate printed documentation output from RoboHTML.
Peter Grainge has a useful page on his website summarizing RoboHelp print issues. Do take a look!