Broken cross-references in PDFs

[Fred Ridder]

You are correct when you surmise that cross-references that are
contained in text insets are not converted to hyperlinks in a PDF
produced from FrameMaker. I wish it were otherwise, but it is not.

The only way to produce a working hyperlink inside a text inset is
to use an explicit hypertext marker rather than a cross-reference.
Unfortunately, the text of the hyperlink "hot spot" will no longer
be updated by FrameMaker since it is no longer a cross-reference.
If the numbering or wording of the hyperlink's target paragraph
changes, you'll have to update the string in the text inset manually.

My opinions only; I don't speak for Intel.
Fred Ridder
Intel
Parsippany, NJ


>From: "C L" <cll01821 at lycos.com>
>To: <techwr-l at lists.techwr-l.com>
>Subject: Broken cross-references in PDFs
>Date: Fri, 29 Sep 2006 17:15:48 -0400 (EDT)
>
>
>    After reading recent e-mails from Donna Jones, Shlomo Perets, and Fred
>     Ridder, I attempted to fix the numerous broken cross-references in a
>                              PDF, to no avail.
>
>
>                                 Environment:
>
>                             FrameMaker 7.0, p578
>
>                        Adobe Acrobat 6.0 Professional
>
>
>                         FrameMaker File Information:
>
>       QS_InstallConfigUseSSOP.fm is the primary file. The file uses 10
>       conditional tags (to generate 10 PDFs, one per vendor platform).
>
>        The primary file contains 7 text insets, including one called
>                         "InstallingTWAINDriver.fm".
>
>    InstallingTWAINDriver.fm uses 5 conditional tags (one for each vendor
>                            using TWAIN drivers).
>
>     For the Sharp version of the book, I set the conditions in this file
>           to show the "twainSharp" and "STESharp" condition tags.
>
>      A sentence in InstallingTWAINDriver.fm, which is a conditionalized
>      text inset, contains a cross-reference to a procedure in the same
>                           file, on the next page.
>
>
>                         PDF Generation Information:
>
>                 I print to a PS file and then run Distiller.
>
>
>                                   Problem:
>
>    The PDF does not contain a link for the cross-reference I've described
>    (along with many others). (I've been troubleshooting the problem using
>    the primary file and the text inset file rather than generating a PDF
>                       for the entire book each time.)
>
>
>               What I've Done, and Still No Link in the PDF (:
>
>    Removed the target cross-reference in the text inset file, updated the
>    text inset in the primary file, updated the cross-references, and then
>                            generated the PS file.
>
>    Kept the primary file and the text inset file open when generating the
>                                   PS file.
>
>                  Selected the Named Destinations check box.
>
>               "Showed All" conditions in the text inset file.
>
>                  Select a different cross-reference format.
>
>
>      In Shlomo's posting of 9/7/2006, he said: "If the expected link is
>     simply not present in the PDF (but other links/bookmarks do exist),
>         this has to do with the cross-reference being part of a text
>       inset." What's not clear to me from this posting is whether it's
>    impossible to create working links when a cross-reference is part of a
>                                 text inset.
>
>
>                   All help will be appreciated, as always
>
>
>                                    Carol
>^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
>WebWorks ePublisher Pro for Word features support for every major Help
>format plus PDF, HTML and more. Flexible, precise, and efficient content
>delivery. Try it today! http://www.webworks.com/techwr-l
>
>Easily create HTML or Microsoft Word content and convert to any popular 
>Help file format or printed documentation. Learn more at 
>http://www.DocToHelp.com/TechwrlList
>
>---
>You are currently subscribed to TECHWR-L as docudoc at hotmail.com.
>
>To unsubscribe send a blank email to
>techwr-l-unsubscribe at lists.techwr-l.com
>or visit 
>http://lists.techwr-l.com/mailman/options/techwr-l/docudoc%40hotmail.com
>
>
>To subscribe, send a blank email to techwr-l-join at lists.techwr-l.com
>
>Send administrative questions to lisa at techwr-l.com. Visit
>http://www.techwr-l.com/techwhirl/ for more resources and info.
>

_________________________________________________________________
Search—Your way, your world, right now!  
http://imagine-windowslive.com/minisites/searchlaunch/?locale=en-us&FORM=WLMTAG