<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>HelpOnSubscribing</title></articleinfo><section><title>HelpOnSubscribing</title><para>Subscribing is an optional feature on <ulink url="https://techwiki.helsinki.at/HelpOnSubscribing/MoinMoin#">MoinMoin</ulink> wikis which enables users to receive an email notification when any changes have been made on specific wiki webpages.  This optional feature is available only if the wiki administrator has enabled email support (see <ulink url="https://techwiki.helsinki.at/HelpOnSubscribing/HelpOnConfiguration/EmailSupport#">HelpOnConfiguration/EmailSupport</ulink>).   </para><para>There are two general ways to subscribe to wiki pages. The first and easiest way is to click on the 'Subscribe' link at the top of a wiki page.  The second way is to edit 'User Preferences'.  Both methods are described in detail below. </para><!--rule (<hr>) is not applicable to DocBook--><para><emphasis role="strong">Definitions:</emphasis> </para><glosslist><glossentry><glossterm>Subscribe </glossterm><glossdef><para>When you 'subscribe' to a wiki page, you are requesting that an email be sent to you when anyone other than yourself changes the contents of the webpage. </para></glossdef></glossentry><glossentry><glossterm>Unsubscribe </glossterm><glossdef><para>At any time after you have 'subscribed' to a wiki page, you may choose to 'unsubscribe' to this webpage.  After you 'unsubscribe' to a wiki webpage, you will NOT be notified when changes are made to this webpage. </para></glossdef></glossentry><glossentry><glossterm>Wiki farm </glossterm><glossdef><para>A wiki farm is a cluster of wiki websites that are maintained on a common server or server farm and share the same domain name (e.g. <code>myfirstwiki.example.net</code> and <code>mysecondwiki.example.net</code>). Email support may also be available across a whole wiki farm if the administrator has enabled shared user accounts across the farm (see <ulink url="https://techwiki.helsinki.at/HelpOnSubscribing/HelpOnUserHandling#">HelpOnUserHandling</ulink>).   </para></glossdef></glossentry><glossentry><glossterm>InterWiki name </glossterm><glossdef><para>A shorthand abbreviation for a wiki URL, and in the case of a wiki farm will refer to the name of other wiki's within the farm.  An interwiki name is assigned by the wiki administrator. When subscribing using regex, you may want to rely on InterWiki names so that your subscriptions return only notifications from specified wiki's. Otherwise, you can inadvertently subscribe to any matching page across the entire wiki farm. See <ulink url="https://techwiki.helsinki.at/HelpOnSubscribing/InterWiki#">InterWiki</ulink>. </para></glossdef></glossentry></glosslist></section><section><title>Subscribing to a wiki page</title><para>In order to subscribe, you need to first log in and enter your email address in your account settings.  </para><para>Once this is done, you can simply click the 'Subscribe' link at the top of any given page. The link will change to 'Unsubscribe', and you will now be notified by email any time another user modifies that page.  You will not receive notifications when you edit the page yourself. </para><para>To stop email notifications, simply click the 'Unsubscribe' link. (remember that you must be logged in in order to change your preferences. </para><para>If you forget which wiki webpages you have subscribed to, you can find a list of these pages under User Preferences. </para></section><section><title>Subscribing to multiple pages at a time</title><para>Naturally, you can repeat the above process in order to subscribe to any number of wiki pages.  However, an easier way is to use regular expressions to subscribe to a collection of wiki pages. </para><para>Once you're logged into your wiki, click on the 'Settings' link near the top of the page, then 'Notifications', and scroll down the page until you see the following label: </para><itemizedlist><listitem override="none"><para><emphasis role="underline">Subscribed wiki pages (one regex per line)</emphasis> </para></listitem></itemizedlist><para>If you have previously subscribed to individual wiki webpages as described above, there should be a list of these webpages in the text box (otherwise, it will be blank). To subscribe, follow the examples shown in the table below, adding one statement (regex) per line.  </para><informaltable><tgroup cols="2"><colspec colname="col_0" colwidth="33*"/><colspec colname="col_1"/><tbody><row rowsep="1"><entry colsep="1" rowsep="1"><para> <emphasis role="strong">Example</emphasis> </para></entry><entry colsep="1" rowsep="1"><para> <emphasis role="strong">Subscribes to</emphasis>  </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>.*</code> </para></entry><entry colsep="1" rowsep="1"><para> All webpages on the current wiki (or wiki farm). Use with caution, as you may receive a <emphasis>lot</emphasis> of emails, depending on how busy your wiki is.  </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>MyFirstWiki:.*</code> </para></entry><entry colsep="1" rowsep="1"><para> All webpages on the MyFirstWiki wiki</para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>FrontPage</code> </para></entry><entry colsep="1" rowsep="1"><para> All pages named 'FrontPage' on the current wiki (or wiki farm). See note below. </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>MyFirstWiki:FrontPage</code> </para></entry><entry colsep="1" rowsep="1"><para> The FrontPage on the MyFirstWiki wiki </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>MyFirstWiki:FrontPage/.*</code> </para></entry><entry colsep="1" rowsep="1"><para> All subpages of the FrontPage on the MyFirstWiki wiki </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>Help.*</code> </para></entry><entry colsep="1" rowsep="1"><para> All pages starting with the word 'Help' on the current wiki (or wiki farm) </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>MyFirstWiki:Help.*</code> </para></entry><entry colsep="1" rowsep="1"><para> All pages starting with the word 'Help' on the MyFirstWiki wiki </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>Help(On|For).*</code> </para></entry><entry colsep="1" rowsep="1"><para> All pages starting with the term 'HelpOn' or 'HelpFor' on the current wiki (or wiki farm </para></entry></row><row rowsep="1"><entry colsep="1" rowsep="1"><para> <code>MyFirstWiki:FrontPage/.*(Help|Question).*</code> </para></entry><entry colsep="1" rowsep="1"><para> All subpages of the FrontPageon the MyFirstWiki wiki which contain either the word 'Help'or the word 'Question' anywhere in the name </para></entry></row></tbody></tgroup></informaltable><para>You can <emphasis>Unsubscribe</emphasis> from any of the above regex's by simply removing the line from the text box and saving. </para><para><emphasis role="strong">Additional Notes:</emphasis> </para><glosslist><glossentry><glossterm>Searching individual versus multiple wiki's </glossterm><glossdef><para><emphasis>[this only applies if your wiki is a part of a wiki farm (see definition above) <emphasis role="underline">and</emphasis> the administrator has a common user directory for the farm]</emphasis>  </para></glossdef><glossdef><para>In the examples in the table above, if the interwiki name is NOT included (before the colon character), the regex term will apply across the entire wiki farm. For example, in the regex-subscription to <code>FrontPage</code> will notify you every time the page changes on <code>MyFirstWiki</code>, <code>MySecondWiki</code>, and so on. </para></glossdef><glossdef><para>To limit your notifications to a specific wiki, leverage the interwiki name.  To use, begin your regex with the interwiki name (for example <code>MyFirstWiki</code>) followed by a colon, like so- <code>MyFirstWiki:</code> </para></glossdef></glossentry><glossentry><glossterm>Regular Expressions </glossterm><glossdef><para>Regular expressions (often abbreviated as <emphasis>regex</emphasis>) are symbolic terms used for pattern matching in computer programming languages.  As illustrated above, regular expressions are used to subscribe to more than one wiki page at a time.  For example, the term period-asterisk (.*) means zero or more repetitions (*) of any character (.) in the page name.  The expression '(Help|Question)' means either the word 'Help' or the word 'Question' must occur in the page name.   </para></glossdef><glossdef><para>An important feature of regex expressions used for subscribing in a MoinMoin wiki (as illustrated in the table above) is that each expression is automatically enclosed between the symbols &quot;^&quot; and &quot;$&quot; which represent the beginning and end of the wiki webpage name.  Thus, the regex expression <code>'MainPage'</code> will match only pages with that name but will not match pages named <code>'MyMainPage' or 'MainPageOne'</code>, etc.  </para></glossdef><glossdef><para>There are many more symbols used in regular expressions but they are beyond the scope of this help page.  For further reading, see <ulink url="http://wikipedia.org/wiki/Regular_expression">Regular expression on Wikipedia</ulink> and  <ulink url="http://docs.python.org/lib/re-syntax.html">Python programming language</ulink>. </para></glossdef></glossentry></glosslist></section></article>