www.delorie.com/gnu/docs/hyperbole/hyperbole_51.html

search

	Buy GNU books!

Hyperbole User Manual

7.7 Links

Hyperlinks may be embedded in cells and may refer to other cells or external sources of information. Explicit Hyperbole buttons may be created as usual via mouse drags, Creation Via Action Key Drags. A klink is a special implicit link button, delimited by <> separators, that jumps to a specific outline cell. This section discusses klinks.

Press the Action Key over a klink to follow it. This will flash the klink as a button and then will display its referent in the other window. If the klink contains a view spec, that will be used when the referent is displayed.

There are a number of easy ways to insert klinks into koutlines. If you have mouse support under Hyperbole, simply click the Action Key within the indentation to the left of a cell text. If you then double click on some cell, a link to that cell will be inserted where you started. From a keyboard, use {C-c l} when in a koutline or {C-h h o l} when not in a koutline to insert a klink. Since klinks are implicit buttons, you can type in the text of the klink just as you see it in the examples below and it will work exactly as if it had been entered with the insert link command.

There are basically three forms of klinks:

@bullet{internal}

<@ 2b=06> is an internal klink, since it refers to the koutline in which it is embedded. When activated, it jumps to the cell within the current outline which has permanent id `06' and relative id `2b'. <@ 06> does the same thing, as does <@ 2b>, though this latter form will not maintain the link properly if the cell is moved elsewhere within the outline. The form, <@ 2b=06 |ben> additionally sets the view spec of the current outline back to the default value, with a blank line between each cell and all levels and lines of cells displayed.

@bullet{external}

The second klink format is an external link to another koutline, such as, <EXAMPLE.kotl, 3=012 |c1e>, which displays the named file, starting at the cell 3 (whose permanent identifer is 012), with the view specification of: blank lines turned off, cutoff after one line per cell, and show ellipses for cells or trees which are clipped.

@bullet{view spec}

The third format simply allows you to set a view spec for the current koutline. For example, <|ben>, when activated, sets the view in the current outline to display blank lines, ellipses following collapsed lines and standard alphanumeric numbering.