<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML//EN">
<html>
<head>
<title>MHonArc Resources: TTOPBEGIN</title>
</head>
<body>
<address>
<a href="../resources.html#ttopbegin">MHonArc Resource List</a>
</address>
<hr>
<h1>TTOPBEGIN</h1>
<!-- *************************************************************** -->
<hr>
<h2>Syntax</h2>
<dl>
<dt><strong>Envariable</strong><dt>
<dd><p>N/A
</p>
</dd>
<dt><strong>Element</strong><dt>
<dd><p><br>
<code><TTOPBEGIN><br></code>
<var>markup ...</var><br>
<code></TTOPBEGIN><br></code>
</p>
</dd>
<dt><strong>Command-line Option</strong><dt>
<dd><p>N/A
</p>
</dd>
</dl>
<!-- *************************************************************** -->
<hr>
<h2>Description</h2>
<p>TTOPBEGIN defines the markup for the <em>root</em>, or start,
of a thread. TTOPBEGIN should define any starting markup
for the thread and markup for the root message of the thread.
</p>
<!-- *************************************************************** -->
<hr>
<h2>Default Setting</h2>
<pre>
<b><TTopBegin></b>
<LI><STRONG><a href="#SUBJECT">$SUBJECT$</a></STRONG>,
<EM><a href="#FROMNAME">$FROMNAME$</a></EM>
<b></TTopBegin></b>
</pre>
<!-- *************************************************************** -->
<hr>
<h2>Resource Variables</h2>
<table border=1>
<tr bgcolor="#C0C0C0">
<th>Variable</th><th>Value</th>
</tr>
<tr valign=top>
<td align=center><a name="A_ATTR" href="../rcvars.html#A_ATTR"><strong><code>$A_ATTR$</code></strong></a></td>
<td>The <tt>NAME</tt> and <tt>HREF</tt> attributes to use in an anchor to link to the archived message. The <tt>NAME</tt> attribute links the messages to the index page.</td>
</tr>
<tr valign=top>
<td align=center><a name="A_HREF" href="../rcvars.html#A_HREF"><strong><code>$A_HREF$</code></strong></a></td>
<td>The <tt>HREF</tt> attribute to use in an anchor to link to the archived message.</td>
</tr>
<tr valign=top>
<td align=center><a name="A_NAME" href="../rcvars.html#A_NAME"><strong><code>$A_NAME$</code></strong></a></td>
<td>The <tt>NAME</tt> attribute to use in an anchor for messages to link to the index page.</td>
</tr>
<tr valign=top>
<td align=center><a name="DATE" href="../rcvars.html#DATE"><strong><code>$DATE$</code></strong></a></td>
<td>The date of the message.</td>
</tr>
<tr valign=top>
<td align=center><a name="DDMMYYYY" href="../rcvars.html#DDMMYYYY"><strong><code>$DDMMYYYY$</code></strong></a></td>
<td>Message date in dd/mm/yyyy format.</td>
</tr>
<tr valign=top>
<td align=center><a name="ENV" href="../rcvars.html#ENV"><strong><code>$ENV$</code></strong></a></td>
<td>Value of an environment variable.</td>
</tr>
<tr valign=top>
<td align=center><a name="FROM" href="../rcvars.html#FROM"><strong><code>$FROM$</code></strong></a></td>
<td>The complete text in the <tt>From:</tt> field of the message.</td>
</tr>
<tr valign=top>
<td align=center><a name="FROMADDR" href="../rcvars.html#FROMADDR"><strong><code>$FROMADDR$</code></strong></a></td>
<td>The e-mail address in the <tt>From:</tt> field of the message.</td>
</tr>
<tr valign=top>
<td align=center><a name="FROMADDRDOMAIN" href="../rcvars.html#FROMADDRDOMAIN"><strong><code>$FROMADDRDOMAIN$</code></strong></a></td>
<td>The e-mail address domain of the <tt>From:</tt> field of the message.</td>
</tr>
<tr valign=top>
<td align=center><a name="FROMADDRNAME" href="../rcvars.html#FROMADDRNAME"><strong><code>$FROMADDRNAME$</code></strong></a></td>
<td>The e-mail address "username" (or local-part) of the <tt>From:</tt> field of the message.</td>
</tr>
<tr valign=top>
<td align=center><a name="FROMNAME" href="../rcvars.html#FROMNAME"><strong><code>$FROMNAME$</code></strong></a></td>
<td>The human name of the person in the <tt>From:</tt> field of the message. If no human name is found, the username specified in the e-mail address is used.</td>
</tr>
<tr valign=top>
<td align=center><a name="ICON" href="../rcvars.html#ICON"><strong><code>$ICON$</code></strong></a></td>
<td>The context-type sensistive icon.</td>
</tr>
<tr valign=top>
<td align=center><a name="ICONURL" href="../rcvars.html#ICONURL"><strong><code>$ICONURL$</code></strong></a></td>
<td>The URL to the context-type sensistive icon.</td>
</tr>
<tr valign=top>
<td align=center><a name="MMDDYYYY" href="../rcvars.html#MMDDYYYY"><strong><code>$MMDDYYYY$</code></strong></a></td>
<td>Message date in mm/dd/yyyy format.</td>
</tr>
<tr valign=top>
<td align=center><a name="MSGGMTDATE" href="../rcvars.html#MSGGMTDATE"><strong><code>$MSGGMTDATE$</code></strong></a></td>
<td>GMT date of current message.</td>
</tr>
<tr valign=top>
<td align=center><a name="MSGID" href="../rcvars.html#MSGID"><strong><code>$MSGID$</code></strong></a></td>
<td>The message-id of the message.</td>
</tr>
<tr valign=top>
<td align=center><a name="MSGLOCALDATE" href="../rcvars.html#MSGLOCALDATE"><strong><code>$MSGLOCALDATE$</code></strong></a></td>
<td>Local date of current message.</td>
</tr>
<tr valign=top>
<td align=center><a name="MSGNUM" href="../rcvars.html#MSGNUM"><strong><code>$MSGNUM$</code></strong></a></td>
<td>The message number assigned to the message by MHonArc (includes leading zeros).</td>
</tr>
<tr valign=top>
<td align=center><a name="MSGPREFIX" href="../rcvars.html#MSGPREFIX"><strong><code>$MSGPREFIX$</code></strong></a></td>
<td>Filename prefix for message files.</td>
</tr>
<tr valign=top>
<td align=center><a name="MSGTORDNUM" href="../rcvars.html#MSGTORDNUM"><strong><code>$MSGTORDNUM$</code></strong></a></td>
<td>The ordinal message number of the current discussion thread.</td>
</tr>
<tr valign=top>
<td align=center><a name="NOTE" href="../rcvars.html#NOTE"><strong><code>$NOTE$</code></strong></a></td>
<td>Message annotation.</td>
</tr>
<tr valign=top>
<td align=center><a name="NUMFOLUP" href="../rcvars.html#NUMFOLUP"><strong><code>$NUMFOLUP$</code></strong></a></td>
<td>Number of explicit follow-ups to the message.</td>
</tr>
<tr valign=top>
<td align=center><a name="ORDNUM" href="../rcvars.html#ORDNUM"><strong><code>$ORDNUM$</code></strong></a></td>
<td>The current listing number of the message.</td>
</tr>
<tr valign=top>
<td align=center><a name="SUBJECT" href="../rcvars.html#SUBJECT"><strong><code>$SUBJECT$</code></strong></a></td>
<td>The subject text of the message, and if no arguments, wrapped in an anchor element that hyperlinks to the message.</td>
</tr>
<tr valign=top>
<td align=center><a name="SUBJECTNA" href="../rcvars.html#SUBJECTNA"><strong><code>$SUBJECTNA$</code></strong></a></td>
<td>The subject text of the message without the anchor element.</td>
</tr>
<tr valign=top>
<td align=center><a name="YYYYMMDD" href="../rcvars.html#YYYYMMDD"><strong><code>$YYYYMMDD$</code></strong></a></td>
<td>Message date in yyyy/mm/dd format.</td>
</tr>
</table>
<!-- *************************************************************** -->
<hr>
<h2>Examples</h2>
<p>MHonArc has several resources for customizing
thread page layout. Therefore the following shows a way to
customize the layout using the various thread resource
available.
</p>
<p>For this example,
The thread index is setup where a thread will have the subject
in bold at the top of the thread and the names of the authors
of the messages in the thread will be hyperlinked to the
actual message. Nested unordered lists are used to provide a
visual cue of the depths of the thread.
Unique messages are show in normal text.
</p>
<pre>
<!-- TTOPBEGIN is the markup for the beginning of a thread, and the
first message in a thread.
-->
<b><TTOPBEGIN></b>
<p>
<li><a <a href="#A_NAME">$A_NAME$</a>><strong><a href="#SUBJECTNA">$SUBJECTNA$</a></strong></a><br>
<a <a href="#A_HREF">$A_HREF$</a>><a href="#FROMNAME">$FROMNAME$</a></a>
<b></TTOPBEGIN></b>
<!-- <a href="ttopend.html">TTOPEND</a> is the markup for closing a main thread.
-->
<b><<a href="ttopend.html">TTOPEND</a>></b>
</li>
</p>
<b></TTOPEND></b>
<!-- <a href="tlitxt.html">TLITXT</a> is the markup for a message *within* a thread
-->
<b><<a href="tlitxt.html">TLITXT</a>></b>
<li><a <a href="#A_ATTR">$A_ATTR$</a>><a href="#FROMNAME">$FROMNAME$</a></a>
<b></TLITXT></b>
<b><<a href="tliend.html">TLIEND</a>></b>
</li>
<b></TLIEND></b>
<!-- <a href="tsingletxt.html">TSINGLETXT</a> is the markup for a message not in a thread. I.e.
it does not start a thread or is part of a thread.
-->
<b><<a href="tsingletxt.html">TSINGLETXT</a>></b>
<li><a <a href="#A_NAME">$A_NAME$</a>><a href="#SUBJECTNA">$SUBJECTNA$</a></a>,
<a <a href="#A_HREF">$A_HREF$</a>><a href="#FROMNAME">$FROMNAME$</a></a>
</li>
<b></TSINGLETXT></b>
<!-- <a href="tsubjectbeg.html">TSUBJECTBEG</a> is any markup at the beginning of a sub-thread that
is based on the subject of the message. We just put in a
comment declaration so the reader will see nothing.
-->
<b><<a href="tsubjectbeg.html">TSUBJECTBEG</a>></b>
<!-- Possible follow-ups -->
<b></TSUBJECTBEG></b>
</pre>
<p>An item to note is how the example includes the proper resource
variables, <tt>$A_NAME$</tt> and <tt>$A_ATTR$</tt>, to allow the
index hyperlinks in messages to behave properly.
</p>
<!-- *************************************************************** -->
<hr>
<h2>Version</h2>
<p>2.0
</p>
<!-- *************************************************************** -->
<hr>
<h2>See Also</h2>
<p>
<a href="tlitxt.html">TLITXT</a>,
<a href="tsingletxt.html">TSINGLETXT</a>,
<a href="tsubjectbeg.html">TSUBJECTBEG</a>,
<a href="ttopend.html">TTOPEND</a>
</p>
<p>
<a href="../layout.html"><strong>Page Layout</strong></a>
</p>
<!-- *************************************************************** -->
<hr>
<address>
00/10/28 11:13:12<br>
<img align="top" src="../monicon.gif" alt="">
<a href="http://www.pobox.com/~ehood/mhonarc.html"><strong>MHonArc</strong></a><br>
Copyright © 1997-1998, <a href="http://www.pobox.com/~ehood/">Earl Hood</a>, <a href="mailto:mhonarc@pobox.com">mhonarc@pobox.com</a><br>
</address>
</body>
</html>
distrib
>
Mandriva
>
8.2
>
i586
>
media
>
contrib
>
by-pkgid
>
61dabb0b59bf11e80f1327c065cec842
>
files
>
277
