### 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:

- 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 DITA2Go generates for the jump. If you are using framesets that value must be the name of a frame (see §22.13 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 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 DITA cross-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 DITA cross-reference links to HTML

28.6 Linking to other files and other DITA2Go projects

28.7 Linking to external destinations

Table of Contents • Index