Index: openacs-4/packages/acs-core-docs/www/how-do-I.adp
===================================================================
RCS file: /usr/local/cvsroot/openacs-4/packages/acs-core-docs/www/how-do-I.adp,v
diff -u -N -r1.2 -r1.3
--- openacs-4/packages/acs-core-docs/www/how-do-I.adp	7 Aug 2017 23:47:50 -0000	1.2
+++ openacs-4/packages/acs-core-docs/www/how-do-I.adp	8 Nov 2017 09:42:10 -0000	1.3
@@ -12,20 +12,20 @@
 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
 <a name="how-do-I" id="how-do-I"></a>How Do I?</h2></div></div></div><div class="sect2">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="idp140592104646280" id="idp140592104646280"></a>How do I edit the front page of a new site
+<a name="idp140623157103896" id="idp140623157103896"></a>How do I edit the front page of a new site
 through a web interface?</h3></div></div></div><p>The easiest way is to install the Edit-This-Page package.</p><div class="orderedlist"><ol class="orderedlist" type="1">
 <li class="listitem"><p>Log in to the web site as an administrator.</p></li><li class="listitem"><p>Click on Admin &gt; Install Software &gt; Install from OpenACS
 Repository / Install new application</p></li><li class="listitem"><p>Choose Edit This Page and install</p></li><li class="listitem"><p>Follow the instructions within <a class="ulink" href="/doc/edit-this-page/install" target="_top">Edit This Page</a> (the
 link will only work after Edit This Page is installed).</p></li>
 </ol></div>
 </div><div class="sect2">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="idp140592104651656" id="idp140592104651656"></a>How do I let anybody who registers post to
+<a name="idp140623160151304" id="idp140623160151304"></a>How do I let anybody who registers post to
 a weblog?</h3></div></div></div><p>Go to <code class="computeroutput"><a class="ulink" href="/admin/permissions" target="_top">/admin/permissions</a></code>
 and grant Create to Registered Users</p>
 </div><div class="sect2">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="idp140592104653576" id="idp140592104653576"></a>How do I replace the front page of a new
+<a name="idp140623179076680" id="idp140623179076680"></a>How do I replace the front page of a new
 site with the front page of an application on that site</h3></div></div></div><p>Suppose you install a new site and install Weblogger, and you
 want all visitors to see weblogger automatically.</p><div class="orderedlist"><ol class="orderedlist" type="1">
 <li class="listitem"><p>On the front page, click the <code class="computeroutput"><a class="ulink" href="/admin" target="_top">Admin</a></code> button.</p></li><li class="listitem"><p>On the administration page, click <code class="computeroutput">Parameters</code> link.</p></li><li class="listitem"><p>Change the parameter <code class="computeroutput">IndexRedirectUrl</code> to be the URI of the
@@ -35,22 +35,22 @@
 </ol></div>
 </div><div class="sect2">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="idp140592104660232" id="idp140592104660232"></a>How do I put custom functionality on front
+<a name="idp140623178420040" id="idp140623178420040"></a>How do I put custom functionality on front
 page of a new site?</h3></div></div></div><p>Every page within an OpenACS site is part of a <span class="strong"><strong>subsite</strong></span><a class="ulink" href="/doc/acs-subsite" target="_top">More information)</a>. The home
 page of the entire site is the front page is a special, default
-instance of a subsite, served from <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www</code>. If an
-index page is not found there, the default index page for all
+instance of a subsite, served from <code class="computeroutput">/var/lib/aolserver/<em class="replaceable"><code>$OPENACS_SERVICE_NAME</code></em>/www</code>.
+If an index page is not found there, the default index page for all
 subsites is used. To customize the code on the front page, copy the
 default index page from the Subsite package to the Main site and
 edit it:</p><div class="orderedlist"><ol class="orderedlist" type="1">
-<li class="listitem"><pre class="screen"><strong class="userinput"><code>cp <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/packages/acs-subsite/www/index*</code><code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www</code>
+<li class="listitem"><pre class="screen"><strong class="userinput"><code>cp <code class="computeroutput">/var/lib/aolserver/<em class="replaceable"><code>$OPENACS_SERVICE_NAME</code></em>/packages/acs-subsite/www/index*</code><code class="computeroutput">/var/lib/aolserver/<em class="replaceable"><code>$OPENACS_SERVICE_NAME</code></em>/www</code>
 </code></strong></pre></li><li class="listitem"><p>Edit the new <code class="computeroutput">index.adp</code> to
 change the text; you shouldn&#39;t need to edit <code class="computeroutput">index.tcl</code> unless you are adding new
 functionality.</p></li>
 </ol></div>
 </div><div class="sect2">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="idp140592106970264" id="idp140592106970264"></a>How do I change the site-wide style?</h3></div></div></div><p>Almost all pages on an OpenACS site use <a class="ulink" href="/doc/acs-templating" target="_top">ACS Templating</a>, and so
+<a name="idp140623178430728" id="idp140623178430728"></a>How do I change the site-wide style?</h3></div></div></div><p>Almost all pages on an OpenACS site use <a class="ulink" href="/doc/acs-templating" target="_top">ACS Templating</a>, and so
 their appearance is driven by a layer of different files. Let&#39;s
 examine how this works:</p><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc;">
 <li class="listitem">
@@ -59,31 +59,31 @@
 &lt;master&gt;
 </pre><p>If it appears exactly like this, without any arguments, the
 template processor uses <code class="computeroutput">default-master</code> for that subsite. For pages
