You are using a browser which doesn't fully support Cascading Style Sheets. This site will look much better in a browser that supports web standards, but its content is accessible to any browser or Internet device.
Reference, but do not link
It might not have been obvious in the previous chapters, but the
type
option is - optional. The reason for that is that is has a default, which is
plain
and just means "do not link".
So we can have a reference that is no link? Yes, we can. And it makes sense in various situations.
First, the text a reference produces is the same whether we make it a link or not. And this text by default is the tag body. So
\REF{name=There type=linked}<there> \REF{name=There type=plain}<there>
only differ in the fact that "there" is made a link in the first case, and pure text in the second.
Yes,
\REF{name=There type=plain}<there>
(or
\REF{name=There}<there>
) produces the same result as the plain, pure text
there
. Although this doesn't seem to make sense on first sight, it makes things consistent - it can be used the same way in all cases. Think of
bodyless references:
// use a sequence number in an image title Image \SEQ{name="block graph" type=images}. ... // make page number a link Looking at the \REF{type=linked name="block graph"}. image, we see that the block graph ... // insert the page number, but // without linking Looking at the \REF{type=plain name="block graph"}. image, we see that the block graph ... // same using default values Looking at the \REF{ name="block graph"}. image, we see that the block graph ...
All we need to do in the last two example paragraphs is to have a number that corresponds to the sequence number, we do not need to make it a link. It's for exactly that case that
plain
was invented.
In the same way, references to page titles and page numbers of a reference target are often used to insert just that title or number, not a link to them.
As mentioned in the \REF{name=There valueformat=pagenr}>. chapter ("\REF{name=There valueformat=pagetitle}>"), ...