MailManManagementGuideListinfo < CF

CF Web>Email>MailManManagement>MailManManagementGuide>MailManManagementGuideListinfo (2021-01-06, AdrianPepper) (raw view)
EditAttach
<!--
   * Set MMHTTP = %URLPARAM{"mmhttp" default="https://"}%
   * Set MMLISTNAME = %URLPARAM{"mmlist" default="sample"}%
   * Set MMLIST = %URLPARAM{"mmlist" default="list-name-parameter"}%
   * Set MMHOST = %URLPARAM{"mmhost" default="lists.uwaterloo.ca"}%
   * Set MMMM = %URLPARAM{"mmmm" default="/mailman/"}%
-->

---+ Adrian Pepper's Guide to Mailman List Listinfo Maintenance


   * (rendered for '[[%MMHTTP%%MMHOST%%MMMM%listinfo/%MMLIST%][%MMLISTNAME%]]' list)

Authenticate as adminstrator for a list, and then view this page as [[https://cs.uwaterloo.ca/twiki/view/CF/MailManManagementGuideListinfo?mmlist=%MMLIST%&mmhost=%MMHOST%&mmmm=%MMMM%&mmhttp=%MMHTTP%][https://cs.uwaterloo.ca/twiki/view/CF/MailManManagementGuideListinfo?mmlist=LISTNAME]] but replace the word LISTNAME with the actual name of your list. (Perhaps you have already done that...) 

For further hints, including for off-campus, see preface of  [[https://cs.uwaterloo.ca/twiki/view/CF/MailManManagementGuide?mmlist=%MMLIST%&mmhost=%MMHOST%&mmmm=%MMMM%&mmhttp=%MMHTTP%][https://cs.uwaterloo.ca/twiki/view/CF/MailManManagementGuide]].

%TOC%

---++ Preface

_How [[%MMHTTP%%MMHOST%%MMMM%listinfo/%MMLIST%][%MMHTTP%%MMHOST%%MMMM%listinfo/%MMLIST%]] looks can sometimes be important to users of the list.  But for some reason, it often gets overlooked and left at its default,_

Over the years, the initial author of this TWiki page developed a few templates and guiding principles for that maintenance and subsequently attempted to list them here.

---++ Essential Information
   * Look of the '[[%MMHTTP%%MMHOST%%MMMM%listinfo/%MMLIST%][listinfo]]' page can be edited by the administrator at
   [[%MMHTTP%%MMHOST%%MMMM%edithtml/%MMLIST%/listinfo.html][%MMHTTP%%MMHOST%%MMMM%edithtml/%MMLIST%/listinfo.html]].

---++ Guiding principles
   * Never put information specific to a list direcly in the html page
   * Avoid giving readers information they do not need
   * Avoid giving readers information you do not want them to know
      * Many mailman lists are for broadcast, and concepts such as subscription and unsubcription are not relevant in those cases

---++ Details (with Templates)
   Notice how initially the name '%MMLIST%' (or '%MMLISTNAME%') does not appear literally in the text in the textbox.  Instead it is referred to via "macro" =MM-List-Name=.  Similarly, no details specific to the list, such as its description/purpose appear there either (instead macro MM-List-Description).

   A goal when modifying [[%MMHTTP%%MMHOST%%MMMM%edithtml/%MMLIST%/listinfo.html][%MMHTTP%%MMHOST%%MMMM%edithtml/%MMLIST%/listinfo.html]] is to keep it that way.

---+++ Prerequisites
   The following should be defined as indicated (though emptiness is handled)

   * MM-List-Description - via [[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/description][description]]
   * MM-List-Info - via [[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/info][info]]
And possibly change alphabetic case of ...
   * MM-List-Name - via [[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/real_name][real_name]]

(all actually appear as choices on [[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general][%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general]] and that is actually a better place to change them)

In particular, [[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/info][info]] can be almost arbitrarily long and complex, using HTML codes for effect, etc.  That is how you should "personalize" the page so it applies only to one list.  ( [[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/description][description]] is the brief summary to put in one line; [[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/info][info]] should actually be longer and be rendered as several paragraphs).

   Aside: Perhaps it is not obvious, but, in fact, simply setting and validating the above three values will result in a mostly useful and readable [[%MMHTTP%%MMHOST%%MMMM%listinfo/%MMLIST%][listinfo]] page.  If [[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/info][info]] is accurate, the page should be accurate, but it will be a bit long and offer the reader options you likely don't really want them to be bothered with.  Further trimming the HTML at [[%MMHTTP%%MMHOST%%MMMM%edithtml/%MMLIST%/listinfo.html][%MMHTTP%%MMHOST%%MMMM%edithtml/%MMLIST%/listinfo.html]] can undo that, resulting in a more easily comprehended page.


---++ Templates
   Over the years, the original author had created a number of templates, which meet the preceding goals, but alter the appearance of [[%MMHTTP%%MMHOST%%MMMM%listinfo/%MMLIST%][listinfo]] (via [[%MMHTTP%%MMHOST%%MMMM%edithtml/%MMLIST%/listinfo.html][%MMHTTP%%MMHOST%%MMMM%edithtml/%MMLIST%/listinfo.html]] ) from its original length, complexity, and yet irrelevance, into something more terse, which can actually be easily replicated to other lists of similar type without alteration.

   The choices were named, in private files
   1 leaf-very-terse.html
   1 leaf-with-owner.html
   1 leaf-with-form.html
   1 umbrella-with-roster.html

   Records were kept of which School lists were set with which listinfo pages.

   Caveat: While an intention is that the templates following can be simply pasted into [[%MMHTTP%%MMHOST%%MMMM%edithtml/%MMLIST%/listinfo.html][%MMHTTP%%MMHOST%%MMMM%edithtml/%MMLIST%/listinfo.html]] to replace the text box contents, in fact there would be merit in doing functional analysis and minimizing the differences between the default you are given and a functional equivalent.  You might also want to retain revision control records for the changes you make (that cannot be done directly on the mailman web pages).

<!--
[[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/description][description]]

[[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/info][info]]

[[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/real_name][real_name]]
-->

I list the templates, and almost fell into the trap of listing examples of actual lists using each, but if I did that, those examples would be published to the entire potential viewership of https://cs.uwaterloo.ca/twiki .
<!-- Using first person is not preferred -->

<BR />
---+++ leaf-very-terse.html

This choice is excellent for listinfo we hardly ever expect any members to read.  It informs readers of the purpose of the lists, but divulges no hints about subscription or unsubscription--
[[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/description][description]] and
[[%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%/general?VARHELP=general/info][info]]
should indicate the purpose of this list, and therefore possibly the reason for the membership of members who read the page.


<!-- leaf-very-terse.html -->
<CENTER>
<TEXTAREA ROWS=10 COLS=80>
&LT;HTML>
  &LT;HEAD>
    &LT;TITLE>&LT;MM-List-Name> Info Page&LT;/TITLE>
  
  &LT;/HEAD>
  &LT;BODY BGCOLOR="#ffffff">

    &LT;P>
      &LT;TABLE COLS="1" BORDER="0" CELLSPACING="4" CELLPADDING="5">
	&LT;TR>
	  &LT;TD COLSPAN="2" WIDTH="100%" BGCOLOR="#99CCFF" ALIGN="CENTER">
	    &LT;B>&LT;FONT COLOR="#000000" SIZE="+1">&LT;MM-List-Name> --
	&LT;MM-List-Description>&LT;/FONT>&LT;/B>
	  &LT;/TD>
	&LT;/TR>
	&LT;tr>
	    &LT;td colspan="2">
	      &LT;p>&nbsp;
	    &LT;/td>
	  &LT;/tr>
	  &LT;tr>
	    &LT;TD COLSPAN="1" WIDTH="100%" BGCOLOR="#FFF0D0">
	      &LT;B>&LT;FONT COLOR="#000000">About &LT;MM-List-Name>&LT;/FONT>&LT;/B>
	    &LT;/TD>
	  &LT;/TR>
	    &LT;tr>
	      &LT;td colspan="2">
		&LT;P>&LT;MM-List-Info>&LT;/P>
	&LT;/TD>
      &LT;/TR>
      &LT;TR>
	&LT;TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
	  &LT;B>&LT;FONT COLOR="#000000">Using &LT;MM-List-Name>&LT;/FONT>&LT;/B>
	&LT;/TD>
      &LT;/TR>
      &LT;tr>
	&LT;td colspan="2">
	  To post a message to all the list members, send email to
	  &LT;A HREF="mailto:&LT;MM-Posting-Addr>">&LT;MM-Posting-Addr>&LT;/A>.

	&LT;/td>
      &LT;/tr>
    &LT;/TABLE>
    &LT;MM-Form-End>
    &LT;/ul>
    &LT;/td>
    &LT;/tr>
  &LT;/table>
&LT;MM-Mailman-Footer>
&LT;/BODY>
&LT;/HTML>
</TEXTAREA>
</CENTER>


Which renders approximately as follows:

<table width="100%" border=1 ><tr><td width="100%">
    <P>
      <TABLE width="100%" COLS="1" BORDER="0" CELLSPACING="4" CELLPADDING="5">
	<TR>
	  <TD COLSPAN="2" WIDTH="100%" BGCOLOR="#99CCFF" ALIGN="CENTER">
<!--	    <B><FONT COLOR="#000000" SIZE="+1"><MM-List-Name> -- -->
	    <B><FONT COLOR="#000000" SIZE="+1">%MMLIST% --
<!--	<MM-List-Description></FONT></B> -->
	in this case a sample list</FONT></B>
	  </TD>
	</TR>
	<tr>
	    <td colspan="2">
	      <p>&nbsp;
	    </td>
	  </tr>
	  <tr>
	    <TD COLSPAN="1" WIDTH="100%" BGCOLOR="#FFF0D0">
<!--	      <B><FONT COLOR="#000000">About <MM-List-Name></FONT></B> -->
	      <B><FONT COLOR="#000000">About %MMLIST%</FONT></B>
	    </TD>
	  </TR>
	    <tr>
	      <td colspan="2">
<!--		<P><MM-List-Info></P> -->
		<P><em>%MMLIST%</em> functions here as a sample list.
</P><P>
</P><P>
We use it here just to demonstrate the layout of the information page when the 
<em>leaf-very-terse</em> template is used.
Lots of text can be included here, in multple paragraphs, using HTML formatting.
</P>
	</TD>
      </TR>
      <TR>
	<TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
<!--	  <B><FONT COLOR="#000000">Using <MM-List-Name></FONT></B> -->
	  <B><FONT COLOR="#000000">Using %MMLIST%</FONT></B>
	</TD>
      </TR>
      <tr>
	<td colspan="2">
	  To post a message to all the list members, send email to
<!--	  <A HREF="mailto:<MM-Posting-Addr>"><MM-Posting-Addr></A>. -->
	  <A HREF="mailto:%MMLIST%@%MMHOST%">%MMLIST%@%MMHOST%</A>.

	</td>
      </tr>
<!-- </TABLE> -->
<!-- MM-Form-End> -->
<!-- Inclusion of <MM-Form-End> looks like an error -->
<!--    </ul> -->
<!-- </td> -->
<!-- </tr> -->
<!-- </table> -->
<!-- <MM-Mailman-Footer> -->
<tr><td>
<hr style="height:3px;border-width:0;color:black;background-color:black"> 
<address><a href="%MMHTTP%%MMHOST%%MMMM%listinfo/%MMLIST%">%MMLIST%</a> list run by <a href="mailto:%MMLIST%-owner@%MMHOST%">%MMLIST%-owner at %MMHOST%</a><br><a href="%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%">%MMLIST% administrative interface</a> (requires authorization)<br><a href="%MMHTTP%%MMHOST%%MMMM%listinfo">Overview of all %MMHOST% mailing lists</a><p>
<table WIDTH="100%" BORDER="0">
</td></tr>
  <tr>
    <td><img src="%MMHTTP%%MMHOST%/icons/mailman.jpg" alt="Delivered by Mailman" border=0><br>version 2.1.30rc1</td>
    <td><img src="%MMHTTP%%MMHOST%/icons/PythonPowered.png" alt="Python Powered" border=0></td>
    <td><img src="%MMHTTP%%MMHOST%/icons/gnu-head-tiny.jpg" alt="GNU's Not Unix" border=0></td>
  </tr>
<!-- -->
     </td>
    </tr>
     </TABLE> 
  </table>
</td></tr></table>

<BR />
---+++ leaf-with-owner.html

This choice augments the previous with an indication that the a suggestion that readers who think their membership should be added or removed can send email to the list owner.

<!-- leaf-with-owner.html -->
<CENTER>
<TEXTAREA ROWS=10 COLS=80>
&LT;HTML>
  &LT;HEAD>
    &LT;TITLE><MM-List-Name> Info Page</TITLE>
  
  &LT;/HEAD>
  &LT;BODY BGCOLOR="#ffffff">

    &LT;P>
      &LT;TABLE COLS="1" BORDER="0" CELLSPACING="4" CELLPADDING="5">
	&LT;TR>
	  &LT;TD COLSPAN="2" WIDTH="100%" BGCOLOR="#99CCFF" ALIGN="CENTER">
	    &LT;B><FONT COLOR="#000000" SIZE="+1"><MM-List-Name> --
	&LT;MM-List-Description></FONT></B>
	  &LT;/TD>
	&LT;/TR>
	&LT;tr>
	    &LT;td colspan="2">
	      &LT;p>&nbsp;
	    &LT;/td>
	  &LT;/tr>
	  &LT;tr>
	    &LT;TD COLSPAN="1" WIDTH="100%" BGCOLOR="#FFF0D0">
	      &LT;B><FONT COLOR="#000000">About <MM-List-Name></FONT></B>
	    &LT;/TD>
	  &LT;/TR>
	    &LT;tr>
	      &LT;td colspan="2">
		&LT;P><MM-List-Info></P>
	&LT;/TD>
      &LT;/TR>
      &LT;TR>
	&LT;TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
	  &LT;B><FONT COLOR="#000000">Using <MM-List-Name></FONT></B>
	&LT;/TD>
      &LT;/TR>
      &LT;tr>
	&LT;td colspan="2">
	  To post a message to all the list members, send email to
	  &LT;A HREF="mailto:<MM-Posting-Addr>"><MM-Posting-Addr></A>.

	&LT;/td>
      &LT;/tr>


      &LT;tr>
      &LT;td colspan="2">
         &LT;p>&nbsp;</p>
      &LT;/td>
      &LT;/tr>

      &LT;TR>
        &LT;TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
          &LT;B><FONT COLOR="#000000">Membership of <MM-List-Name></FONT></B>
        &LT;/TD>
      &LT;/TR>
      &LT;TR>
      &LT;TD COLSPAN="2" >
    &LT;MM-Subscribe-Form-Start>
&LT;p>Membership is maintained automatically, but if you really think you have been accidentally omitted, send email to <a href="mailto:<MM-Owner>"><MM-Owner></a>; send email there also if you are on the list, but really think you should not be.
&LT;/p>
      &LT;/TD>
      &LT;/TR>

    &LT;/TABLE>
    &LT;MM-Form-End>
    &LT;/ul>
    &LT;/td>
    &LT;/tr>
  &LT;/table>
&LT;MM-Mailman-Footer>
&LT;/BODY>
&LT;/HTML>
</TEXTAREA>
</CENTER>

This renders approximately as follows:

<table width="100%" border=1 ><tr><td width="100%">
    <P>
      <TABLE width="100%" COLS="1" BORDER="0" CELLSPACING="4" CELLPADDING="5">
	<TR>
	  <TD COLSPAN="2" WIDTH="100%" BGCOLOR="#99CCFF" ALIGN="CENTER">
<!--	    <B><FONT COLOR="#000000" SIZE="+1"><MM-List-Name> -- -->
	    <B><FONT COLOR="#000000" SIZE="+1">%MMLIST% --
<!--	<MM-List-Description></FONT></B> -->
	in this case a sample list</FONT></B>
	  </TD>
	</TR>
	<tr>
	    <td colspan="2">
	      <p>&nbsp;
	    </td>
	  </tr>
	  <tr>
	    <TD COLSPAN="1" WIDTH="100%" BGCOLOR="#FFF0D0">
<!--	      <B><FONT COLOR="#000000">About <MM-List-Name></FONT></B> -->
	      <B><FONT COLOR="#000000">About %MMLIST%</FONT></B>
	    </TD>
	  </TR>
	    <tr>
	      <td colspan="2">
<!--		<P><MM-List-Info></P> -->
		<P><em>%MMLIST%</em> functions here as a sample list.
</P><P>
</P><P>
We use it here just to demonstrate the layout of the information page when the 
<em>leaf-with-owner</em> template is used.
Lots of text can be included here, in multple paragraphs, using HTML formatting.
</P>
	</TD>
      </TR>
      <TR>
	<TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
<!--	  <B><FONT COLOR="#000000">Using <MM-List-Name></FONT></B> -->
	  <B><FONT COLOR="#000000">Using %MMLIST%</FONT></B>
	</TD>
      </TR>
      <tr>
	<td colspan="2">
	  To post a message to all the list members, send email to
<!--	  <A HREF="mailto:<MM-Posting-Addr>"><MM-Posting-Addr></A>. -->
	  <A HREF="mailto:%MMLIST%@%MMHOST%">%MMLIST%@%MMHOST%</A>.

      <tr>
      <td colspan="2">
         <p>&nbsp;</p>
      </td>
      </tr>

      <TR>
        <TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
<!--      <B><FONT COLOR="#000000">Membership of <MM-List-Name></FONT></B> -->
          <B><FONT COLOR="#000000">Membership of %MMLIST%</FONT></B>
        </TD>
      </TR>
      <TR>
      <TD COLSPAN="2" >
<!--  <MM-Subscribe-Form-Start> including this was a mistake? -->
<p>Membership is maintained automatically, but if you really think you have been accidentally omitted, send email to <a href="mailto:%MMLIST%-owner@%MMHOST%">%MMLIST%-owner@%MMHOST%</a>; send email there also if you are on the list, but really think you should not be.
</p>
      </TD>
      </TR>

    </TABLE>

<!--	</td> -->
<!-- </tr> -->
<!-- </TABLE> -->
<!-- </td> -->
<!-- </tr> -->
<!-- </table> -->
<!-- MM-Form-End> -->
<!-- Inclusion of <MM-Form-End> looks like an error -->
<!-- </ul> -->
<!-- <MM-Mailman-Footer> -->
<hr style="height:3px;border-width:0;color:black;background-color:black"> 
<address><a href="%MMHTTP%%MMHOST%%MMMM%listinfo/%MMLIST%">%MMLIST%</a> list run by <a href="mailto:%MMLIST%-owner@%MMHOST%">%MMLIST%-owner at %MMHOST%</a><br><a href="%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%">%MMLIST% administrative interface</a> (requires authorization)<br><a href="%MMHTTP%%MMHOST%%MMMM%listinfo">Overview of all %MMHOST% mailing lists</a><p>
<table WIDTH="100%" BORDER="0">
  <tr>
    <td><img src="%MMHTTP%%MMHOST%/icons/mailman.jpg" alt="Delivered by Mailman" border=0><br>version 2.1.30rc1</td>
    <td><img src="%MMHTTP%%MMHOST%/icons/PythonPowered.png" alt="Python Powered" border=0></td>
    <td><img src="%MMHTTP%%MMHOST%/icons/gnu-head-tiny.jpg" alt="GNU's Not Unix" border=0></td>
  </tr>
     </td>
    </tr>
  </table>
</td></tr></table>


<BR />
---+++ leaf-with-form.html

This choice augments the previous with a form for readers who think they should be subscribed, while retaining the email suggestion for users who think they should be removed.

<!-- leaf-with-form.html -->
<CENTER>
<TEXTAREA ROWS=10 COLS=80>
&LT;HTML>
  &LT;HEAD>
    &LT;TITLE><MM-List-Name> Info Page</TITLE>
  
  &LT;/HEAD>
  &LT;BODY BGCOLOR="#ffffff">

    &LT;P>
      &LT;TABLE COLS="1" BORDER="0" CELLSPACING="4" CELLPADDING="5">
	&LT;TR>
	  &LT;TD COLSPAN="2" WIDTH="100%" BGCOLOR="#99CCFF" ALIGN="CENTER">
	    &LT;B><FONT COLOR="#000000" SIZE="+1"><MM-List-Name> --
	&LT;MM-List-Description></FONT></B>
	  &LT;/TD>
	&LT;/TR>
	&LT;tr>
	    &LT;td colspan="2">
	      &LT;p>&nbsp;
	    &LT;/td>
	  &LT;/tr>
	  &LT;tr>
	    &LT;TD COLSPAN="1" WIDTH="100%" BGCOLOR="#FFF0D0">
	      &LT;B><FONT COLOR="#000000">About <MM-List-Name></FONT></B>
	    &LT;/TD>
	  &LT;/TR>
	    &LT;tr>
	      &LT;td colspan="2">
		&LT;P><MM-List-Info></P>
	&LT;/TD>
      &LT;/TR>
      &LT;TR>
	&LT;TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
	  &LT;B><FONT COLOR="#000000">Using <MM-List-Name></FONT></B>
	&LT;/TD>
      &LT;/TR>
      &LT;tr>
	&LT;td colspan="2">
	  To post a message to all the list members, send email to
	  &LT;A HREF="mailto:<MM-Posting-Addr>"><MM-Posting-Addr></A>.

	&LT;/td>
      &LT;/tr>


      &LT;tr>
      &LT;td colspan="2">
         &LT;p>&nbsp;</p>
      &LT;/td>
      &LT;/tr>

      &LT;TR>
        &LT;TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
          &LT;B><FONT COLOR="#000000">Membership of <MM-List-Name></FONT></B>
        &LT;/TD>
      &LT;/TR>
      &LT;TR>
      &LT;TD COLSPAN="2" >
    &LT;MM-Subscribe-Form-Start>
&LT;p>Membership is maintained automatically, but if you really think you have been accidentally omitted, enter and submit your information below.
&LT;/p>
&LT;p>
    &LT;span style="white-space:nowrap">
         &LT;label for="email" style="position; relative; left">Email:</label>
         &LT;input id="email" type="text" name="email" size="23" value="" />
    &LT;/span>
    &LT;span style="white-space:nowrap">
         &LT;label for="fullname" style="position; relative; left">Name:</label>
         &LT;input id="fullname" type="text" name="fullname" size="19" value="" />
    &LT;/span>
         &LT;input type="Submit" name="email-button" value="Submit" />
&LT;/p>

&LT;p>Or you can simply send email to <a href="mailto:<MM-Owner>"><MM-Owner></a>; send email there also if you are on the list, but really think you should not be.
&LT;/p>
      &LT;/TD>
      &LT;/TR>

    &LT;/TABLE>
    &LT;MM-Form-End>
    &LT;/ul>
    &LT;/td>
    &LT;/tr>
  &LT;/table>
&LT;MM-Mailman-Footer>
&LT;/BODY>
&LT;/HTML>
</TEXTAREA>
</CENTER>


This renders approximately as follows:

<table width="100%" border=1 ><tr><td width="100%">
    <P>
      <TABLE width="100%" COLS="1" BORDER="0" CELLSPACING="4" CELLPADDING="5">
	<TR>
	  <TD COLSPAN="2" WIDTH="100%" BGCOLOR="#99CCFF" ALIGN="CENTER">
<!--	    <B><FONT COLOR="#000000" SIZE="+1"><MM-List-Name> -- -->
	    <B><FONT COLOR="#000000" SIZE="+1">%MMLIST% --
<!--	<MM-List-Description></FONT></B> -->
	in this case a sample list</FONT></B>
	  </TD>
	</TR>
	<tr>
	    <td colspan="2">
	      <p>&nbsp;
	    </td>
	  </tr>
	  <tr>
	    <TD COLSPAN="1" WIDTH="100%" BGCOLOR="#FFF0D0">
<!--	      <B><FONT COLOR="#000000">About <MM-List-Name></FONT></B> -->
	      <B><FONT COLOR="#000000">About %MMLIST%</FONT></B>
	    </TD>
	  </TR>
	    <tr>
	      <td colspan="2">
<!--		<P><MM-List-Info></P> -->
		<P><em>%MMLIST%</em> functions here as a sample list.
</P><P>
</P><P>
We use it here just to demonstrate the layout of the information page when the 
<em>leaf-with-form</em> template is used.
Lots of text can be included here, in multple paragraphs, using HTML formatting.
</P>
	</TD>
      </TR>
      <TR>
	<TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
<!--	  <B><FONT COLOR="#000000">Using <MM-List-Name></FONT></B> -->
	  <B><FONT COLOR="#000000">Using %MMLIST%</FONT></B>
	</TD>
      </TR>
      <tr>
	<td colspan="2">
	  To post a message to all the list members, send email to
<!--	  <A HREF="mailto:<MM-Posting-Addr>"><MM-Posting-Addr></A>. -->
	  <A HREF="mailto:%MMLIST%@%MMHOST%">%MMLIST%@%MMHOST%</A>.

      <tr>
      <td colspan="2">
         <p>&nbsp;</p>
      </td>
      </tr>


      <TR>
        <TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
<!--      <B><FONT COLOR="#000000">Membership of <MM-List-Name></FONT></B> -->
          <B><FONT COLOR="#000000">Membership of %MMLIST%</FONT></B>
        </TD>
      </TR>
      <TR>
      <TD COLSPAN="2" >
<!--  <MM-Subscribe-Form-Start> -->
    <FORM Method=POST ACTION="%MMHTTP%%MMHOST%%MMMM%subscribe/%MMLIST%">
<p>Membership is maintained automatically, but if you really think you have been accidentally omitted, enter and submit your information below.
</p>
<p>
    <span style="white-space:nowrap">
         <label for="email" style="position; relative; left">Email:</label>
         <input id="email" type="text" name="email" size="23" value="" />
    </span>
    <span style="white-space:nowrap">
         <label for="fullname" style="position; relative; left">Name:</label>
         <input id="fullname" type="text" name="fullname" size="19" value="" />
    </span>
         <input type="Submit" name="email-button" value="Submit" />
</p>

</p>
</FORM>
<p>Or you can simply send email to <a href="mailto:%MMLIST%-owner@%MMHOST%">%MMLIST%-owner@%MMHOST%</a>; send email there also if you are on the list, but really think you should not be.
      </TD>
      </TR>

<!--  </TABLE> -->

<!--	</td> -->
<!--  </tr> -->
<!-- </TABLE> -->
<!-- </td> -->
<!-- </tr> -->
<!-- </table> -->
<!-- MM-Form-End> -->
<!-- Inclusion of <MM-Form-End> looks like an error -->
<!--    </ul> -->
<!-- <MM-Mailman-Footer> -->
<tr><td>
<hr style="height:3px;border-width:0;color:black;background-color:black"> 
<address><a href="%MMHTTP%%MMHOST%%MMMM%listinfo/%MMLIST%">%MMLIST%</a> list run by <a href="mailto:%MMLIST%-owner@%MMHOST%">%MMLIST%-owner at %MMHOST%</a><br><a href="%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%">%MMLIST% administrative interface</a> (requires authorization)<br><a href="%MMHTTP%%MMHOST%%MMMM%listinfo">Overview of all %MMHOST% mailing lists</a><p>
<table WIDTH="100%" BORDER="0">
</td></tr>
  <tr>
    <td><img src="%MMHTTP%%MMHOST%/icons/mailman.jpg" alt="Delivered by Mailman" border=0><br>version 2.1.30rc1</td>
    <td><img src="%MMHTTP%%MMHOST%/icons/PythonPowered.png" alt="Python Powered" border=0></td>
    <td><img src="%MMHTTP%%MMHOST%/icons/gnu-head-tiny.jpg" alt="GNU's Not Unix" border=0></td>
  </tr>
     </td>
    </tr>
  </table>
</TABLE>
</td></tr></table>


<BR />
---+++ umbrella-with-roster.html

While the previous suggestions reduce the overall verbosity of the page,
often removing some irrelevance, this variation is perhaps the most useful
change.

While setting up School mailing lists, a heirarchy of lists and sublists
was created.
It could be the case that a user might know the name of a list, but not
really be sure whether they belonged directly, or via a sublist.
Similarly, it would be really inappropriate to encourage users to
subscribe to an "umbrella list".

It was reasoned that the user visiting the page already knew about the
list names in general, so indicating to them the membership lists ought
not to be a problem, since individual personal membership was never indicated.

This choice expects that all members are sublists, and works best if the membership list is set visible to all and all the members (of necessity maintained by administrators) are set to be visible.  Perhaps unfortunately, the roster cannnot be included inline directly, but the reader must select a button to view it on a different page.

<!-- umbrella-with-roster.html -->
<CENTER>
<TEXTAREA ROWS=10 COLS=80>
&LT;HTML>
  &LT;HEAD>
    &LT;TITLE>&LT;MM-List-Name> Info Page&LT;/TITLE>
  
  &LT;/HEAD>
  &LT;BODY BGCOLOR="#ffffff">

    &LT;P>
      &LT;TABLE COLS="1" BORDER="0" CELLSPACING="4" CELLPADDING="5">
	&LT;TR>
	  &LT;TD COLSPAN="2" WIDTH="100%" BGCOLOR="#99CCFF" ALIGN="CENTER">
	    &LT;B>&LT;FONT COLOR="#000000" SIZE="+1">&LT;MM-List-Name> --
	&LT;MM-List-Description>&LT;/FONT>&LT;/B>
	  &LT;/TD>
	&LT;/TR>
	&LT;tr>
	    &LT;td colspan="2">
	      &LT;p>&nbsp;
	    &LT;/td>
	  &LT;/tr>
	  &LT;tr>
	    &LT;TD COLSPAN="1" WIDTH="100%" BGCOLOR="#FFF0D0">
	      &LT;B>&LT;FONT COLOR="#000000">About &LT;MM-List-Name>&LT;/FONT>&LT;/B>
	    &LT;/TD>
	  &LT;/TR>
	    &LT;tr>
	      &LT;td colspan="2">
		&LT;P>&LT;MM-List-Info>&LT;/P>
	&LT;/TD>
      &LT;/TR>
      &LT;TR>
	&LT;TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
	  &LT;B>&LT;FONT COLOR="#000000">Using &LT;MM-List-Name>&LT;/FONT>&LT;/B>
	&LT;/TD>
      &LT;/TR>
      &LT;tr>
	&LT;td colspan="2">
	  To post a message to all the list members, send email to
	  &LT;A HREF="mailto:&LT;MM-Posting-Addr>">&LT;MM-Posting-Addr>&LT;/A>.

	&LT;/td>
      &LT;/tr>

      &LT;tr>
      &LT;td colspan="2">
         &LT;p>&nbsp;&LT;/p>
      &LT;/td>
      &LT;/tr>

      &LT;TR>
        &LT;TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
          &LT;B>&LT;FONT COLOR="#000000">Membership of &LT;MM-List-Name>&LT;/FONT>&LT;/B>
        &LT;/TD>
      &LT;/TR>
      &LT;TR>
      &LT;TD COLSPAN="2" >
&LT;p>Membership is maintained automatically, and should consist entirely of other lists, with no addresses for individuals.
&LT;/p>
&LT;p>The following will show the sublist structure.
&LT;/p>
      &LT;/TD>
      &LT;/TR>

      &LT;tr>
	&LT;td colspan="2">
	    &LT;MM-Roster-Form-Start>
		&LT;MM-Roster-Option>
	    &LT;MM-Form-End>
	&LT;/td>
      &LT;/tr>
    &LT;/TABLE>
    &LT;/ul>
    &LT;/td>
    &LT;/tr>
  &LT;/table>
&LT;MM-Mailman-Footer>
&LT;/BODY>
&LT;/HTML>
</TEXTAREA>
</CENTER>



This renders approximately as follows:

<table width="100%" border=1 ><tr><td width="100%">
    <P>
      <TABLE width="100%" COLS="1" BORDER="0" CELLSPACING="4" CELLPADDING="5">
	<TR>
	  <TD COLSPAN="2" WIDTH="100%" BGCOLOR="#99CCFF" ALIGN="CENTER">
<!--	    <B><FONT COLOR="#000000" SIZE="+1"><MM-List-Name> -- -->
	    <B><FONT COLOR="#000000" SIZE="+1">%MMLIST% --
<!--	<MM-List-Description></FONT></B> -->
	in this case a sample list</FONT></B>
	  </TD>
	</TR>
	<tr>
	    <td colspan="2">
	      <p>&nbsp;
	    </td>
	  </tr>
	  <tr>
	    <TD COLSPAN="1" WIDTH="100%" BGCOLOR="#FFF0D0">
<!--	      <B><FONT COLOR="#000000">About <MM-List-Name></FONT></B> -->
	      <B><FONT COLOR="#000000">About %MMLIST%</FONT></B>
	    </TD>
	  </TR>
	    <tr>
	      <td colspan="2">
<!--		<P><MM-List-Info></P> -->
		<P><em>%MMLIST%</em> functions here as a sample list.
</P><P>
</P><P>
We use it here just to demonstrate the layout of the information page when the 
<em>umbrella-with-roster</em> template is used.
Lots of text can be included here, in multple paragraphs, using HTML formatting.
</P>
	</TD>
      </TR>
      <TR>
	<TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
<!--	  <B><FONT COLOR="#000000">Using <MM-List-Name></FONT></B> -->
	  <B><FONT COLOR="#000000">Using %MMLIST%</FONT></B>
	</TD>
      </TR>
      <tr>
	<td colspan="2">
	  To post a message to all the list members, send email to
<!--	  <A HREF="mailto:<MM-Posting-Addr>"><MM-Posting-Addr></A>. -->
	  <A HREF="mailto:%MMLIST%@%MMHOST%">%MMLIST%@%MMHOST%</A>.

      <tr>
      <td colspan="2">
         <p>&nbsp;</p>
      </td>
      </tr>


      <TR>
        <TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
<!--      <B><FONT COLOR="#000000">Membership of <MM-List-Name></FONT></B> -->
          <B><FONT COLOR="#000000">Membership of %MMLIST%</FONT></B>
        </TD>
      </TR>
      <TR>
      <TD COLSPAN="2" >
<!--  <MM-Subscribe-Form-Start> -->
<p>Membership is maintained automatically, and should consist entirely of other lists, with no addresses for individuals.
</p>
<p>The following will show the sublist structure.
</p>
      </TD>
      </TR>

      <tr>
        <td colspan="2">
            <FORM Method=POST ACTION="%MMHTTP%%MMHOST%%MMMM%roster/%MMLIST%">
                <INPUT name="language" type="HIDDEN" value="en" >Click here for the list of %MMLIST% subscribers: <INPUT name="SubscriberRoster" type="SUBMIT" value="Visit Subscriber list" >
            </FORM>
        </td>
      </tr>
</p>

      </TD>
      </TR>

<!--  </TABLE> -->

<!--	</td> -->
<!--  </tr> -->
<!-- </TABLE> -->
<!-- </td> -->
<!-- </tr> -->
<!-- </table> -->
<!-- MM-Form-End> -->
<!-- Inclusion of <MM-Form-End> looks like an error -->
<!--    </ul> -->
<!-- <MM-Mailman-Footer> -->
<tr><td>
<hr style="height:3px;border-width:0;color:black;background-color:black"> 
<address><a href="%MMHTTP%%MMHOST%%MMMM%listinfo/%MMLIST%">%MMLIST%</a> list run by <a href="mailto:%MMLIST%-owner@%MMHOST%">%MMLIST%-owner at %MMHOST%</a><br><a href="%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%">%MMLIST% administrative interface</a> (requires authorization)<br><a href="%MMHTTP%%MMHOST%%MMMM%listinfo">Overview of all %MMHOST% mailing lists</a><p>
<table WIDTH="100%" BORDER="0">
</td></tr>
  <tr>
    <td><img src="%MMHTTP%%MMHOST%/icons/mailman.jpg" alt="Delivered by Mailman" border=0><br>version 2.1.30rc1</td>
    <td><img src="%MMHTTP%%MMHOST%/icons/PythonPowered.png" alt="Python Powered" border=0></td>
    <td><img src="%MMHTTP%%MMHOST%/icons/gnu-head-tiny.jpg" alt="GNU's Not Unix" border=0></td>
  </tr>
     </td>
    </tr>
  </table>
</TABLE>
</td></tr></table>

<BR />
<BR />
<hr style="height:2px;border-width:0;color:brown;background-color:brown"> 
<BR />
<BR />


---+++ For reference, default as of about November 16, 2020

For reference, an approximate rendering of the default listinfo
page provided by IST on about November 16, 2020.

<table width="100%" border=1 ><tr><td width="100%">

    <P>
      <TABLE width="100%" BORDER="0" CELLSPACING="4" CELLPADDING="5">
	<TR>
	  <TD COLSPAN="2" WIDTH="100%" BGCOLOR="#99CCFF" ALIGN="CENTER">
	    <B><FONT COLOR="#000000" SIZE="+1">%MMLIST% --
	in this case a sample list</FONT></B>
	  </TD>
	</TR>
	<tr>
	    <td colspan="2">
	      <p>&nbsp;
	    </td>
	  </tr>
	  <tr>
	    <TD COLSPAN="1" WIDTH="100%" BGCOLOR="#FFF0D0">
	      <B><FONT COLOR="#000000">About %MMLIST%</FONT></B>
	    </TD>
            <TD COLSPAN="1" WIDTH="100%" BGCOLOR="#FFF0D0">
              <FORM Method=POST ACTION="%MMHTTP%%MMHOST%%MMMM%private/listinfo/%MMLIST%"> English (USA)
              </FORM>
            </TD>
	  </TR>
	    <tr>
	      <td colspan="2">
		<P><!----><!----></P>
		<P><em>%MMLIST%</em> functions here as a sample list.
</P><P>
</P><P>
We use it here just to demonstrate the layout of the information page when the 
standard listinfo provided by IST was used.
Lots of text can be included here, in multple paragraphs, using HTML formatting.
</P>
	  <p> To see the collection of prior postings to the list,
	      visit the <a href="%MMHTTP%%MMHOST%%MMMM%private/%MMLIST%/">%MMLIST%
		  Archives</a>.
	      (<i>The current archive is only available to the list
                members.</i>)
	  </p>
	</TD>
      </TR>
      <TR>
	<TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
	  <B><FONT COLOR="#000000">Using %MMLIST%</FONT></B>
	</TD>
      </TR>
      <tr>
	<td colspan="2">
	  To post a message to all the list members, send email to
	  <A HREF="mailto:%MMLIST%@%MMHOST%">%MMLIST%@%MMHOST%</A>.

	  <p>You can subscribe to the list, or change your existing
	    subscription, in the sections below.
	</td>
      </tr>
      <TR>
	<TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
	  <B><FONT COLOR="#000000">Subscribing to %MMLIST%</FONT></B>
	</TD>
      </TR>
      <tr>
	<td colspan="2">
	  <P>
	    Subscribe to %MMLIST% by filling out the following
	      form.
	  This is a closed list, which means your subscription
            will be held for approval.  You will be notified of the list
            moderator's decision by email. This is also a hidden list, which means that the
            list of members is available only to the list administrator.
	  <ul>
    <FORM Method=POST ACTION="%MMHTTP%%MMHOST%%MMMM%subscribe/%MMLIST%">
	      <TABLE BORDER="0" CELLSPACING="2" CELLPADDING="2" WIDTH="70%">
		<TR>
		  <TD BGCOLOR="#dddddd" WIDTH="55%">Your email address:</TD>
		  <TD WIDTH="33%"><INPUT type="Text" name="email" size="30" value="">
	</TD>
	<TD WIDTH="12%">&nbsp;</TD></TR>
      <tr>
        <td bgcolor="#dddddd" width="55%">Your name (optional):</td>
        <td width="33%"><INPUT type="Text" name="fullname" size="30" value=""></td>
	<TD WIDTH="12%">&nbsp;</TD></TR>
      <TR>
	<TD COLSPAN="3"><FONT SIZE=-1>You may enter a
	    privacy password below. This provides only mild security,
	    but should prevent others from messing with your
	    subscription.  <b>Do not use a valuable password</b> as
	    it will occasionally be emailed back to you in cleartext.

            <br><br>If you choose not to enter a password, one will be
            automatically generated for you, and it will be sent to
            you once you've confirmed your subscription.  You can
            always request a mail-back of your password when you edit
            your personal options.
	    
	    </font>
	</TD>
      </TR>  
      <TR>
	<TD BGCOLOR="#dddddd">Pick a password:</TD>
	<TD><INPUT type="Password" name="pw" size="15"></TD>
	<TD>&nbsp;</TD></TR>
      <TR> 
	<TD BGCOLOR="#dddddd">Reenter password to confirm:</TD>
	<TD><INPUT type="Password" name="pw-conf" size="15"></TD>
	<TD>&nbsp; </TD></TR>
      <tr>
        <TD BGCOLOR="#dddddd">Which language do you prefer to display your messages?</TD> 
        <TD> English (USA)</TD>
        <TD>&nbsp; </TD></TR>
      
      <tr>
	<td>Would you like to receive list mail batched in a daily
	  digest?
	  </td>
	<td><input type=radio name="digest" value="0" CHECKED> No
	    <input type=radio name="digest" value="1">  Yes
	</TD>
      </tr>
      
      
      
      <tr>
	<td colspan="3">
	  <center><INPUT type="Submit" name="email-button" value="Subscribe"></center>
    </td>
    </tr>
        </TABLE>
    </FORM>
    </ul>
    <TR>
      <TD COLSPAN="2" WIDTH="100%" BGCOLOR="#FFF0D0">
	<a name="subscribers">
        <B><FONT COLOR="#000000">%MMLIST% Subscribers</FONT></B></a>
      </TD>
    </TR>
    <tr>
      <TD COLSPAN="2" WIDTH="100%">
	<FORM Method=POST ACTION="%MMHTTP%%MMHOST%%MMMM%roster/%MMLIST%">
	<INPUT name="language" type="HIDDEN" value="en" >(<i>The subscribers list is only available to the list
            administrator.</i>) <p>Enter your admin address and password to visit  the subscribers list: <p><center> Admin address: <INPUT type="Text" name="roster-email" size="20" value="">Password: <INPUT type="Password" name="roster-pw" size="15">&nbsp;&nbsp;<INPUT name="SubscriberRoster" type="SUBMIT" value="Visit Subscriber List" ></center>
	    </FORM>
	  <p>
	<FORM Method=POST ACTION="%MMHTTP%%MMHOST%%MMMM%options/%MMLIST%">
	To unsubscribe from %MMLIST%, get a password reminder,
        or change your subscription options enter your subscription
        email address:
        <p><center> <INPUT name="email" type="TEXT" value="" size="30" >  <INPUT name="UserOptions" type="SUBMIT" value="Unsubscribe or edit options" ><INPUT name="language" type="HIDDEN" value="en" ></center> If you leave the field blank, you will be prompted for
        your email address
		</FORM>
      </td>
    </tr>
      </table>
<table WIDTH="100%" BORDER="0">
<tr><td>
<hr style="height:3px;border-width:0;color:black;background-color:black"> 
<address><a href="%MMHTTP%%MMHOST%%MMMM%listinfo/%MMLIST%">%MMLIST%</a> list run by <a href="mailto:%MMLIST%-owner@%MMHOST%">%MMLIST%-owner at %MMHOST%</a><br><a href="%MMHTTP%%MMHOST%%MMMM%admin/%MMLIST%">%MMLIST% administrative interface</a> (requires authorization)<br><a href="%MMHTTP%%MMHOST%%MMMM%listinfo">Overview of all %MMHOST% mailing lists</a><p>
</td></tr>
</table>
<table WIDTH="100%" BORDER="0">
  <tr>
    <td><img src="%MMHTTP%%MMHOST%/icons/mailman.jpg" alt="Delivered by Mailman" border=0><br>version 2.1.30rc1</td>
    <td><img src="%MMHTTP%%MMHOST%/icons/PythonPowered.png" alt="Python Powered" border=0></td>
    <td><img src="%MMHTTP%%MMHOST%/icons/gnu-head-tiny.jpg" alt="GNU's Not Unix" border=0></td>
  </tr>

</table>
</address>

</td></tr></table>

---++ Handy Mailman Pages in This CF Twiki
   (rendered for %MMLISTNAME% list)

   * [[https://cs.uwaterloo.ca/twiki/view/CF/MailManManagementGuide?mmlist=%MMLIST%&mmhost=%MMHOST%&mmmm=%MMMM%&mmhttp=%MMHTTP%][MailManManagementGuide]]
   * [[https://cs.uwaterloo.ca/twiki/view/CF/MailManManagementLinks?mmlist=%MMLIST%&mmhost=%MMHOST%&mmmm=%MMMM%&mmhttp=%MMHTTP%][MailManManagementLinks]]

---

-- Main.AdrianPepper - 2020-11-15
-- Main.AdrianPepper - 2020-12-01
Topic revision: r8 - 2021-01-06 - AdrianPepper
Information in this area is meant for use by CSCF staff and is not official documentation, but anybody who is interested is welcome to use it if they find it useful.
Other Webs
My links
- People
- CERAS
- WatForm
- Tetherless lab
- Ubuntu Main.HowTo
- eDocs
- RGG NE notes
- RGG
- CS infrastructure
- Grad images
Edit