-in <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www</code>, this
-is <code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www/default-master.adp</code>
+in <code class="computeroutput">/var/lib/aolserver/<em class="replaceable"><code>$OPENACS_SERVICE_NAME</code></em>/www</code>,
+this is <code class="computeroutput">/var/lib/aolserver/<em class="replaceable"><code>$OPENACS_SERVICE_NAME</code></em>/www/default-master.adp</code>
 and the associated .tcl file.</p>
 </li><li class="listitem"><p>The <code class="computeroutput">default-master</code> is itself
 a normal ADP page. It draws the subsite navigation elements and
 invokes <code class="computeroutput">site-master</code>
-(<code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www/site-master.adp</code>
+(<code class="computeroutput">/var/lib/aolserver/<em class="replaceable"><code>$OPENACS_SERVICE_NAME</code></em>/www/site-master.adp</code>
 and .tcl)</p></li><li class="listitem"><p>The <code class="computeroutput">site-master</code> draws
-site-wide navigation elements and invokes <code class="computeroutput">blank-master</code> (<code class="computeroutput">/var/lib/aolserver/<span class="replaceable"><span class="replaceable">$OPENACS_SERVICE_NAME</span></span>/www/blank-master.adp</code>
+site-wide navigation elements and invokes <code class="computeroutput">blank-master</code> (<code class="computeroutput">/var/lib/aolserver/<em class="replaceable"><code>$OPENACS_SERVICE_NAME</code></em>/www/blank-master.adp</code>
 and .tcl).</p></li><li class="listitem"><p>
 <code class="computeroutput">Blank-master</code> does HTML
 housekeeping and provides a framework for special sitewide
 navigation "meta" elements such as Translator widgets and
 Admin widgets.</p></li>
 </ul></div><div class="figure">
-<a name="idp140592106982936" id="idp140592106982936"></a><p class="title"><strong>Figure 4.1. Site
+<a name="idp140623178931720" id="idp140623178931720"></a><p class="title"><strong>Figure 4.1. Site
 Templates</strong></p><div class="figure-contents"><div class="mediaobject"><img src="images/site-templates.png" alt="Site Templates"></div></div>
 </div><br class="figure-break">
 </div><div class="sect2">
 <div class="titlepage"><div><div><h3 class="title">
-<a name="idp140592106985240" id="idp140592106985240"></a>How do I diagnose a permissions
+<a name="idp140623178934424" id="idp140623178934424"></a>How do I diagnose a permissions
 problem?</h3></div></div></div><div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc;">
 <li class="listitem">
 <p>
-<strong>Steps to Reproduce. </strong>The events
+<strong>Steps to Reproduce. </strong> The events
 package does not allow users to register for new events.</p><div class="orderedlist"><ol class="orderedlist" type="1">
 <li class="listitem"><p>Go to the http://yourserver.net/events as a visitor (ie, log out
 and, if necessary, clear cookies). This in on a 4.6.3 site with
@@ -98,7 +98,7 @@
 shown.</p>
 </li><li class="listitem">
 <p>
-<strong>Finding the problem. </strong>We start with
+<strong>Finding the problem. </strong> We start with
 the page that has the error. In the URL it&#39;s <code class="computeroutput">http://myserver.net/events/event-info.tcl</code>,
 so open the file <code class="computeroutput">/var/lib/aolserver/$OPENACS_SERVICE_NAME/packages/events/www/event-info.tcl</code>.
 It contains this line:</p><pre class="programlisting">
@@ -116,20 +116,20 @@
 event.</p>
 </li><li class="listitem">
 <p>
-<strong>Setting Permissions. </strong>A permission
+<strong>Setting Permissions. </strong> A permission
 has three parts: the privilige, the object of the privilige, and
 the subject being granted the privilige. In this case the privilige
 is "write," the object is the Events package, and the
 subject is all Registered Users.</p><div class="orderedlist"><ol class="orderedlist" type="1">
 <li class="listitem"><p>To grant permissions on a package, start at the <a class="ulink" href="/admin/site-map" target="_top">site map</a>. Find the event
 package and click "Set permissions".</p></li><li class="listitem"><p>Click "Grant Permission"</p></li><li class="listitem">
 <p>Grant the write permission to Registered Users.</p><div class="figure">
-<a name="idp140592107005048" id="idp140592107005048"></a><p class="title"><strong>Figure 4.2. Granting
+<a name="idp140623157109688" id="idp140623157109688"></a><p class="title"><strong>Figure 4.2. Granting
 Permissions</strong></p><div class="figure-contents"><div class="mediaobject"><img src="images/grant-perm-463.png" alt="Granting Permissions"></div></div>
 </div><br class="figure-break">
 </li>
 </ol></div><p>OpenACS 5.0 offers a prettier version at <a class="ulink" href="/admin/applications" target="_top">/admin/applications</a>.</p><div class="figure">
-<a name="idp140592107008760" id="idp140592107008760"></a><p class="title"><strong>Figure 4.3. Granting Permissions in
+<a name="idp140623157113640" id="idp140623157113640"></a><p class="title"><strong>Figure 4.3. Granting Permissions in
 5.0</strong></p><div class="figure-contents"><div class="mediaobject"><img src="images/grant-perm-50.png" alt="Granting Permissions in 5.0"></div></div>
 </div><br class="figure-break">
 </li>