Using different text for a cross reference

[fifelaura]

Hi all

My user guide has several section title pages, which detail what users will find in the chapters in that particular section.

I've been asked to create a link from each bullet in the section page to the relevant chapter.

I don't want to include the chapter title in the bullets in the section page.

For example

My first chapter is called "Getting Started".

Before this chapter, there is a "section file", which says something like

"This section contains details of the following:

• How to get started with product
• Information contained in chapter 2
• information contained in chapter 3"

I want users to be able to click on the text "How to get started with product" and be taken directly to the start of chapter 1.

I don't want the bullet in the section page to read "Getting started".

Is there a way to do this?

Thanks in advance

Laura

[Jeff_Coatsworth]

I’ve never used it, but you may want to investigate the hyperlink commend to accomplish what you want

[Bob_Niland]

> ... hyperlink commend to accomplish what you want ...

That seems to work, most of the time.

It's some work to set up, as you need to:

1. Insert a unique Hypertext newlink marker at the target.
2. Prepare a hypertext area at the link text desired (whole para or Character Format tagged region thereof).
3. Insert a Hypertext gotolink marker, pointing at the newlink marker at the target.

And you may need to enable Named Destinations in the PDF generation.

It does avoid polluting the Xref Format catalog, and avoids stewardship issues with hidden text (but I'm not sure HT markers are much more obvious to future maintainers).

[fifelaura]

Thanks for this, everyone, esp Error7103.

Couple of notes for anyone else using this:

Use "Specify Named Destination" and "Jump to Named Destination" respectively for the two items from the drop-down list.

If you're jumping to a link in another file, make sure you add the .fm extension to the file name. Took me a while to work this out!

Laura

[fifelaura]

Hmmm, have just encountered a problem when trying to link to a file which is in a different folder from the one that the source file is in.

FM acts very strangely. Although the link I've put in is correct, FM interprets it wrongly. When I click OK, the path in the error message is copied to the Syntax box in the dialog.

All the files are on a network drive, and the Management Interfaces is in a different folder from the rest.

Seems impossible to add a link here, which is irritating as it means some of my bullets will link to destinations and others will not.

Anyone know if this is a bug?

[fifelaura]

Have just found this link on the web which seems to deal with this problem:

http://helpx.adobe.com/framemaker/kb/framemaker-cannot-find-document-referenced.html

However, I still cannot get it to work.

[Arnis Gubins]

Laura,

FM tries to interpret any characters following a slash ("\")  as special symbols. You have to use the  "/" as a separator for the folders instead.

[Bob_Niland · Accepted solution]

> FM tries to interpret any characters following a slash ("\")  as special symbols.

Does escaping the backslash with a second \\ fix that?

> You have to use the  "/" as a separator for the folders instead.

Basically, FM defaults to Unix notation internally for file paths (forward slashes) even on Windows.

[fifelaura]

Thank you thank you both of you.

Forward slashes did the trick. At last!

[Bob_Niland]

What you want is a cross-reference marker Definition of type <$MarkerText>.

FM doesn't have that, although it's been on the wishlist for at least 15 years.

A couple of alternatives:

• For a small number of such Xrefs, create a new Cross-Reference formats specific to each text required, for example:
  Name: Getting_Started
  Definition: How to get started with product
  Xref to the real heading using this Xref format.
• Put some Run-In hidden text at the target, for example:
  ParaTag: Heading2.hid
  text: How to get started with product
  Xref to the hidden by normal <$paratext>.