\ref

Syntax

\ref[...][ref]
[...]	t p r s e
[ref]

Description

This command looks up some property of some reference (e.g., a section, example, figure or custom reference made with \reference).

You should not normally have to use this command. Links are better made using \in or \at, which are more conceptual (and create a clickable link as well).

If you want to implement some custom command for building references, this command is useful. You might also want to use the \goto command for making the reference clickable.

This commands takes two arguments. The first is the property of the reference you want to display:

p   The "user" page number on which the label is
r   The real page number on which the label is
s   The number of the section in which the label is
t   The "text" of the label
e   The "extra text" of the label

Note that the "text" and "extra text" seem to refer to the same text on MkIV. For custom labels, this is the second argument to the \reference command.

The second argument is the label of the reference you want to refer to.

Example

See also

\in, \at, \reference, \goto

Help from ConTeXt-Mailinglist/Forum

All issues with:

• ref (as subject; in the source)