Unverified Commit 8adab6a9 authored by IKEDA Soji's avatar IKEDA Soji Committed by GitHub
Browse files

Merge pull request #375 from ikedas/refactor_help_2 by ikedas

Refactoring help pages
parents 1f224c6c 9ca25315
......@@ -245,20 +245,59 @@ nobase_default_DATA = \
web_tt2/header.tt2 \
web_tt2/head_ui.tt2 \
web_tt2/head_javascript.tt2 \
web_tt2/help_admin-archives.tt2 \
web_tt2/help_admin-bounces.tt2 \
web_tt2/help_admin-closelist.tt2 \
web_tt2/help_admin-createlist.tt2 \
web_tt2/help_admin-editfile.tt2 \
web_tt2/help_admin-editlist-archives.tt2 \
web_tt2/help_admin-editlist-bounces.tt2 \
web_tt2/help_admin-editlist-command.tt2 \
web_tt2/help_admin-editlist-description.tt2 \
web_tt2/help_admin-editlist-other.tt2 \
web_tt2/help_admin-editlist-sending.tt2 \
web_tt2/help_admin-editlist.tt2 \
web_tt2/help_admin-members.tt2 \
web_tt2/help_admin-moderate.tt2 \
web_tt2/help_admin-renamelist.tt2 \
web_tt2/help_admin-rules.tt2 \
web_tt2/help_admin-shared.tt2 \
web_tt2/help_admin-users.tt2 \
web_tt2/help_admin.tt2 \
web_tt2/help_arc-post.tt2 \
web_tt2/help_arc-search-advanced.tt2 \
web_tt2/help_arc-search-result.tt2 \
web_tt2/help_arc-search-simple.tt2 \
web_tt2/help_arc-search.tt2 \
web_tt2/help_arc.tt2 \
web_tt2/help_commands.tt2 \
web_tt2/help_faq-admin.tt2 \
web_tt2/help_faq-user-contact.tt2 \
web_tt2/help_faq-user.tt2 \
web_tt2/help_faq.tt2 \
web_tt2/help_faqadmin.tt2 \
web_tt2/help_faquser.tt2 \
web_tt2/help_index.tt2 \
web_tt2/help_introduction-features.tt2 \
web_tt2/help_introduction-policy.tt2 \
web_tt2/help_introduction-roles.tt2 \
web_tt2/help_introduction.tt2 \
web_tt2/help_listconfig.tt2 \
web_tt2/help_mail_commands.tt2 \
web_tt2/help_sendmsg.tt2 \
web_tt2/help_shared-edit.tt2 \
web_tt2/help_shared-hint.tt2 \
web_tt2/help_shared-read.tt2 \
web_tt2/help_shared-upload.tt2 \
web_tt2/help_shared.tt2 \
web_tt2/help_suspend.tt2 \
web_tt2/help.tt2 \
web_tt2/help_user_options.tt2 \
web_tt2/help_user-authweb.tt2 \
web_tt2/help_user-listmenu.tt2 \
web_tt2/help_user-pref.tt2 \
web_tt2/help_user-review.tt2 \
web_tt2/help_user-rules.tt2 \
web_tt2/help_user-searchlist.tt2 \
web_tt2/help_user-sendmsg.tt2 \
web_tt2/help_user-signoff.tt2 \
web_tt2/help_user-suboptions.tt2 \
web_tt2/help_user-subscribe.tt2 \
web_tt2/help_user-suspend.tt2 \
web_tt2/help_user.tt2 \
web_tt2/help.tt2 \
web_tt2/home.tt2 \
web_tt2/import.tt2 \
web_tt2/including_lists.tt2 \
......@@ -421,5 +460,15 @@ install-data-hook:
$(LN_S) -f ../mail_tt2/authorization_reject.tt2; \
rm -f report.tt2; \
$(LN_S) -f ../mail_tt2/report.tt2; \
test -f css_ie.tt2 || echo '' >> css_ie.tt2
test -f css_ie.tt2 || echo '' >> css_ie.tt2; \
rm -f help_faqadmin.tt2 help_faquser.tt2 help_listconfig.tt2 \
help_mail_commands.tt2 help_sendmsg.tt2 help_suspend.tt2 \
help_user_options.tt2; \
$(LN_S) -f help_faq-admin.tt2 help_faqadmin.tt2; \
$(LN_S) -f help_faq-user.tt2 help_faquser.tt2; \
$(LN_S) -f help_admin-editlist.tt2 help_listconfig.tt2; \
$(LN_S) -f help_commands.tt2 help_mail_commands.tt2; \
$(LN_S) -f help_user-sendmsg.tt2 help_sendmsg.tt2; \
$(LN_S) -f help_user-suspend.tt2 help_suspend.tt2; \
$(LN_S) -f help_user-suboptions.tt2 help_user_options.tt2
......@@ -39,7 +39,7 @@ DISTRIBUTE [% list.name %] [% modkey %]
[%|loc(conf.email,domain)%]Or send a message to %1@%2 with the following subject:[%END%]
REJECT [% list.name %] [% modkey %]
[%END%]
[%|loc%]The messages moderating documentation:[%END%] <[% 'help/admin' | url_abs %]#moderate>
[%|loc%]The messages moderating documentation:[%END%] <[% 'help' | url_abs(['admin-moderate.html']) %]>
[%- END%]
[%- END%]
[% IF spam_status != 'spam' -%]
......
......@@ -8,7 +8,7 @@ Content-Disposition: inline
[%|loc(total,list.name,domain)%]There are %1 messages to be moderated for list %2@%3[%END%]
[%|loc%]The messages moderating documentation:[%END%] <[% 'help/admin' | url_abs %]#moderate>
[%|loc%]The messages moderating documentation:[%END%] <[% 'help' | url_abs(['admin-moderate.html']) %]>
[% IF spool %]
--[% boundary1 %]
......
......@@ -33,7 +33,7 @@ Subject: [% FILTER qencode %][%|loc(list.name)%]Management of list %1[%END%][%EN
[% IF conf.wwsympa_url -%]
[%|loc%]The list homepage:[%END%] [% 'info' | url_abs([list.name]) %]
[%|loc%]Owner and moderator guide:[%END%] [% 'help/admin' | url_abs %]
[%|loc%]Owner and moderator guide:[%END%] [% 'help' | url_abs(['admin.html']) %]
[% END -%]
[% ELSIF type == 'ticket_to_family_signoff' -%]
......
......@@ -12,5 +12,5 @@ Subject: [% FILTER qencode %][%|loc(list.name)%]Welcome to list %1[%END%][%END%]
[% IF conf.wwsympa_url -%]
[%|loc%]The list homepage:[%END%] [% 'info' | url_abs([list.name]) %]
[%|loc%]General information about mailing lists:[%END%] [% 'help/introduction' | url_abs %]
[%|loc%]General information about mailing lists:[%END%] [% 'help' | url_abs(['introduction.html']) %]
[% END -%]
<!-- arc.tt2 -->
<div class="block">
<h2>[%|loc%]List archive[%END%] <a href="[% 'nomenu/help/arc' | url_rel %]" title="[%|loc%]Open in a new window[%END%]" onclick="window.open('','wws_help','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=400,height=200')" target="wws_help"><i class="fa fa-question-circle" title="[%|loc%]Help[%END%]"></i></a></h2>
<br />
<h2>[%|loc%]List archive[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['arc.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h2>
<!-- part generated by mhonarc -->
[% IF html_content ~%]
[% TRY ~%]
......
<!-- arc_manage.tt2 -->
<div class="block">
<h2>[%|loc%]Archive Management[%END%] <a href="[% 'nomenu/help/admin' | url_rel %]#manage_archives" title="[%|loc%]Open in a new window[%END%]" onclick="window.open('','wws_help','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=400,height=200')" target="wws_help"><i class="fa fa-question-circle" title="[%|loc%]Help[%END%]"></i></a></h2>
<h2>[%|loc%]Archive Management[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['admin-archives.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h2>
<p>
[%|loc%]Select the Archive months you want to delete or download (zip format):[%END%]
......
<!-- arcsearch_form.tt2 -->
<div class="block">
<h2>[%|loc%]List archive[%END%] </h2>
<h4>[%|loc%]Advanced search[%END%] <a href="[% 'nomenu/help/arc' | url_rel %]#arcsearch" title="[%|loc%]Open in a new window[%END%]" onclick="window.open('','wws_help','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=400,height=200')" target="wws_help"><i class="fa fa-question-circle" title="[%|loc%]Help[%END%]"></i></a></h4>
<h4>[%|loc%]Advanced search[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['arc-search.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h4>
<form id="bold_label" method="post" action="[% path_cgi %]">
<fieldset>
......
<!-- d_control.tt2 -->
<h2>[%|loc%]Shared documents[%END%] <a href="[% 'nomenu/help/shared' | url_rel %]" title="[%|loc%]Open in a new window[%END%]" onclick="window.open('','wws_help','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=400,height=200')" target="wws_help"><i class="fa fa-question-circle" title="[%|loc%]Help[%END%]"></i></a></h2>
<h2>[%|loc%]Shared documents[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['shared.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h2>
<menu class="shared">
[% FOREACH a = shared_doc.ancestors ~%]
......
<!-- d_editfile.tt2 -->
<h2>[%|loc%]Shared documents[%END%] <a href="[% 'nomenu/help/shared' | url_rel %]" title="[%|loc%]Open in a new window[%END%]" onclick="window.open('','wws_help','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=400,height=200')" target="wws_help"><i class="fa fa-question-circle" title="[%|loc%]Help[%END%]"></i></a></h2>
<h2>[%|loc%]Shared documents[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['shared.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h2>
<menu class="shared">
[% FOREACH a = shared_doc.ancestors ~%]
......
<!-- d_properties.tt2 -->
<h2>[%|loc%]Shared documents[%END%] <a href="[% 'nomenu/help/shared' | url_rel %]" title="[%|loc%]Open in a new window[%END%]" onclick="window.open('','wws_help','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=400,height=200')" target="wws_help"><i class="fa fa-question-circle" title="[%|loc%]Help[%END%]"></i></a></h2>
<h2>[%|loc%]Shared documents[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['shared.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h2>
<menu class="shared">
[% FOREACH a = shared_doc.ancestors ~%]
......
<!-- d_upload.tt2 -->
<h2>[%|loc%]Shared documents[%END%] <a href="[% 'nomenu/help/shared' | url_rel %]" title="[%|loc%]Open in a new window[%END%]" onclick="window.open('','wws_help','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=400,height=200')" target="wws_help"><i class="fa fa-question-circle" title="[%|loc%]Help[%END%]"></i></a></h2>
<h2>[%|loc%]Shared documents[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['shared.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h2>
<p class="alert-box warning">[%|loc(shortname)%]the file %1 already exists[%END%]</p>
......
......@@ -3,36 +3,73 @@
<div class="block">
<h2>[%|loc%]Edit List Configuration[%END%]
<a href="[% 'nomenu/help/listconfig' | url_rel %]"
title="[%|loc%]Open in a new window[%END%]"
onclick="window.open('','wws_help','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=800,height=400')"
target="wws_help">
<i class="fa fa-question-circle" title="[%|loc%]Help[%END%]"></i>
</a>
</h2>
[% IF !group ~%]
<h2>[%|loc%]Edit List Configuration[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['admin-editlist.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h2>
<p>
[%|loc%]Here you can edit your list's configuration parameters.[% END %]
</p>
[%~ ELSE ~%]
<h2>[%|loc%]Edit List Configuration[%END%]</h2>
[% IF group == 'description' ~%]
<h3>[%|loc%]List definition[%END%]</h3>
<h3>[%|loc%]List definition[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['admin-editlist-description.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h3>
[%~ ELSIF group == 'sending' ~%]
<h3>[%|loc%]Sending/receiving setup[%END%]</h3>
<h3>[%|loc%]Sending/receiving setup[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['admin-editlist-sending.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h3>
[%~ ELSIF group == 'command' ~%]
<h3>[%|loc%]Privileges[%END%]</h3>
<h3>[%|loc%]Privileges[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['admin-editlist-command.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h3>
[%~ ELSIF group == 'archives' ~%]
<h3>[%|loc%]Archives[%END%]</h3>
<h3>[%|loc%]Archives[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['admin-editlist-archives.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h3>
[%~ ELSIF group == 'bounces' ~%]
<h3>[%|loc%]Bounces[%END%]</h3>
<h3>[%|loc%]Bounces[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['admin-editlist-bounces.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h3>
[%~ ELSIF group == 'data_source' ~%]
<h3>[%|loc%]Data sources setup[%END%]</h3>
[%~ ELSIF group == 'dkim' ~%]
<h3>[%|loc%]DKIM[%END%]</h3>
[%~ ELSIF group == 'other' ~%]
<h3>[%|loc%]Miscellaneous[%END%]</h3>
<h3>[%|loc%]Miscellaneous[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['admin-editlist-other.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h3>
[%~ END %]
<form class="bold_label" action="[% path_cgi %]" method="post">
......
<!-- editfile.tt2 -->
<div class="block">
<h2>[%|loc%]Edit list templates[%END%] <a href="[% 'nomenu/help/admin' | url_rel %]#customize" title="[%|loc%]Open in a new window[%END%]" onclick="window.open('','wws_help','toolbar=no,location=no,directories=no,status=no,menubar=no,scrollbars=yes,resizable=yes,copyhistory=no,width=400,height=200')" target="wws_help"><i class="fa fa-question-circle" title="[%|loc%]Help[%END%]"></i></a></h2>
<h2>[%|loc%]Edit list templates[%END%]
<a class="openInNewWindow"
href="[% 'nomenu/help' | url_rel(['admin-editfile.html']) %]" target="wws_help">
<i class="fa fa-info-circle" title="[%|loc%]Help[%END%]"
aria-hidden="true"></i>
</a>
</h2>
[% IF file %]
<form class="noborder" action="[% path_cgi %]" method="post">
......
......@@ -21,6 +21,7 @@ var sympa = {
lang: '[% lang %]',
loadingText: "[%|loc%]Please Wait...[%END%]",
monthNamesShort: "[%|loc%]Jan:Feb:Mar:Apr:May:Jun:Jul:Aug:Sep:Oct:Nov:Dec[%END%]".split(":"),
openInNewWinText: "[%|loc%]Open in a new window[%END%]",
resetText: "[%|loc%]Reset[%END%]"
};
[%# Variable for backward compatibility. ~%]
......
<!-- help.tt2 -->
<article class="doc">
[% IF help_topic %]
[% PROCESS "help_${help_topic}.tt2" IF help_topic %]
<br />
[% ELSE %]
<h2><i class="fa fa-book"></i> [%|helploc%]Subscriber, moderator and owner documentation[%END%]</h2>
<p>[%|helploc%]In this documentation, you will find:[%END%]</p>
<ul>
<li>[%|helploc%]a <a href="introduction">general introduction</a> to mailing lists;[%END%]</li>
<li>[%|helploc%]a <a href="user">user guide</a> about the use of Sympa;[%END%]</li>
<li>[%|helploc%]an <a href="admin">administrator guide</a> about the use of Sympa.[%END%]</li>
</ul>
<p>[%|helploc%]If you want to perform a particular task, take a look at the list of all <a href="introduction#features">available features</a> in the mailing list management software Sympa.[%END%]<br />
[%|helploc%]If you experience any problem, please refer to the <a href="faquser">users <acronym title="Frequently asked questions">FAQ</acronym></a> or to the <a href="faqadmin">administrators <acronym title="Frequently asked questions">FAQ</acronym></a>.[%END%]</p>
[% END %]
[% IF help_topic ~%]
[% PROCESS "help_${help_topic}.tt2" %]
[%~ ELSE ~%]
[% PROCESS "help_index.tt2" %]
[%~ END %]
</article>
<!-- end help.tt2 -->
<h2><a name="manage_archives"></a>[%|helploc%]Managing the message archive[%END%]</h2>
<p>[%|helploc%]The mailing list management robot Sympa can generate <strong>downloadable compressed archives (.ZIP format) of the messages sent to the list</strong>. To download those archives, <strong>select the months</strong> that interest you in the list and click on the '<strong>Download .zip archive</strong>' button.[%END%]</p>
<p class="retraitita">[%|helploc%]Tip: in the 'Archive selection' list, to select all months during which messages have been sent, click on the first month, hold down the SHIFT key and click on the last month of the list.[%END%]</p>
<p>[%|helploc%]You will receive a file of the type '<strong>nameofthelist_archive.zip</strong>' containing <strong>folders named 'nameofthelist_year-month'</strong> (example: <em class="example">list_example_2005-06</em>) for each month. Inside each folder, <strong>the file names are numbers</strong> representing their position in the chronology of the messages sent (example: the file named '1' contains the first message sent in the month). The message files have <strong>no extension</strong>; use the text editor of your choice (Notepad, WordPad, Vim, etc.) to open them. <strong>Each file represents an entire message (full header)</strong>.[%END%]</p>
<p>[%|helploc%]From the 'Manage archives' page, you can also <strong>delete messages</strong> (deletion month by month and not message by message). To do that, <strong>select the months</strong> that interest you in the list and click on the '<strong>Delete Selected Month(s)</strong>' button.[%END%]</p>
<p class="retraitita">[%|helploc%]<strong>Be careful: this operation is irreversible!!! When you click on 'Delete selected months', keep in mind that you are not only deleting an archive file, but also the entire message archive of the selected month!!!</strong>[%END%]</p>
<h2><a name="manage_bounces"></a>[%|helploc%]Managing bounces[%END%]</h2>
<p>[%|helploc%]When there is a <strong>problem with subscribers' email addresses</strong> (obsolete email addresses, addresses temporarily unavailable when messages were sent, inbox quota exceeded, etc.), the percentage of bouncing addresses displays in the left menu under the text '<strong>Error rate</strong>'. To check the bouncing addresses, go to the '<strong>Bounces</strong>' page of the list administration module.[%END%]</p>
<p>[%|helploc%]The Sympa software automatically manages bouncing subscribers: according to the number of errors and to the traffic on the list, bouncing subscribers are either notified, unsubscribed, or their score is reset to zero when their address stops bouncing.[%END%]</p>
<p>[%|helploc%]To <strong>make addresses stop being reported as bouncing</strong>, select them by ticking their boxes and click on the '<strong>Reset errors for selected users</strong>' button. If the error remains, the addresses will be reported as bouncing again as soon as a message is posted on the list.[%END%]</p>
<p>[%|helploc%]You can also <strong>unsubscribe subscribers whose addresses are still bouncing</strong>: too many bouncing addresses cause a considerable load on the mailing list server. To unsubscribe subscribers, select them by ticking the boxes in front of their names and click on the '<strong>Delete selected email addresses</strong>' button.[%END%]</p>
<p class="retraitita">[%|helploc%]Tip: to select all subscribers at once, first make sure that they are all displayed on the page, and then click on the 'Toggle selection' button: all subscribers will be selected in a single click![%END%]</p>
<h2><a name="supprlist"></a>[%|helploc%]Deleting the list[%END%]</h2>
<p>[%|helploc%]In the <strong>list administration module</strong>, click on '<strong>Remove list</strong>'. A confirmation message displays; click on 'OK'.[%END%]</p>
<p class="retraitita">[%|helploc%]<strong>Be careful: if you delete the list, you will not be able to reopen it yourself!!! If you want to reopen the list, you will have to ask the listmasters.</strong>[%END%]</p>
<p>[%|helploc%]In real terms, what are the <strong>consequences</strong> of a list deletion?[%END%]</p>
<ul>
<li>[%|helploc%]<strong>All subscribers are immediately unsubscribed</strong> automatically (including owners and moderators).[%END%]</li>
<li>[%|helploc%]<strong>The message archive is preserved</strong> but no one can access it anymore.[%END%]</li>
<li>[%|helploc%]<strong>The documents published in the shared document web space are preserved</strong> but no one can access them anymore.[%END%]</li>
<li>[%|helploc%]<strong>Only the listmasters have the power to reopen the list</strong>; if they do, the former list subscribers will automatically be subscribed again.[%END%]</li>
</ul>
<p class="retraitita">[%|helploc%]Be careful: due to a slight latency, the list pages remain accessible for a while if you know their addresses. Then they will become fully unavailable.[%END%]</p>
<p>[%|helploc%]<strong>If you want the list and all the associated files to be deleted permanently</strong>, you will have to ask the listmasters.[%END%]</p>
<h2><a name="create_list"></a>[%|helploc%]Requesting the creation of a mailing list[%END%]</h2>
<p>[%|helploc%]The <strong>list creation request</strong> can be <strong>subject to conditions</strong>. Even though you meet those conditions, the <strong>list creation</strong> will nevertheless be <strong>subject to approval by the listmasters</strong>.[%END%]</p>
<p>[%|helploc%]To request the creation of a mailing list, do as follows:[%END%]</p>
<ol>
<li>[%|helploc%]Go to the <strong><a href="../home">list environment homepage</a></strong> and <a href="user-authweb.html"><strong>log on</strong></a>.[%END%]</li>
<li>[%|helploc%]In the top menu, <strong>click on the 'Create list' link</strong>.[%END%]<br/>
<span class="retraitita">[%|helploc%]If this link does not display, it means that you do not have the privileges required to create a list.[%END%]</span></li>
<li>[%|helploc('',domain)%]Give your list a <strong>name</strong> (only enter the name without the '@' and the domain name; example: <em class="example">languages_spanish</em> and not <em class="example">languages_spanish@%2</em>).[%END%]<br />
<span class="retraitita">[%|helploc%]Do not use any spaces, accents or specials characters in list names: those characters might cause problems.[%END%]</span>
<span class="retraitita">[%|helploc('',domain)%]Choose an explicit yet short name: think of the subscribers who will have to type this name every time they will send a message to the list! If you manage a set of lists, you can prefix your lists' names with a common prefix; thus they will be sorted together and will be easily recognizable (example: <em class="example">xx-users@%2, xx-hotline@%2</em>, etc.).[%END%]</span></li>
<li>[%|helploc%]Choose a <strong>list type</strong> among the predefined types (the predefined types are only examples of typical configurations that can be changed by the list owners after creation; it is even possible to configure the list beyond the options offered in the list administration module, by asking the listmasters).[%END%]</li>
<li>[%|helploc%]Enter a <strong>subject</strong> for your list. This subject will display as a header for all the list pages, and will also be visible on list index pages (list of lists, list of your subscriptions, etc.) and in the browser title bar.[%END%]<br />
<li>[%|helploc%]Choose a <strong>topic</strong> in the 'Topics' drop-menu.[%END%]<br />
<p class="retraitita">[%|helploc%]If no topic suits your needs, you can request the creation of a new topic by asking the listmasters.[%END%]</p></li>
<li>[%|helploc%]Enter a <strong>description</strong> for your list. This description will display on the list information page and in the 'Subscribers Charter' sent by email to each new subscriber, under the 'List subject' heading. This description may involve explanations about the following issues:[%END%]
<ul>
<li>[%|helploc%]object of the list and targets;[%END%]</li>
<li>[%|helploc%]topics discussed;[%END%]</li>
<li>[%|helploc%]operation of the list (liabilities, status of the list, etc.);[%END%]</li>
<li>[%|helploc%]rules applying;[%END%]</li>
<li>[%|helploc%]description of the typical subscribers (their occupations, the projects they manage, their nationalities, etc.).[%END%]</li>
</ul>
<p class="retraitita">[%|helploc%]You can format your list description with <acronym lang="en" xml:lang="en" title="HyperText Markup Language">HTML</acronym> tags. Be careful: if your description is long, cut it with manual line breaks (ENTER key of your keyboard); otherwise, it might not be entirely visible in your browser window.[%END%]</p>
<li>[%|helploc%]Click on the '<strong>Submit your creation request</strong>' button.[%END%]</li>
</ol>
<p>[%|helploc%]A message displays to inform you that your list creation request has been sent to the listmasters and that from now on, you can modify the list by clicking on the 'Admin' button. However, the message warns you that the list will be actually installed and made visible on the server only after approval by a listmaster.[%END%]</p>
<p>[%|helploc%]After this, you will have to <strong>wait for the list creation to be approved of by one of the listmasters</strong>. Then you will receive a notice message entitled '<strong>Creation of the nameofthelist list</strong>', informing you that your list was actually created.[%END%]</p>
<p>[%|helploc%]<strong>Last, subscribe to your list</strong>: creating a list or becoming its owner or moderator does not mean that you are automatically subscribed to it![%END%]</p>
<h2>[%|helploc%]Managing a list[%END%]</h2>
<p>[%|helploc%]To manage a list you own, do as follows:[%END%]</p>
<ol>
<li>[%|helploc%]Go to the <strong>list environment homepage</strong> and <strong><a href="user-authweb.html">log on</a></strong>.[%END%]<br />
<p class="retraitita">[%|helploc%]If you are subscribed to the list with several addresses, use the address with which you requested the list creation.[%END%]</p></li>
<li>[%|helploc%]<strong>Go to the information page of the list</strong> you want to manage.[%END%]</li>
<li>[%|helploc%]In the left menu, <strong>click on the 'Admin' link</strong>.[%END%]</li>
</ol>
<p>[%|helploc%]To browse the sections of the administration module, click on the links below the 'Admin' link, in the left menu.[%END%]</p>
<p>[%|helploc%]Those different sections allow you to:[%END%]</p>
<ul>
<li>[%|helploc%]<a href="admin-editlist.html">configure the list</a>;[%END%]</li>
<li>[%|helploc%]<a href="admin-editfile.html">customize files related to the list</a>;[%END%]</li>
<li>[%|helploc%]<a href="admin-members.html">manage subscribers</a>;[%END%]</li>
<li>[%|helploc%]<a href="admin-archives.html">manage the message archive of the list</a>;[%END%]</li>
<li>[%|helploc%]<a href="admin-bounces.html">manage bounces</a>;[%END%]</li>
<li>[%|helploc%]<a href="admin-shared.html">create, delete or restore the shared document web space</a>;[%END%]</li>
<li>[%|helploc%]<a href="admin-renamelist.html">rename the list</a>;[%END%]</li>
<li>[%|helploc%]<a href="admin-closelist.html">delete the list</a>.[%END%]</li>
</ul>
<p>[%|helploc%]The options available in the 'Moderate' submenu allow you to:[%END%]
<ul>
<li>[%|helploc%]<a href="admin-moderate.html">moderate messages</a> sent to the list;[%END%]</li>
<li>[%|helploc%]<a href="shared.html">moderate documents</a> available in the shared document web space;[%END%]</li>
<li>[%|helploc%]<a href="admin-members.html">moderate pending subscriptions</a>.[%END%]</li>
</ul>
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment