Omni Systems, Inc.

  

Mif2Go User's Guide, Version 55

  

Valid HTML 4.01!

 

Made with Mif2Go

19 Creating HTML links > 19.4 Creating jumps to particular windows for HTML


19.4 Creating jumps to particular windows for HTML

You can assign a particular window type as a jump destination. A window assignment can specify jumps the following ways:

all jumps from a character or paragraph format

all jumps to a particular file or URL

individual jumps to a particular window.

A window assignment supplies a value for the target attribute of the <a href=...> tag Mif2Go generates for the jump. If you are using framesets that value must be the name of a frame (see §13.14 Using framesets), possibly one of several names reserved by JavaScript, such as _top or _blank:

A jump to _top gets you out of a frameset; it does not open a new window.

A jump to _blank always opens a new window.

A jump to a window with a non-reserved name, if the window is not in the current frameset (if any), opens a window of that name; and the next jump to the same name reuses that same window. You can specify target windows the following ways:

Specify window by jump format

Specify window by jump destination

Specify window with a marker.

See also:

§7.7 Jumping to secondary windows in Help systems

§7.8 Creating pop-up topics for Help systems

Specify window by jump format

You can use a character format to mark all jumps to a particular window type. For example:

[Targets]

; doc format = name of frame to use for jumps from within this style

; For OmniHelp ALink and KLink jumps, targets make no sense

;  and are ignored.

JumpNew=_blank

If you know that such jumps always occur in a particular type of paragraph, such as Step paragraphs in procedures, you could use a paragraph format. For example:

[Targets]

Step*=procwin

Specify window by jump destination

If you know that all jumps to a particular HTML page (such as glossary.htm) should go to a particular window type, you can specify the window to use for that page. For example:

[TargetFiles]

; filename (no ext) or URL destination = target frame to be used

; a URL destination is the last element in the URL (no extension)

glossary=glosswin

Specify window with a marker

If you need case-by-case handling of jumps to other windows, put a marker of type LinkTarget (see §29.2 Adding custom marker types), with marker content the name of the window, anywhere before the relevant hypertext jump marker.



19 Creating HTML links > 19.4 Creating jumps to particular windows for HTML