Error! Bookmark not defined

This forum is for all Flare issues related to PDF, eBook, Microsoft Word, Adobe FrameMaker, XPS, and XHTML book targets.

Error! Bookmark not defined

Postby NigelBennett on Tue May 21, 2019 2:04 am

I updated an existing documentation set, and when I built the Word output, for "no apparent reason" a number of cross-references suddenly presented as Error! Bookmark not defined. These same x-references appear fine in HTMLHelp and WebHelp outputs. A small proportion of the x-refs in the output are affected. I've tried replacing some of the x-refs in the documents; sometimes this works, sometimes it doesn't. Any suggestions as to cause and solution will be gratefully received.
Confirmit, Oslo
Propeller Head
Posts: 68
Joined: Mon Jun 25, 2007 5:41 am
Location: Oslo, up north

Re: Error! Bookmark not defined

Postby Nita Beck on Tue May 21, 2019 6:51 am

I've seen this when the xref points to a bookmark within a topic, rather than to the topic itself. I haven't figured out a workaround, I'm afraid. Given that I use Word output only for review purposes, I've trained my reviewers not to fret about what appears to be a broken xref in the Word doc. Sorry I can't offer any advice. :(
Content Strategist / Information Architect / Flare Consultant:
Manager, Rochester Flare User Group:
Nita Beck
Senior Propellus Maximus
Posts: 3350
Joined: Thu Feb 02, 2006 9:57 am
Location: Pittsford, NY

Re: Error! Bookmark not defined

Postby Curlyshell on Fri May 31, 2019 9:57 am

I go through this regularly. It's one of the reasons I'm actually looking forward to working entirely in Flare...should I ever master the mess.

In Word, most people work with the codes hidden, as it would be very distracting to have them show. Also, we usually view field codes as their output, not their codes. The downside is that you can sometimes delete or mess with a code without realizing. This goes for bookmarks, index entries, and numbered headers.

For example, if you position the cursor at the end of the last word in a heading, and press <enter> to get a new line, and add whatever content—you might be bringing an index entry down there with you. Or you might be messing with a bookmark or other reference. Same goes for any time you move text or whole sections around.

After I reindex in Word, I always do a search for error! and, in my particular case, Section 0 (because that catches MY references to numbered headings I've moved incorrectly or deleted).

You can also accidentally move text into a section you've bookmarked for the sake of a mini TOC, and then find more in your mini TOC than you bargained for.

Before exporting, importing, PDFing, publishing, etc., I suggest you do the following:

    <ctrl>-A to select the whole document and reindex.
    In File > Options > Advanced, scroll down to Show Document Content.
    Under Field Shading, choose Always so you'll see all field codes in gray.
    Now, zoom way out in your document (if it's long) and start scrolling through. Pass your eye over any fields you see. Are they weird or just weirdly long? Then it's possible you are referencing a bookmark that has more stuff inside it than you meant to put.
    Once you've fixed anything broken, <ctrl-A> to select the entire document and reindex again.
    do another quick search for error! and your equivalent to Section 0 (whatever will tell you there's no there there).
    If you had to fix anything, do a final reindex of the whole document.

I hope this is helpful! It's nice to have something to contribute. I don't know much about Flare, but I know lots about Word!

Shelley List
"I'm a technical writer, not a developer," she said...
Propeller Head
Posts: 34
Joined: Fri Mar 01, 2019 9:14 am

Return to Printed Documentation Targets

Who is online

Users browsing this forum: No registered users and 7 guests