28.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:

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

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 PI marker.

See also:

§16.7 Jumping to secondary windows in Help systems

§16.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 PI marker

If you need case-by-case handling of jumps to other windows, put a PI marker of type LinkTarget, with marker content the name of the window, anywhere before the relevant HyperJump PI marker.

Previous Topic:  28.3.3 Linking to an arbitrary location

Next Topic:  28.5 Converting DITAcross-reference links to HTML

Parent Topic:  28. Creating HTML links

Sibling Topics:

28.1 Understanding sources of links

28.2 Specifying link appearance

28.3 Specifying link destination

28.5 Converting DITAcross-reference links to HTML

28.6 Linking to other files and other DITA2Go projects

28.7 Linking to external destinations