[Prev: NEXTBUTTONIA] | [Resources][TOC] | [Next: NEXTLINKIA]

# NEXTLINK

- Syntax
- Description
- Default Setting
- Resource Variables
- Examples
- Version
- See Also

## Syntax

Envariable

  N/A

Element

  `<NEXTLINK>
  ` markup ...
  `</NEXTLINK>
  `

Command-line Option

  N/A

## Description

NEXTLINK defines the value for the `$LINK(NEXT)$` resource variable when there is a next message to the current message according to the message list order of the main index. NEXTLINK is analagous to NEXTBUTTON, but is intended to provide a more descriptive link to the next message.

See the NEXTLINKIA for defining the value of `$LINK(NEXT)$` when there is no next message.

## Default Setting

    <NextLink>
    <li>Next by sort-type:
    <strong><a href="$MSG(NEXT)$">$SUBJECT(NEXT)$</a></strong>
    </li>
    </NextLink>

sort-type will be a string that relects the sort method in effect.

## Resource Variables

Variable | Value
--- | ---
`$ATTACHMENTURL$` | Base URL to attachments
`$BUTTON$` | Button markup linking to a message.
`$DATE$` | The date of the message.
`$DDMMYYYY$` | Message date in dd/mm/yyyy format.
`$DOCURL$` | URL to documentation.
`$ENV$` | Value of an environment variable.
`$FROM$` | The complete text in the `From:` field of the message.
`$FROMADDR$` | The e-mail address in the `From:` field of the message.
`$FROMADDRDOMAIN$` | The e-mail address domain of the `From:` field of the message.
`$FROMADDRNAME$` | The e-mail address "username" (or local-part) of the `From:` field of the message.
`$FROMNAME$` | The human name of the person in the `From:` field of the message. If no human name is found, the username specified in the e-mail address is used.
`$GMTDATE$` | Current GMT date.
`$ICON$` | The content-type sensitive icon.
`$ICONURL$` | URL to the content-type sensitive icon.
`$ICONURLPREFIX$` | Value of ICONURLPREFIX resource.
`$IDXFNAME$` | Filename of main index page.
`$IDXLABEL$` | Label for main index page.
`$IDXPREFIX$` | Prefix of filenames of main index pages.
`$IDXSIZE$` | Max number of messages that may be listed in index page.
`$IDXTITLE$` | The title of the main index page.
`$LINK$` | Link markup linking to a message.
`$LOCALDATE$` | Current local date.
`$MMDDYYYY$` | Message date in mm/dd/yyyy format.
`$MSG$` | Filename of message.
`$MSGGMTDATE$` | GMT date of current message.
`$MSGHFIELD$` | Message header field
`$MSGID$` | The message-id of the message.
`$MSGLOCALDATE$` | Local date of current message.
`$MSGNUM$` | The message number assigned to the message by MHonArc (includes leading zeros).
`$MSGPREFIX$` | Filename prefix for message files.
`$MSGTORDNUM$` | The ordinal message number of the current discussion thread.
`$NOTE$` | Message annotation.
`$NUMFOLUP$` | Number of explicit follow-ups to the message.
`$NUMOFMSG$` | Number of messages in the archive.
`$NUMOFPAGES$` | Number of index pages.
`$ORDNUM$` | The current listing number of the message.
`$OUTDIR$` | Pathname of archive.
`$PROG$` | Program name
`$SUBJECT$` | The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.
`$SUBJECTNA$` | The subject text of the message without the anchor element.
`$TIDXFNAME$` | Filename of thread index page.
`$TIDXLABEL$` | Label for thread index page.
`$TIDXPREFIX$` | Prefix of filenames of thread index pages.
`$TIDXTITLE$` | Title of thread index.
`$TLEVEL$` | Numeric level of message in thread, starting with 0.
`$TSLICE$` | A slice of the thread listing relative to the current message. Size of slice determined by the TSLICE resource.
`$VERSION$` | Program version.
`$YYYYMMDD$` | Message date in yyyy/mm/dd format.

## Examples

The following shows an alternative to the default setting by including the author of the next message:

    <NextLink>
    <li>Next by Date:
    <strong><a href="$MSG(NEXT)$">$SUBJECT(NEXT)$</a></strong>,
    <em>$FROMNAME(NEXT)$</em>
    </li>
    </NextLink>

## Version

1.2

## See Also

BOTLINKS, NEXTLINKIA, PREVLINK, PREVLINKIA, TNEXTLINK, TNEXTLINKIA

[Prev: NEXTBUTTONIA] | [Resources][TOC] | [Next: NEXTLINKIA]