Category Archives: FrameMaker

Style Overrides in FrameMaker

One of the reasons I prefer FrameMaker over Word, is that it doesn’t automagically update your paragraph styles as you work. Word has a tendency to either add new items to the list when you make a tweak (Normal, Normal but Bold, Normal but Italic, Normal but 12pt and blue…), or to modify an existing style to match your one-off customization, and all of a sudden a paragraph two chapters back is mysteriously rendering in 14pt instead of 10 and when you fix it that extra-large warning note you were working on earlier has gone back to 10pt “all by itself”. There are settings buried in the software to determine what exactly happens when you modify a style, and where the change propagates to, but Word works in mysterious ways, and I just don’t have the time or energy to figure it all out.

I favour the simple elegance of how FrameMaker does things:

  • FrameMaker Status Bar showing Paragraph and Character StylesThe paragraph and character styles for the selected text are shown in FrameMaker’s status bar.
  • FrameMaker Status Bar showing Modified Paragraph StyleIf there’s a manual override to a paragraph style (for example, a change of font), an asterisk appears beside the style name in FrameMaker’s status bar.

If there is a manual override, you can check what the original definition is in the Paragraph Designer, and decide whether the override is justified or not.

If an override is justified:

  • For a genuine one-off situation, you might want to just leave the override in place. Bear in mind, that if you reimport styles and say to remove overrides, you’ll lose the modification at that point.
  • For a recurring situation, you might want to create a new style. For example, if you want the first paragraph of every section to be blue and italic to designate it as introductory material, that’s worth a new style. (Click Commands | New Format in the Paragraph Designer.)
  • If you decide the override is one you’d like to see everywhere this paragraph style is used, then you’ll want to update the existing style to match the modified version. (Click Update All in the Paragraph Designer.)
  • And finally, if you decide the override is invalid, you should just re-apply the correct style instead and move on. (Click Reset in the Paragraph Designer.)

Simple and elegant. Me likey.

Disappearing Text in PDFs – Part 2

Following on from a post I wrote a while back on text that was present in the source file, but mysteriously vanished on saving to PDF, here’s a similar incident I encountered with a different resolution.

In this case, again authoring in FrameMake, I was working on a number of reference manuals in the range of 500-800 pages long a piece. All was going well until it came time to publish one of the longer books as a PDF. On checking the generated file to make sure all looked well, I skimmed through quickly. First few pages, fine… next few pages, fine… next few pages, … hang on – what’s that big gap there about?… next few pages, now all the tables are blank!… skip quickly to the end… all that’s left is the header/footer rulings!

Starting over and saving the PDF again gave the same results – in fact, it looked like problems might just be happening earlier and earlier in the document each time.

First port of call was a few “turn it off and back on again”s. First the software, then the whole machine. After a reboot, the same problem kept recurring.

Next stop, fiddling with Acrobat settings, with an occasional reboot for good measure. Still no joy.

A bit of a Google, trying out a few random suggestions, and finally I hit on the solution that worked: delete the font cache (C:\Windows\System32\FNTCACHE.DAT (that’s .DAT – not .dll! Don’t mess with your .dlls or you’ll go blind!)), reboot, save the pdf immediately.

The font cache is regenerated when you reboot, so if the same problem arises again, lather, rinse and repeat.

In the case of the document I was working on, I had to delete the font cache and reboot between every save of the document or text started disappearing again. Depending on the length and complexity of the document you’re working on, your mileage may vary.

Disappearing text in PDFs – Part 1

There’s little more frustrating than finishing writing a lengthy document, with minutes to go to a deadline, clicking Save as PDF with a heavy sigh of relief that everything’s finally done, then opening the final PDF for a last once-over before drawing a line under the project, only to discover that – GAH! – a bunch of text is missing! But it was there the last 20 times you generated draft PDFs! What’s happened?

I’ve had text disappear from PDFs mysteriously twice in the last year, both with different causes and solutions, and I had a heck of a time trying to find a solution both times. This post is on the most recent, and more obscure, problem.

I was working on a FrameMaker document that contained a series of tables of data. All had gone swimmingly through several iterations of the draft document, but when I generated the final PDF for publication, the text from the first cell had disappeared in 80% of the tables. Odd.

I saved again with the same result. Still missing. I rebooted my machine and tried again, still missing. Updated my software, still missing. I checked the help but couldn’t find a description of my problem. Not even google could help me out. This was getting annoying.

I went back to the dud PDF and discovered that if I tried to select the missing text in the affected cells, I could copy and paste it from the PDF to a text file, so it was actually there, just invisible.

So, probably a font issue? I modified the text properties to use a different font, different size, different colour. Nada. I edited the PDF settings in Acrobat Distiller to embed all fonts all the time, never substitute fonts, increase the resolution, decrease the resolution… You name it, I tried it, but the cell contents remained obstinately invisible.

Back in the source files, I tried recreating tables and changing font settings, but nothing worked.

Finally, I gave up my investigations, grabbed a cuppa and vented at a colleague. He described a similar problem he’d had when working in PowerPoint. In that instance,  a background had rendered in front of the content on saving to PDF, so to fix the problem he selected the background and sent it to back in the source file. Food for thought.

I decided to check out the table properties in FrameMaker, and there it was: row backgrounds were set to white. But the page was already white, so I could safely remove that. I set the background to None instead for the affected tables, saved as PDF one more time, and my invisible content reappeared. Huzzah!

Still no idea why the problem affected first content cells only, or only a random subset of the tables in the document, but if I ever encounter disappearing content in table cells again, I’ll be checking out my cell background properties first.

A completely different cause of and solution to text disappearing when FrameMaker files were saved as PDFs is covered here.