changeset 507:45cd2bbb395b

make interwiki install-docs test, misc cleanup imported from: moin--main--1.5--patch-511
author Thomas Waldmann <tw@waldmann-edv.de>
date Sun, 26 Mar 2006 16:44:55 +0000
parents 24463c96f276
children 400516d5adc3
files ChangeLog MoinMoin/__init__.py MoinMoin/_tests/test_repair_language.py MoinMoin/script/old/__init__.py MoinMoin/script/old/migration/__init__.py docs/INSTALL.html setup.py tests/make_test.out wiki/data/intermap.txt
diffstat 9 files changed, 155 insertions(+), 152 deletions(-) [+]
line wrap: on
line diff
--- a/ChangeLog	Sun Mar 26 16:22:23 2006 +0000
+++ b/ChangeLog	Sun Mar 26 16:44:55 2006 +0000
@@ -2,6 +2,31 @@
 # arch-tag: automatic-ChangeLog--arch@arch.thinkmo.de--2003-archives/moin--main--1.5
 #
 
+2006-03-26 17:44:55 GMT	Thomas Waldmann <tw@waldmann-edv.de>	patch-511
+
+    Summary:
+      make interwiki install-docs test, misc cleanup
+    Revision:
+      moin--main--1.5--patch-511
+
+    make interwiki install-docs test, misc cleanup
+    
+
+    new files:
+     MoinMoin/script/old/.arch-ids/__init__.py.id
+     MoinMoin/script/old/__init__.py
+     MoinMoin/script/old/migration/.arch-ids/__init__.py.id
+     MoinMoin/script/old/migration/__init__.py
+
+    removed files:
+     MoinMoin/_tests/.arch-ids/test_repair_language.py.id
+     MoinMoin/_tests/test_repair_language.py
+
+    modified files:
+     ChangeLog MoinMoin/__init__.py docs/INSTALL.html setup.py
+     tests/make_test.out wiki/data/intermap.txt
+
+
 2006-03-26 17:22:23 GMT	Thomas Waldmann <tw@waldmann-edv.de>	patch-510
 
     Summary:
--- a/MoinMoin/__init__.py	Sun Mar 26 16:22:23 2006 +0000
+++ b/MoinMoin/__init__.py	Sun Mar 26 16:44:55 2006 +0000
@@ -1,6 +1,6 @@
 # -*- coding: iso-8859-1 -*-
 """
-MoinMoin Version 1.5.2 patch-497
+MoinMoin Version 1.5.2 patch-510
 
 @copyright: 2000-2006 by Jürgen Hermann <jh@web.de>
 @license: GNU GPL, see COPYING for details.
--- a/MoinMoin/_tests/test_repair_language.py	Sun Mar 26 16:22:23 2006 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,39 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-    MoinMoin - MoinMoin.script.repair_language tests
-
-    @copyright: 2003-2004 by Nir Soffer <nirs@freeshell.org>
-    @license: GNU GPL, see COPYING for details.
-"""
-
-import unittest
-
-from MoinMoin.script.repair_language import repairText
-
-
-class RepairTestCase(unittest.TestCase):
-
-    def testPageContent(self):
-        ''' repair_language: should not replace in page body '''
-        text = 'Should not replace in page content'
-        self.assertEqual((text, 0), repairText(text))
-
-    def testUnknwonLanguage(self):
-        ''' repair_language: should not replace unknown langauge '''
-        text = '##language:ar'
-        self.assertEqual((text, 0), repairText(text))
-    
-    def testKnownLanguage(self):
-        """ repair_language: should replace known language """
-        before = u'##language:en\r\n'
-        after = u'#language en\r\n'
-        self.assertEqual((after, 1), repairText(before))
-
-    def testLineEndings(self):
-        """ repair_language: return crlf line endings """
-        before = (u'##language:en\r\n'
-                  u'page content\r\n')
-        after = (u'#language en\r\n'
-                 u'page content\r\n')
-        self.assertEqual((after, 1), repairText(before))
-        
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/MoinMoin/script/old/__init__.py	Sun Mar 26 16:44:55 2006 +0000
@@ -0,0 +1,8 @@
+# -*- coding: iso-8859-1 -*-
+"""
+    MoinMoin - misc example Scripts
+
+    @copyright: 2004 by Thomas Waldmann
+    @license: GNU GPL, see COPYING for details.
+"""
+
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/MoinMoin/script/old/migration/__init__.py	Sun Mar 26 16:44:55 2006 +0000
@@ -0,0 +1,8 @@
+# -*- coding: iso-8859-1 -*-
+"""
+    MoinMoin - old style migration scripts
+
+    @copyright: 2004 by Thomas Waldmann
+    @license: GNU GPL, see COPYING for details.
+"""
+
--- a/docs/INSTALL.html	Sun Mar 26 16:22:23 2006 +0000
+++ b/docs/INSTALL.html	Sun Mar 26 16:44:55 2006 +0000
@@ -11,7 +11,6 @@
 
 <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="wiki/htdocs/modern/css/common.css">
 <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="wiki/htdocs/modern/css/print.css">
-<link rel="stylesheet" type="text/css" charset="utf-8" media="screen" href="http://moinmaster.wikiwikiweb.de/wiki/master.css">
 <link rel="alternate" title="MoinMaster Recent Changes" href="http://moinmaster.wikiwikiweb.de/RecentChanges?action=rss_rc&amp;ddiffs=1&amp;unique=1" type="application/rss+xml">
 
 <link rel="Start" href="http://moinmaster.wikiwikiweb.de/FrontPage">
@@ -40,94 +39,102 @@
 <h1 id="head-2fa431ad9c9bff5badd07c5ee676b19852ed28e3">Check if Python is working</h1>
 <span class="anchor" id="line-22"></span><span class="anchor" id="line-23"></span><p class="line879">Moin<tt class="backtick"></tt>Moin needs Python to run, so the first step is to check if an usable version of Python is installed and correctly set-up. If this is not the case, you will have to fix that before you can proceed. <span class="anchor" id="line-24"></span></p><span class="anchor" id="line-25"></span><p class="line879">The <tt class="backtick">CHANGES</tt> file in the Moin<tt class="backtick"></tt>Moin archive mentions what versions are supported. Python 2.3 is the minimum requirement for Moin<tt class="backtick"></tt>Moin 1.5, but we suggest you use the latest Python release version. <span class="anchor" id="line-26"></span></p><span class="anchor" id="line-27"></span><p class="line879">You can download Python at <a class="http" href="http://www.python.org/download/">http://www.python.org/download/</a>. <span class="anchor" id="line-28"></span></p><span class="anchor" id="line-29"></span><p class="line879">If you are pretty sure an acceptable version of Python is installed but the commands below do not work, this may be because your Python files are not in the <em>search path</em>. Correctly setting the search path is outside the scope of this document; please ask for help on your favorite Python, Linux, or Windows discussion board. <span class="anchor" id="line-30"></span></p><span class="anchor" id="line-31"></span><p class="line886">If you have shell access, checking if Python is working is very simple. Just type the following command, and look at the result: <span class="anchor" id="line-32"></span><span class="anchor" id="line-33"></span></p><pre>&gt; python -V
 <span class="anchor" id="line-34"></span>Python 2.3.4
-<span class="anchor" id="line-35"></span></pre><span class="anchor" id="line-36"></span><span class="anchor" id="line-37"></span><p class="line879">If you don't have shell access, you can try using this <tt class="backtick">pythontest.cgi</tt> script (it assumes that you are using a Linux kind of webserver). Upload the script to your <tt class="backtick">cgi-bin</tt> directory, use <tt class="backtick">chmod&nbsp;a+rx&nbsp;pythontest.cgi</tt> (or a similar command in your FTP program) to make it executable, and invoke it using your web browser. <span class="anchor" id="line-38"></span><span class="anchor" id="line-39"></span></p><pre>#!/bin/sh
-<span class="anchor" id="line-40"></span>echo Content-Type: text/plain
-<span class="anchor" id="line-41"></span>echo
-<span class="anchor" id="line-42"></span>echo "Your web server is running as:"
-<span class="anchor" id="line-43"></span>id
-<span class="anchor" id="line-44"></span>echo "CGI scripts work"
-<span class="anchor" id="line-45"></span>echo "Now we try to invoke Python interpreters and get their versions:"
-<span class="anchor" id="line-46"></span>python -V 2&gt;&amp;1
-<span class="anchor" id="line-47"></span>python2.3 -V 2&gt;&amp;1
-<span class="anchor" id="line-48"></span>python2.4 -V 2&gt;&amp;1
-<span class="anchor" id="line-49"></span>echo "Finished."
-<span class="anchor" id="line-50"></span></pre><span class="anchor" id="line-51"></span><span class="anchor" id="line-52"></span><p class="line886">If it doesn't display "CGI scripts work", well, then CGI scripts don't work. If it doesn't show one or more Python version numbers, then Python is not correctly installed. In both cases, before you can proceed, you will have to get in touch with the administrator of the server so that the problems get corrected. <span class="anchor" id="line-53"></span></p><span class="anchor" id="line-54"></span><p class="line879">Also be sure to read <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/ApacheOnLinuxFtp">../ApacheOnLinuxFtp</a> after you've completed the <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> illustrated here. <span class="anchor" id="line-55"></span></p><span class="anchor" id="line-56"></span>
+<span class="anchor" id="line-35"></span></pre><span class="anchor" id="line-36"></span><span class="anchor" id="line-37"></span><p class="line879">If you don't have shell access, you can try using this <tt class="backtick">pythontest.cgi</tt> script (it assumes that you are using a Linux kind of webserver). Upload the script to your <tt class="backtick">cgi-bin</tt> directory, use <tt class="backtick">chmod&nbsp;a+rx&nbsp;pythontest.cgi</tt> (or a similar command in your FTP program) to make it executable, and invoke it using your web browser. <span class="anchor" id="line-38"></span></p><span class="anchor" id="line-39"></span><p class="line903"><pre>#!/bin/sh
+echo Content-Type: text/plain
+echo
+echo "Your web server is running as:"
+id
+echo "CGI scripts work"
+echo "Now we try to invoke Python interpreters and get their versions:"
+echo "Your default version of python is:"
+python -V 2&gt;&amp;1
+echo 
+echo "Available versions of python are:"
+python2.2 -V 2&gt;&amp;1 &amp;&amp; which python2.2
+python2.3 -V 2&gt;&amp;1 &amp;&amp; which python2.3
+python2.4 -V 2&gt;&amp;1 &amp;&amp; which python2.4
+python2.5 -V 2&gt;&amp;1 &amp;&amp; which python2.5
+echo "Finished."
+
+</pre><a class="attachment" href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation?action=AttachFile&amp;do=get&amp;target=pythontest.cgi" title="attachment:pythontest.cgi">pythontest.cgi</a> <span class="anchor" id="line-40"></span></p><span class="anchor" id="line-41"></span><p class="line886">If it doesn't display "CGI scripts work", well, then CGI scripts don't work. If it doesn't show one or more Python version numbers, then Python is not correctly installed. In both cases, before you can proceed, you will have to get in touch with the administrator of the server so that the problems get corrected. <span class="anchor" id="line-42"></span></p><span class="anchor" id="line-43"></span><p class="line879">Also be sure to read <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/ApacheOnLinuxFtp">../ApacheOnLinuxFtp</a> after you've completed the <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> illustrated here. <span class="anchor" id="line-44"></span></p><span class="anchor" id="line-45"></span>
 <h1 id="head-119b1acf8110bb618e4f366c3d1f8a35ad625f75">Download MoinMoin</h1>
-<span class="anchor" id="line-57"></span><span class="anchor" id="line-58"></span><p class="line879">To download the distribution archive, go to the <a class="http" href="http://sourceforge.net/project/showfiles.php?group_id=8482">download area</a> and fetch the latest archive. <span class="anchor" id="line-59"></span></p><span class="anchor" id="line-60"></span><p class="line879">The next step is to unpack the distribution archive (which you have done already if you are reading this text from your hard drive). If you read this on the web, the distribution comes in a versioned <tt class="backtick">.tar.gz</tt> archive, which you can unpack as shown below. <span class="anchor" id="line-61"></span></p><span class="anchor" id="line-62"></span><ul><li><p class="line886">On Windows <span class="anchor" id="line-63"></span></p><ul><li><p class="line879">You can use recent versions of programs like Win<tt class="backtick"></tt>Zip, Win<tt class="backtick"></tt>Rar, and Win<tt class="backtick"></tt>Ace, which handle .tar.gz kind of archives. <span class="anchor" id="line-64"></span></p></li><li><p class="line879">At the command prompt, you can use <a class="http" href="http://gnuwin32.sourceforge.net/packages/gzip.htm">GNU gzip</a> and <a class="http" href="http://gnuwin32.sourceforge.net/packages/tar.htm">GNU tar</a> for Windows. <span class="anchor" id="line-65"></span></p></li></ul></li><li><p class="line886">On Linux <span class="anchor" id="line-66"></span></p><ul><li><p class="line886">You can use your favorite file manager -- it should be able to unpack them. <span class="anchor" id="line-67"></span></p></li><li><p class="line879">At any shell prompt, you can use the <tt class="backtick">tar</tt> command. <span class="anchor" id="line-68"></span></p><span class="anchor" id="line-69"></span></li></ul></li></ul><p class="line879">The distribution archive will always unpack into a directory named <tt class="backtick">moin-&lt;version&gt;</tt>, for example <tt class="backtick">moin-1.5</tt>. <span class="anchor" id="line-70"></span></p><span class="anchor" id="line-71"></span><p class="line879">Here is how you would unpack the archive (using GNU tar) and enter the directory with the Moin<tt class="backtick"></tt>Moin files: <span class="anchor" id="line-72"></span><span class="anchor" id="line-73"></span></p><pre>&gt; tar xzf moin-1.5.0.tar.gz
-<span class="anchor" id="line-74"></span>&gt; cd moin-1.5.0
-<span class="anchor" id="line-75"></span></pre><span class="anchor" id="line-76"></span><span class="anchor" id="line-77"></span>
+<span class="anchor" id="line-46"></span><span class="anchor" id="line-47"></span><p class="line879">To download the distribution archive, go to the <a class="http" href="http://sourceforge.net/project/showfiles.php?group_id=8482">download area</a> and fetch the latest archive. <span class="anchor" id="line-48"></span></p><span class="anchor" id="line-49"></span><p class="line879">The next step is to unpack the distribution archive (which you have done already if you are reading this text from your hard drive). If you read this on the web, the distribution comes in a versioned <tt class="backtick">.tar.gz</tt> archive, which you can unpack as shown below. <span class="anchor" id="line-50"></span></p><span class="anchor" id="line-51"></span><ul><li><p class="line886">On Windows <span class="anchor" id="line-52"></span></p><ul><li><p class="line879">You can use recent versions of programs like Win<tt class="backtick"></tt>Zip, Win<tt class="backtick"></tt>Rar, and Win<tt class="backtick"></tt>Ace, which handle .tar.gz kind of archives. <span class="anchor" id="line-53"></span></p></li><li><p class="line879">At the command prompt, you can use <a class="http" href="http://gnuwin32.sourceforge.net/packages/gzip.htm">GNU gzip</a> and <a class="http" href="http://gnuwin32.sourceforge.net/packages/tar.htm">GNU tar</a> for Windows. <span class="anchor" id="line-54"></span></p></li></ul></li><li><p class="line886">On Linux <span class="anchor" id="line-55"></span></p><ul><li><p class="line886">You can use your favorite file manager -- it should be able to unpack them. <span class="anchor" id="line-56"></span></p></li><li><p class="line879">At any shell prompt, you can use the <tt class="backtick">tar</tt> command. <span class="anchor" id="line-57"></span></p><span class="anchor" id="line-58"></span></li></ul></li></ul><p class="line879">The distribution archive will always unpack into a directory named <tt class="backtick">moin-&lt;version&gt;</tt>, for example <tt class="backtick">moin-1.5</tt>. <span class="anchor" id="line-59"></span></p><span class="anchor" id="line-60"></span><p class="line879">Here is how you would unpack the archive (using GNU tar) and enter the directory with the Moin<tt class="backtick"></tt>Moin files: <span class="anchor" id="line-61"></span><span class="anchor" id="line-62"></span></p><pre>&gt; tar xzf moin-1.5.0.tar.gz
+<span class="anchor" id="line-63"></span>&gt; cd moin-1.5.0
+<span class="anchor" id="line-64"></span></pre><span class="anchor" id="line-65"></span><span class="anchor" id="line-66"></span>
 <h1 id="head-a84e58c8b4256bd645b9c47b5a900219a356259f">Install MoinMoin</h1>
-<span class="anchor" id="line-78"></span><span class="anchor" id="line-79"></span><p class="line879">You can install Moin<tt class="backtick"></tt>Moin to either: <span class="anchor" id="line-80"></span></p><ul><li><p class="line886">a system location (if you have the necessary rights to do that -- on Linux you need to be root) <span class="anchor" id="line-81"></span></p></li><li><p class="line879">some specific location, like your home directory (Linux) or <tt class="backtick">C:\moin</tt> (Windows). <span class="anchor" id="line-82"></span></p><span class="anchor" id="line-83"></span></li></ul><p class="line886">The installation to a system location is easier, so choose that if possible. <span class="anchor" id="line-84"></span></p><span class="anchor" id="line-85"></span><p class="line903"><img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> If you have several versions of Python installed, please use the same version for setup and for running the wiki. Usually, the latest Python version will get the best results. <span class="anchor" id="line-86"></span></p><span class="anchor" id="line-87"></span><p class="line879">If you have problems with the <tt class="backtick">setup.py</tt> install step, try using the command: <span class="anchor" id="line-88"></span><span class="anchor" id="line-89"></span></p><pre>&gt; python -v setup.py --quiet install --record=install.log
-<span class="anchor" id="line-90"></span></pre><span class="anchor" id="line-91"></span><span class="anchor" id="line-92"></span><p class="line879">The additional <tt class="backtick">-v</tt> flag should provide you detailed verbose messages every step of the way. <span class="anchor" id="line-93"></span></p><span class="anchor" id="line-94"></span><p class="line903"><img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> On Linux, if u get an error like <tt class="backtick">Invalid&nbsp;Python&nbsp;installation:&nbsp;cannot&nbsp;find&nbsp;/usr/lib/Python2.x/config/Makefile</tt>, you may not have the python module <strong><tt class="backtick">distutils</tt></strong> installed, it's usually a part of the <strong>Python development libarary (<tt class="backtick">python-dev</tt>)</strong>. Some Linux distributions may not have installed it by default. For example, on Mandrake you need to install the <strong><tt class="backtick">python-devel</tt></strong> package, on Debian it's called <strong><tt class="backtick">python-dev</tt></strong>. <span class="anchor" id="line-95"></span></p><span class="anchor" id="line-96"></span>
+<span class="anchor" id="line-67"></span><span class="anchor" id="line-68"></span><p class="line879">You can install Moin<tt class="backtick"></tt>Moin to either: <span class="anchor" id="line-69"></span></p><ul><li><p class="line886">a system location (if you have the necessary rights to do that -- on Linux you need to be root) <span class="anchor" id="line-70"></span></p></li><li><p class="line879">some specific location, like your home directory (Linux) or <tt class="backtick">C:\moin</tt> (Windows). <span class="anchor" id="line-71"></span></p><span class="anchor" id="line-72"></span></li></ul><p class="line886">The installation to a system location is easier, so choose that if possible. <span class="anchor" id="line-73"></span></p><span class="anchor" id="line-74"></span><p class="line903"><img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> If you have several versions of Python installed, please use the same version for setup and for running the wiki. Usually, the latest Python version will get the best results. <span class="anchor" id="line-75"></span></p><span class="anchor" id="line-76"></span><p class="line879">If you have problems with the <tt class="backtick">setup.py</tt> install step, try using the command: <span class="anchor" id="line-77"></span><span class="anchor" id="line-78"></span></p><pre>&gt; python -v setup.py --quiet install --record=install.log
+<span class="anchor" id="line-79"></span></pre><span class="anchor" id="line-80"></span><span class="anchor" id="line-81"></span><p class="line879">The additional <tt class="backtick">-v</tt> flag should provide you detailed verbose messages every step of the way. <span class="anchor" id="line-82"></span></p><span class="anchor" id="line-83"></span><p class="line903"><img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> On Linux, if u get an error like <tt class="backtick">Invalid&nbsp;Python&nbsp;installation:&nbsp;cannot&nbsp;find&nbsp;/usr/lib/Python2.x/config/Makefile</tt>, you may not have the python module <strong><tt class="backtick">distutils</tt></strong> installed, it's usually a part of the <strong>Python development libarary (<tt class="backtick">python-dev</tt>)</strong>. Some Linux distributions may not have installed it by default. For example, on Mandrake you need to install the <strong><tt class="backtick">python-devel</tt></strong> package, on Debian it's called <strong><tt class="backtick">python-dev</tt></strong>. <span class="anchor" id="line-84"></span></p><span class="anchor" id="line-85"></span>
 <h2 id="head-640b21abea127e7ac4b48c938607c233b7119bd5">Installing in the default system location</h2>
-<span class="anchor" id="line-97"></span><span class="anchor" id="line-98"></span><span class="anchor" id="line-99"></span><pre>&gt; python setup.py --quiet install --record=install.log
-<span class="anchor" id="line-100"></span></pre><span class="anchor" id="line-101"></span><span class="anchor" id="line-102"></span><p class="line879">This installs Moin<tt class="backtick"></tt>Moin to the default system location (typically the Python directory, for example on Linux, inside <tt class="backtick">/usr/lib</tt> and <tt class="backtick">/usr/share</tt>). Look at the <tt class="backtick">install.log</tt> file to see what was installed, and where. <span class="anchor" id="line-103"></span></p><span class="anchor" id="line-104"></span><ul><li><p class="line886">Mac OS X note: use the command: <span class="anchor" id="line-105"></span><span class="anchor" id="line-106"></span></p><pre>python setup.py install --install-data='/usr/local'
-<span class="anchor" id="line-107"></span></pre><span class="anchor" id="line-108"></span><p class="line886">This will install the shared files to '/usr/local/share/moin', instead of an inconvenient location in the System folder. <span class="anchor" id="line-109"></span></p><span class="anchor" id="line-110"></span></li></ul>
+<span class="anchor" id="line-86"></span><span class="anchor" id="line-87"></span><span class="anchor" id="line-88"></span><pre>&gt; python setup.py --quiet install --record=install.log
+<span class="anchor" id="line-89"></span></pre><span class="anchor" id="line-90"></span><span class="anchor" id="line-91"></span><p class="line879">This installs Moin<tt class="backtick"></tt>Moin to the default system location (typically the Python directory, for example on Linux, inside <tt class="backtick">/usr/lib</tt> and <tt class="backtick">/usr/share</tt>). Look at the <tt class="backtick">install.log</tt> file to see what was installed, and where. <span class="anchor" id="line-92"></span></p><span class="anchor" id="line-93"></span><ul><li><p class="line886">Mac OS X note: use the command: <span class="anchor" id="line-94"></span><span class="anchor" id="line-95"></span></p><pre>python setup.py install --install-data='/usr/local'
+<span class="anchor" id="line-96"></span></pre><span class="anchor" id="line-97"></span><p class="line886">This will install the shared files to '/usr/local/share/moin', instead of an inconvenient location in the System folder. <span class="anchor" id="line-98"></span></p><span class="anchor" id="line-99"></span></li></ul>
 <h2 id="head-ae8ab55eb5e8c11d4fd1eb06e12d69f1b33d411b">Installing in the home directory or another specific location</h2>
-<span class="anchor" id="line-111"></span><span class="anchor" id="line-112"></span><p class="line886">Linux example, installing in the home directory: <span class="anchor" id="line-113"></span><span class="anchor" id="line-114"></span></p><pre>&gt; python setup.py --quiet install --prefix=$HOME --record=install.log
-<span class="anchor" id="line-115"></span></pre><span class="anchor" id="line-116"></span><span class="anchor" id="line-117"></span><p class="line879">Windows example, installing in the <tt class="backtick">C:\moin</tt> directory: <span class="anchor" id="line-118"></span><span class="anchor" id="line-119"></span></p><pre>&gt; python setup.py --quiet install --prefix="C:\moin" --record=install.log
-<span class="anchor" id="line-120"></span></pre><span class="anchor" id="line-121"></span><span class="anchor" id="line-122"></span><p class="line879">All Moin<tt class="backtick"></tt>Moin files will then be installed inside those directories, see <tt class="backtick">install.log</tt> to know which files were installed, and where. <span class="anchor" id="line-123"></span></p><span class="anchor" id="line-124"></span><p class="line903"><strong>Note:</strong> You will likely see the following warning: <span class="anchor" id="line-125"></span></p><span class="anchor" id="line-126"></span><ul><li style="list-style-type:none"><p class="line903"><tt class="backtick">warning:&nbsp;install:&nbsp;modules&nbsp;installed&nbsp;to&nbsp;'C:\moin\',&nbsp;which</tt><br />
- <span class="anchor" id="line-127"></span><tt class="backtick">is&nbsp;not&nbsp;in&nbsp;Python's&nbsp;module&nbsp;search&nbsp;path&nbsp;(sys.path)&nbsp;--&nbsp;you'll</tt><br />
- <span class="anchor" id="line-128"></span><tt class="backtick">have&nbsp;to&nbsp;change&nbsp;the&nbsp;search&nbsp;path&nbsp;yourself</tt> <span class="anchor" id="line-129"></span></p><span class="anchor" id="line-130"></span></li></ul><p class="line879">This means exactly what it says, you need to add your install directory to the search path of Python, or it won't find the Moin<tt class="backtick"></tt>Moin code. <span class="anchor" id="line-131"></span></p><span class="anchor" id="line-132"></span><p class="line879">For example, if you are running using a webserver and standard CGI, edit <tt class="backtick">moin.cgi</tt> and add your installation directory to the Python path, like this: <span class="anchor" id="line-133"></span><span class="anchor" id="line-134"></span></p><pre>import sys
-<span class="anchor" id="line-135"></span>sys.path.insert(0, 'C:/moin')
-<span class="anchor" id="line-136"></span></pre><span class="anchor" id="line-137"></span><span class="anchor" id="line-138"></span>
+<span class="anchor" id="line-100"></span><span class="anchor" id="line-101"></span><p class="line886">Linux example, installing in the home directory: <span class="anchor" id="line-102"></span><span class="anchor" id="line-103"></span></p><pre>&gt; python setup.py --quiet install --prefix=$HOME --record=install.log
+<span class="anchor" id="line-104"></span></pre><span class="anchor" id="line-105"></span><span class="anchor" id="line-106"></span><p class="line879">Windows example, installing in the <tt class="backtick">C:\moin</tt> directory: <span class="anchor" id="line-107"></span><span class="anchor" id="line-108"></span></p><pre>&gt; python setup.py --quiet install --prefix="C:\moin" --record=install.log
+<span class="anchor" id="line-109"></span></pre><span class="anchor" id="line-110"></span><span class="anchor" id="line-111"></span><p class="line879">All Moin<tt class="backtick"></tt>Moin files will then be installed inside those directories, see <tt class="backtick">install.log</tt> to know which files were installed, and where. <span class="anchor" id="line-112"></span></p><span class="anchor" id="line-113"></span><p class="line903"><strong>Note:</strong> You will likely see the following warning: <span class="anchor" id="line-114"></span></p><span class="anchor" id="line-115"></span><ul><li style="list-style-type:none"><p class="line903"><tt class="backtick">warning:&nbsp;install:&nbsp;modules&nbsp;installed&nbsp;to&nbsp;'C:\moin\',&nbsp;which</tt><br />
+ <span class="anchor" id="line-116"></span><tt class="backtick">is&nbsp;not&nbsp;in&nbsp;Python's&nbsp;module&nbsp;search&nbsp;path&nbsp;(sys.path)&nbsp;--&nbsp;you'll</tt><br />
+ <span class="anchor" id="line-117"></span><tt class="backtick">have&nbsp;to&nbsp;change&nbsp;the&nbsp;search&nbsp;path&nbsp;yourself</tt> <span class="anchor" id="line-118"></span></p><span class="anchor" id="line-119"></span></li></ul><p class="line879">This means exactly what it says, you need to add your install directory to the search path of Python, or it won't find the Moin<tt class="backtick"></tt>Moin code. <span class="anchor" id="line-120"></span></p><span class="anchor" id="line-121"></span><p class="line879">For example, if you are running using a webserver and standard CGI, edit <tt class="backtick">moin.cgi</tt> and add your installation directory to the Python path, like this: <span class="anchor" id="line-122"></span><span class="anchor" id="line-123"></span></p><pre>import sys
+<span class="anchor" id="line-124"></span>sys.path.insert(0, 'C:/moin')
+<span class="anchor" id="line-125"></span></pre><span class="anchor" id="line-126"></span><span class="anchor" id="line-127"></span>
 <h1 id="head-d7d600c8dcfdd9270f4a6642566404ede510f46a">Test installation</h1>
-<span class="anchor" id="line-139"></span><span class="anchor" id="line-140"></span><p class="line879">As a final step, if you have access to the shell or the command prompt, you can check that everything is correctly installed and ready to run. Start Python and type <tt class="backtick">import&nbsp;MoinMoin</tt>. Nothing should be displayed in response to this command. Example: <span class="anchor" id="line-141"></span></p><span class="anchor" id="line-142"></span><span class="anchor" id="line-143"></span><pre>&gt; python
-<span class="anchor" id="line-144"></span>Python 2.3.4 (#1, May 29 2004, 17:05:23)
-<span class="anchor" id="line-145"></span>[GCC 3.3.3] on linux2
-<span class="anchor" id="line-146"></span>Type "help", "copyright", "credits" or "license" for more information.
-<span class="anchor" id="line-147"></span>&gt;&gt;&gt; import MoinMoin
-<span class="anchor" id="line-148"></span>&gt;&gt;&gt;
-<span class="anchor" id="line-149"></span></pre><span class="anchor" id="line-150"></span><span class="anchor" id="line-151"></span><p class="line886">If you get this instead: <span class="anchor" id="line-152"></span></p><span class="anchor" id="line-153"></span><span class="anchor" id="line-154"></span><pre>&gt;&gt;&gt; import MoinMoin
-<span class="anchor" id="line-155"></span>Traceback (most recent call last):
-<span class="anchor" id="line-156"></span>  File "&lt;stdin&gt;", line 1, in ?
-<span class="anchor" id="line-157"></span>ImportError: No module named MoinMoin
-<span class="anchor" id="line-158"></span>&gt;&gt;&gt;
-<span class="anchor" id="line-159"></span></pre><span class="anchor" id="line-160"></span><span class="anchor" id="line-161"></span><p class="line879">then you have to tune your installation. Try modifying <tt class="backtick">sys.path</tt>, as described above. <span class="anchor" id="line-162"></span></p><span class="anchor" id="line-163"></span>
+<span class="anchor" id="line-128"></span><span class="anchor" id="line-129"></span><p class="line879">As a final step, if you have access to the shell or the command prompt, you can check that everything is correctly installed and ready to run. Start Python and type <tt class="backtick">import&nbsp;MoinMoin</tt>. Nothing should be displayed in response to this command. Example: <span class="anchor" id="line-130"></span></p><span class="anchor" id="line-131"></span><span class="anchor" id="line-132"></span><pre>&gt; python
+<span class="anchor" id="line-133"></span>Python 2.3.4 (#1, May 29 2004, 17:05:23)
+<span class="anchor" id="line-134"></span>[GCC 3.3.3] on linux2
+<span class="anchor" id="line-135"></span>Type "help", "copyright", "credits" or "license" for more information.
+<span class="anchor" id="line-136"></span>&gt;&gt;&gt; import MoinMoin
+<span class="anchor" id="line-137"></span>&gt;&gt;&gt;
+<span class="anchor" id="line-138"></span></pre><span class="anchor" id="line-139"></span><span class="anchor" id="line-140"></span><p class="line886">If you get this instead: <span class="anchor" id="line-141"></span></p><span class="anchor" id="line-142"></span><span class="anchor" id="line-143"></span><pre>&gt;&gt;&gt; import MoinMoin
+<span class="anchor" id="line-144"></span>Traceback (most recent call last):
+<span class="anchor" id="line-145"></span>  File "&lt;stdin&gt;", line 1, in ?
+<span class="anchor" id="line-146"></span>ImportError: No module named MoinMoin
+<span class="anchor" id="line-147"></span>&gt;&gt;&gt;
+<span class="anchor" id="line-148"></span></pre><span class="anchor" id="line-149"></span><span class="anchor" id="line-150"></span><p class="line879">then you have to tune your installation. Try modifying <tt class="backtick">sys.path</tt>, as described above. <span class="anchor" id="line-151"></span></p><span class="anchor" id="line-152"></span>
 <h1 id="head-87a60f1d02c36fb1804b442815dba49cbc8adfe7">What has been installed</h1>
-<span class="anchor" id="line-164"></span><span class="anchor" id="line-165"></span><p class="line879">So, you have a ready-to-work Moin<tt class="backtick"></tt>Moin installation now. Congratulations! Before you go on to configuring it, take a look at the various files and directories that have been installed. <span class="anchor" id="line-166"></span></p><span class="anchor" id="line-167"></span><p class="line903"><img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> It is important that you understand the different locations used in a Moin<tt class="backtick"></tt>Moin setup, so read this carefully. <span class="anchor" id="line-168"></span></p><span class="anchor" id="line-169"></span><p class="line879">In the following descriptions, <tt class="backtick">PREFIX</tt> is what you used with the <tt class="backtick">setup.py</tt> command, or a default location if you didn't use the <tt class="backtick">--prefix</tt> option. (Typical default values on Linux are <tt class="backtick">/usr</tt> and <tt class="backtick">/usr/local</tt>.) <tt class="backtick">X.Y</tt> is the version of Python. Typically, this is <tt class="backtick">2.3</tt> or <tt class="backtick">2.4</tt>. <span class="anchor" id="line-170"></span></p><span class="anchor" id="line-171"></span><p class="line879">Look into <tt class="backtick">install.log</tt> to find out about following important locations: <span class="anchor" id="line-172"></span></p><span class="anchor" id="line-173"></span><ul><li><p class="line903"><strong><tt class="backtick">MoinMoin</tt> directory</strong>, usually <tt class="backtick">PREFIX/lib/pythonX.Y/site-packages/MoinMoin</tt> -- this is where the Moin<tt class="backtick"></tt>Moin <strong>source code</strong> is located <span class="anchor" id="line-174"></span></p></li><li><p class="line903"><strong><tt class="backtick">share</tt> directory</strong>, usually <tt class="backtick">PREFIX/share/moin</tt> - this is where the <em>templates</em> are located <span class="anchor" id="line-175"></span></p><ul><li><p class="line903"><strong><tt class="backtick">data</tt></strong> directory (wiki pages, users, etc.) - only Moin<tt class="backtick"></tt>Moin should access this <span class="anchor" id="line-176"></span></p></li><li><p class="line903"><strong><tt class="backtick">underlay</tt></strong> directory (wiki pages) - only Moin<tt class="backtick"></tt>Moin should access this <span class="anchor" id="line-177"></span></p></li><li><p class="line903"><strong><tt class="backtick">htdocs</tt></strong> directory with html support files (images for the various themes, etc.) - the web server will need to access this <span class="anchor" id="line-178"></span></p></li><li><p class="line903"><strong><tt class="backtick">server</tt></strong> - Moin<tt class="backtick"></tt>Moin example startup files (like <tt class="backtick">moin.cgi</tt> for CGI, and other files for other startup methods) <span class="anchor" id="line-179"></span></p></li><li><p class="line903"><strong><tt class="backtick">config</tt></strong> - Moin<tt class="backtick"></tt>Moin example configuration files (like <tt class="backtick">wikiconfig.py</tt>) <span class="anchor" id="line-180"></span></p></li></ul></li><li><p class="line903"><strong><tt class="backtick">bin</tt></strong> directory with some scripts that help you use the Moin<tt class="backtick"></tt>Moin shell commands <span class="anchor" id="line-181"></span></p><span class="anchor" id="line-182"></span></li></ul><p class="line879">We talk of <em>templates</em> in the <tt class="backtick">share</tt> directory because you usually will not use those files at that location, but copy them elsewhere when you need them. This way, you can set-up several wikis without problems, and easily upgrade to new Moin<tt class="backtick"></tt>Moin versions. <span class="anchor" id="line-183"></span></p><span class="anchor" id="bottom_Include_HelpOnInstalling/BasicInstallation"></span></div> <span class="anchor" id="line-48"></span><hr class="hr2" /><p class="line886"> <span class="anchor" id="line-49"></span><span class="anchor" id="wikiinstance-creation"></span> <span class="anchor" id="line-50"></span><div dir="ltr" id="Include_HelpOnInstalling/WikiInstanceCreation" lang="en"><span class="anchor" id="top_Include_HelpOnInstalling/WikiInstanceCreation"></span>
-<span class="anchor" id="line-8"></span><span class="anchor" id="line-9"></span><p class="line879">After you have downloaded and installed Moin<tt class="backtick"></tt>Moin, you will want to "have a wiki". As explained at the bottom of <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a>, you have to copy several directories and files. This way, you can have as many wikis as you want, and you can easily upgrade Moin<tt class="backtick"></tt>Moin: only the original files will be overwritten, not your copies. <span class="anchor" id="line-10"></span></p><span class="anchor" id="line-11"></span><p class="line879">Every time you copy those files (and modify the configuration of your server accordingly), you create what is called a <em>wiki instance</em>. Each wiki instance is independant from the others, with a different configuration, different pages, different users, etc. <span class="anchor" id="line-12"></span></p><span class="anchor" id="line-13"></span><p class="line886">Some of the steps you need to take depend on which web server and which operating system you use. They are described on dedicated pages, which you should read (at least the beginning) before reading this one. Some other steps are common to every webserver and operating system (copying files around, setting permissions), and this is what is described here. <span class="anchor" id="line-14"></span></p><span class="anchor" id="line-15"></span>
+<span class="anchor" id="line-153"></span><span class="anchor" id="line-154"></span><p class="line879">So, you have a ready-to-work Moin<tt class="backtick"></tt>Moin installation now. Congratulations! Before you go on to configuring it, take a look at the various files and directories that have been installed. <span class="anchor" id="line-155"></span></p><span class="anchor" id="line-156"></span><p class="line903"><img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> It is important that you understand the different locations used in a Moin<tt class="backtick"></tt>Moin setup, so read this carefully. <span class="anchor" id="line-157"></span></p><span class="anchor" id="line-158"></span><p class="line879">In the following descriptions, <tt class="backtick">PREFIX</tt> is what you used with the <tt class="backtick">setup.py</tt> command, or a default location if you didn't use the <tt class="backtick">--prefix</tt> option. (Typical default values on Linux are <tt class="backtick">/usr</tt> and <tt class="backtick">/usr/local</tt>.) <tt class="backtick">X.Y</tt> is the version of Python. Typically, this is <tt class="backtick">2.3</tt> or <tt class="backtick">2.4</tt>. <span class="anchor" id="line-159"></span></p><span class="anchor" id="line-160"></span><p class="line879">Look into <tt class="backtick">install.log</tt> to find out about following important locations: <span class="anchor" id="line-161"></span></p><span class="anchor" id="line-162"></span><ul><li><p class="line903"><strong><tt class="backtick">MoinMoin</tt> directory</strong>, usually <tt class="backtick">PREFIX/lib/pythonX.Y/site-packages/MoinMoin</tt> -- this is where the Moin<tt class="backtick"></tt>Moin <strong>source code</strong> is located <span class="anchor" id="line-163"></span></p></li><li><p class="line903"><strong><tt class="backtick">share</tt> directory</strong>, usually <tt class="backtick">PREFIX/share/moin</tt> - this is where the <em>templates</em> are located <span class="anchor" id="line-164"></span></p><ul><li><p class="line903"><strong><tt class="backtick">data</tt></strong> directory (wiki pages, users, etc.) - only Moin<tt class="backtick"></tt>Moin should access this <span class="anchor" id="line-165"></span></p></li><li><p class="line903"><strong><tt class="backtick">underlay</tt></strong> directory (wiki pages) - only Moin<tt class="backtick"></tt>Moin should access this <span class="anchor" id="line-166"></span></p></li><li><p class="line903"><strong><tt class="backtick">htdocs</tt></strong> directory with html support files (images for the various themes, etc.) - the web server will need to access this <span class="anchor" id="line-167"></span></p></li><li><p class="line903"><strong><tt class="backtick">server</tt></strong> - Moin<tt class="backtick"></tt>Moin example startup files (like <tt class="backtick">moin.cgi</tt> for CGI, and other files for other startup methods) <span class="anchor" id="line-168"></span></p></li><li><p class="line903"><strong><tt class="backtick">config</tt></strong> - Moin<tt class="backtick"></tt>Moin example configuration files (like <tt class="backtick">wikiconfig.py</tt>) <span class="anchor" id="line-169"></span></p></li></ul></li><li><p class="line903"><strong><tt class="backtick">bin</tt></strong> directory with some scripts that help you use the Moin<tt class="backtick"></tt>Moin shell commands <span class="anchor" id="line-170"></span></p><span class="anchor" id="line-171"></span></li></ul><p class="line879">We talk of <em>templates</em> in the <tt class="backtick">share</tt> directory because you usually will not use those files at that location, but copy them elsewhere when you need them. This way, you can set-up several wikis without problems, and easily upgrade to new Moin<tt class="backtick"></tt>Moin versions. <span class="anchor" id="line-172"></span></p><span class="anchor" id="bottom_Include_HelpOnInstalling/BasicInstallation"></span></div> <span class="anchor" id="line-48"></span><hr class="hr2" /><p class="line886"> <span class="anchor" id="line-49"></span><span class="anchor" id="wikiinstance-creation"></span> <span class="anchor" id="line-50"></span><div dir="ltr" id="Include_HelpOnInstalling/WikiInstanceCreation" lang="en"><span class="anchor" id="top_Include_HelpOnInstalling/WikiInstanceCreation"></span>
+<span class="anchor" id="line-8"></span><span class="anchor" id="line-9"></span><p class="line879">After you have downloaded and installed Moin<tt class="backtick"></tt>Moin, you will want to "have a wiki". As explained at the bottom of <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a>, you have to copy several directories and files. This way, you can have as many wikis as you want, and you can easily upgrade Moin<tt class="backtick"></tt>Moin: only the original files will be overwritten, not your copies. <span class="anchor" id="line-10"></span></p><span class="anchor" id="line-11"></span><p class="line879">Every time you copy those files (and modify the configuration of your server accordingly), you create what is called a <em>wiki instance</em>. Each wiki instance is independant from the others, with a different configuration, different pages, different users, etc. <span class="anchor" id="line-12"></span></p><span class="anchor" id="line-13"></span><p class="line886">Some of the steps you need to take depend on which web server and which operating system you use. They are described on dedicated pages, which you should read (at least the beginning) before reading this one. Some other steps are common to every webserver and operating system (copying files around, setting permissions), and this is what is described here. <span class="anchor" id="line-14"></span></p><span class="anchor" id="line-15"></span><p class="line879">You can use <a class="attachment" href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/WikiInstanceCreation?action=AttachFile&amp;do=get&amp;target=createinstance.sh" title="attachment:createinstance.sh">createinstance.sh</a> (a bash script that install the instance). <span class="anchor" id="line-16"></span></p><span class="anchor" id="line-17"></span>
 <h1 id="head-8c227c275465dec3f8e3b326d53f9566727c5648">Read this first</h1>
-<span class="anchor" id="line-16"></span><span class="anchor" id="line-17"></span>
+<span class="anchor" id="line-18"></span><span class="anchor" id="line-19"></span>
 <h2 id="head-6e91ed0b234e903763a945b5249e7de8b726e5d7">Security warnings</h2>
-<span class="anchor" id="line-18"></span><span class="anchor" id="line-19"></span><div><table style="color: red"><tbody><tr>  <td><p class="line879"> <img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> <strong>Warning: make sure that your <tt class="backtick">data</tt> directory and your configuration files are not accessible through your web server. Do not put your wiki directory in <tt class="backtick">public_html</tt>, <tt class="backtick">Sites</tt> or any other directory your web server can access. The web server only needs to access the file in the <tt class="backtick">htdocs</tt> directory and the <tt class="backtick">moin.cgi</tt> script! (Or whatever script your server uses to start Moin<tt class="backtick"></tt>Moin.)</strong> </p></td>
+<span class="anchor" id="line-20"></span><span class="anchor" id="line-21"></span><div><table><tbody><tr>  <td><p class="line879"> <img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> <strong>Warning: make sure that your <tt class="backtick">data</tt> directory and your configuration files are not accessible through your web server. Do not put your wiki directory in <tt class="backtick">public_html</tt>, <tt class="backtick">Sites</tt> or any other directory your web server can access. The web server only needs to access the file in the <tt class="backtick">htdocs</tt> directory and the <tt class="backtick">moin.cgi</tt> script! (Or whatever script your server uses to start Moin<tt class="backtick"></tt>Moin.)</strong> </p></td>
 </tr>
-<span class="anchor" id="line-20"></span></tbody></table></div><span class="anchor" id="line-21"></span><div><table style="color: red"><tbody><tr>  <td><p class="line879"> <img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> <strong>Warning: make sure that the <tt class="backtick">data</tt> directory and its subdirectories are not readable and not writeable by users other than the web server user. If you need to give worldwide read-write permissions to get it working, be aware that you are doing a very unsecure setup, that can be compromised by any other user or program on your computer.</strong> </p></td>
+<span class="anchor" id="line-22"></span></tbody></table></div><span class="anchor" id="line-23"></span><div><table><tbody><tr>  <td><p class="line879"> <img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> <strong>Warning: make sure that the <tt class="backtick">data</tt> directory and its subdirectories are not readable and not writeable by users other than the web server user. If you need to give worldwide read-write permissions to get it working, be aware that you are doing a very unsecure setup, that can be compromised by any other user or program on your computer.</strong> </p></td>
 </tr>
-<span class="anchor" id="line-22"></span></tbody></table></div><span class="anchor" id="line-23"></span>
+<span class="anchor" id="line-24"></span></tbody></table></div><span class="anchor" id="line-25"></span>
 <h2 id="head-942d29849126a576afcc19bdbfd59c661739eb55">Note to Windows users</h2>
-<span class="anchor" id="line-24"></span><span class="anchor" id="line-25"></span><p class="line886">All the commands below are Linux commands. The text descriptions that introduce them should be enough to help you understand what you need to do. Use the Windows Explorer, or the appropriate text-mode commands. <span class="anchor" id="line-26"></span></p><span class="anchor" id="line-27"></span>
+<span class="anchor" id="line-26"></span><span class="anchor" id="line-27"></span><p class="line886">All the commands below are Linux commands. The text descriptions that introduce them should be enough to help you understand what you need to do. Use the Windows Explorer, or the appropriate text-mode commands. <span class="anchor" id="line-28"></span></p><span class="anchor" id="line-29"></span>
 <h1 id="head-66ec28f32e6870e96f6062a4a6ac77bbb4606109">Choose a wiki name</h1>
-<span class="anchor" id="line-28"></span><span class="anchor" id="line-29"></span><p class="line886">Choose a unique name for the new wiki instance you want to create. It should be a short word, something that reflects what you intend to use the wiki for, like the name of your organization, of your team, of the project you are working on, etc. <span class="anchor" id="line-30"></span></p><span class="anchor" id="line-31"></span><ul><li style="list-style-type:none"><p class="line903"><img alt="&lt;!&gt;" height="15" src="wiki/htdocs/modern/img/attention.png" title="&lt;!&gt;" width="15" /> <strong>Do not use the name "wiki" - it is reserved for internal use. You would need a special setup to use this with CGI, and you can't use it at all with standalone or twisted server.</strong> <span class="anchor" id="line-32"></span></p><span class="anchor" id="line-33"></span></li></ul><p class="line879">The name "<tt class="backtick">mywiki</tt>" is used as an example in the various commands below. <span class="anchor" id="line-34"></span></p><span class="anchor" id="line-35"></span>
+<span class="anchor" id="line-30"></span><span class="anchor" id="line-31"></span><p class="line886">Choose a unique name for the new wiki instance you want to create. It should be a short word, something that reflects what you intend to use the wiki for, like the name of your organization, of your team, of the project you are working on, etc. <span class="anchor" id="line-32"></span></p><span class="anchor" id="line-33"></span><ul><li style="list-style-type:none"><p class="line903"><img alt="&lt;!&gt;" height="15" src="wiki/htdocs/modern/img/attention.png" title="&lt;!&gt;" width="15" /> <strong>Do not use the name "wiki" - it is reserved for internal use. You would need a special setup to use this with CGI, and you can't use it at all with standalone or twisted server.</strong> <span class="anchor" id="line-34"></span></p><span class="anchor" id="line-35"></span></li></ul><p class="line879">The name "<tt class="backtick">mywiki</tt>" is used as an example in the various commands below. <span class="anchor" id="line-36"></span></p><span class="anchor" id="line-37"></span>
 <h1 id="head-379ea73c819b2c729ba9c2432b8a4c4b4c524f71">Choose a location</h1>
-<span class="anchor" id="line-36"></span><span class="anchor" id="line-37"></span><p class="line886">Choose a directory on your disk, it will contain all the files needed for your wiki instance. At the beginning, your wiki instance will use approximately 10 MB of disk space. Then of course, it will grow depending on the way your wiki is used. A personal wiki, even with many pages, might only use 30 MB or 40 MB of disk space. A popular wiki, or a wiki with many files attached to the pages, might use much more, of course. <span class="anchor" id="line-38"></span></p><span class="anchor" id="line-39"></span><p class="line879">If you are the administrator (or root) of the server, you can use anything you like or that makes sense to you, for example <tt class="backtick">/usr/local/var/moin</tt>, <tt class="backtick">/mnt/wikis</tt>, etc. <span class="anchor" id="line-40"></span></p><span class="anchor" id="line-41"></span><p class="line879">If you are a simple user, you will probably only be allowed to write in your personal, "home" directory. Choose a subdirectory that makes sense to you, for example the <tt class="backtick">share/moin</tt> subdirectory. <span class="anchor" id="line-42"></span></p><span class="anchor" id="line-43"></span>
+<span class="anchor" id="line-38"></span><span class="anchor" id="line-39"></span><p class="line886">Choose a directory on your disk, it will contain all the files needed for your wiki instance. At the beginning, your wiki instance will use approximately 10 MB of disk space. Then of course, it will grow depending on the way your wiki is used. A personal wiki, even with many pages, might only use 30 MB or 40 MB of disk space. A popular wiki, or a wiki with many files attached to the pages, might use much more, of course. <span class="anchor" id="line-40"></span></p><span class="anchor" id="line-41"></span><p class="line879">If you are the administrator (or root) of the server, you can use anything you like or that makes sense to you, for example <tt class="backtick">/usr/local/var/moin</tt>, <tt class="backtick">/mnt/wikis</tt>, etc. <span class="anchor" id="line-42"></span></p><span class="anchor" id="line-43"></span><p class="line879">If you are a simple user, you will probably only be allowed to write in your personal, "home" directory. Choose a subdirectory that makes sense to you, for example the <tt class="backtick">share/moin</tt> subdirectory. <span class="anchor" id="line-44"></span></p><span class="anchor" id="line-45"></span>
 <h1 id="head-951584cdd82db21218fc2ffd3945de602f8275c0">Collect some important information</h1>
-<span class="anchor" id="line-44"></span><span class="anchor" id="line-45"></span><p class="line886">This is where the instructions differ according to the web server and operating system you use, and whether you are the administrator or a simple user. See the appropriate pages for your web server and operating system combination. <span class="anchor" id="line-46"></span></p><span class="anchor" id="line-47"></span><p class="line879">On Linux, the <tt class="backtick">export</tt> command will be used to remember the collected information. Windows users should write it down carefully (maybe cutting-and-pasting in a Notepad window), or store it in environment variables if they use the command prompt. <span class="anchor" id="line-48"></span></p><span class="anchor" id="line-49"></span><ul><li><p class="line903"><tt class="backtick">PREFIX</tt> is the prefix you used during the <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> <span class="anchor" id="line-50"></span></p></li><li><p class="line903"><tt class="backtick">SHARE</tt> is the name of the <tt class="backtick">share</tt> directory, as discussed at the bottom of <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> <span class="anchor" id="line-51"></span></p></li><li><p class="line903"><tt class="backtick">WIKILOCATION</tt> is the name of the directory that will contain your wiki instance <span class="anchor" id="line-52"></span></p><span class="anchor" id="line-53"></span></li></ul><p class="line886">If you are an administrator, you also need to collect the following: <span class="anchor" id="line-54"></span></p><span class="anchor" id="line-55"></span><ul><li><p class="line903"><tt class="backtick">USER</tt> is the user name of the web server <span class="anchor" id="line-56"></span></p></li><li><p class="line903"><tt class="backtick">GROUP</tt> is the name of the group to which the web server belongs <span class="anchor" id="line-57"></span></p><span class="anchor" id="line-58"></span></li></ul><p class="line886">Now, Linux folks, let's store these settings in memory: <span class="anchor" id="line-59"></span><span class="anchor" id="line-60"></span></p><pre>&gt; export PREFIX=/usr                # this might be something else
-<span class="anchor" id="line-61"></span>&gt; export SHARE=$PREFIX/share/moin   # this should be correct for most people
-<span class="anchor" id="line-62"></span>&gt; export WIKILOCATION=$SHARE        # this is just an example
-<span class="anchor" id="line-63"></span>&gt; export INSTANCE=mywiki            # this is just an example
-<span class="anchor" id="line-64"></span></pre><span class="anchor" id="line-65"></span><span class="anchor" id="line-66"></span><p class="line886">Administrators also need the following two lines: <span class="anchor" id="line-67"></span></p><span class="anchor" id="line-68"></span><span class="anchor" id="line-69"></span><pre>&gt; export USER=www-data              # this is just an example
-<span class="anchor" id="line-70"></span>&gt; export GROUP=www-data             # this is just an example
-<span class="anchor" id="line-71"></span></pre><span class="anchor" id="line-72"></span><span class="anchor" id="line-73"></span>
+<span class="anchor" id="line-46"></span><span class="anchor" id="line-47"></span><p class="line886">This is where the instructions differ according to the web server and operating system you use, and whether you are the administrator or a simple user. See the appropriate pages for your web server and operating system combination. <span class="anchor" id="line-48"></span></p><span class="anchor" id="line-49"></span><p class="line879">On Linux, the <tt class="backtick">export</tt> command will be used to remember the collected information. Windows users should write it down carefully (maybe cutting-and-pasting in a Notepad window), or store it in environment variables if they use the command prompt. <span class="anchor" id="line-50"></span></p><span class="anchor" id="line-51"></span><ul><li><p class="line903"><tt class="backtick">PREFIX</tt> is the prefix you used during the <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> <span class="anchor" id="line-52"></span></p></li><li><p class="line903"><tt class="backtick">SHARE</tt> is the name of the <tt class="backtick">share</tt> directory, as discussed at the bottom of <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> <span class="anchor" id="line-53"></span></p></li><li><p class="line903"><tt class="backtick">WIKILOCATION</tt> is the name of the directory that will contain your wiki instance <span class="anchor" id="line-54"></span></p><span class="anchor" id="line-55"></span></li></ul><p class="line886">If you are an administrator, you also need to collect the following: <span class="anchor" id="line-56"></span></p><span class="anchor" id="line-57"></span><ul><li><p class="line903"><tt class="backtick">USER</tt> is the user name of the web server <span class="anchor" id="line-58"></span></p></li><li><p class="line903"><tt class="backtick">GROUP</tt> is the name of the group to which the web server belongs <span class="anchor" id="line-59"></span></p><span class="anchor" id="line-60"></span></li></ul><p class="line886">Now, Linux folks, let's store these settings in memory: <span class="anchor" id="line-61"></span><span class="anchor" id="line-62"></span></p><pre>&gt; export PREFIX=/usr                # this might be something else
+<span class="anchor" id="line-63"></span>&gt; export SHARE=$PREFIX/share/moin   # this should be correct for most people
+<span class="anchor" id="line-64"></span>&gt; export WIKILOCATION=$SHARE        # this is just an example
+<span class="anchor" id="line-65"></span>&gt; export INSTANCE=mywiki            # this is just an example
+<span class="anchor" id="line-66"></span></pre><span class="anchor" id="line-67"></span><span class="anchor" id="line-68"></span><p class="line886">Administrators also need the following two lines: <span class="anchor" id="line-69"></span></p><span class="anchor" id="line-70"></span><span class="anchor" id="line-71"></span><pre>&gt; export USER=www-data              # this is just an example
+<span class="anchor" id="line-72"></span>&gt; export GROUP=www-data             # this is just an example
+<span class="anchor" id="line-73"></span></pre><span class="anchor" id="line-74"></span><span class="anchor" id="line-75"></span>
 <h1 id="head-c3fc33e072973371ea739841440fb52175ddb9f6">Copy the files</h1>
-<span class="anchor" id="line-74"></span><span class="anchor" id="line-75"></span><p class="line879">To create your new instance, you first need to create a directory named like your instance, inside the <tt class="backtick">WIKILOCATION</tt>. Then you need to copy the <tt class="backtick">data</tt> and <tt class="backtick">underlay</tt> directories from your <tt class="backtick">SHARE</tt> directory into your instance directory. Finally, you need to copy the <tt class="backtick">wikiconfig.py</tt> file from the <tt class="backtick">config</tt> directory into the instance directory. <span class="anchor" id="line-76"></span></p><span class="anchor" id="line-77"></span><p class="line886">Linux folks need just type these commands: <span class="anchor" id="line-78"></span><span class="anchor" id="line-79"></span></p><pre>&gt; cd $WIKILOCATION
-<span class="anchor" id="line-80"></span>&gt; mkdir $INSTANCE                   # make a directory for this instance
-<span class="anchor" id="line-81"></span>&gt; cp -R $SHARE/data $INSTANCE       # copy template data directory
-<span class="anchor" id="line-82"></span>&gt; cp -R $SHARE/underlay $INSTANCE   # copy underlay data directory
-<span class="anchor" id="line-83"></span>&gt; cp $SHARE/config/wikiconfig.py $INSTANCE   # copy wiki configuration sample file
-<span class="anchor" id="line-84"></span></pre><span class="anchor" id="line-85"></span><span class="anchor" id="line-86"></span><ul><li style="list-style-type:none"><p class="line903"><img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> Note that you just need to keep one underlay directory on your system if you are running multiple wikis (e.g. in a farm.) <span class="anchor" id="line-87"></span></p><span class="anchor" id="line-88"></span></li></ul>
+<span class="anchor" id="line-76"></span><span class="anchor" id="line-77"></span><p class="line879">To create your new instance, you first need to create a directory named like your instance, inside the <tt class="backtick">WIKILOCATION</tt>. Then you need to copy the <tt class="backtick">data</tt> and <tt class="backtick">underlay</tt> directories from your <tt class="backtick">SHARE</tt> directory into your instance directory. Finally, you need to copy the <tt class="backtick">wikiconfig.py</tt> file from the <tt class="backtick">config</tt> directory into the instance directory. <span class="anchor" id="line-78"></span></p><span class="anchor" id="line-79"></span><p class="line886">Linux folks need just type these commands: <span class="anchor" id="line-80"></span><span class="anchor" id="line-81"></span></p><pre>&gt; cd $WIKILOCATION
+<span class="anchor" id="line-82"></span>&gt; mkdir $INSTANCE                   # make a directory for this instance
+<span class="anchor" id="line-83"></span>&gt; cp -R $SHARE/data $INSTANCE       # copy template data directory
+<span class="anchor" id="line-84"></span>&gt; cp -R $SHARE/underlay $INSTANCE   # copy underlay data directory
+<span class="anchor" id="line-85"></span>&gt; cp $SHARE/config/wikiconfig.py $INSTANCE   # copy wiki configuration sample file
+<span class="anchor" id="line-86"></span></pre><span class="anchor" id="line-87"></span><span class="anchor" id="line-88"></span><ul><li style="list-style-type:none"><p class="line903"><img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> Note that you just need to keep one underlay directory on your system if you are running multiple wikis (e.g. in a farm.) <span class="anchor" id="line-89"></span></p><span class="anchor" id="line-90"></span></li></ul>
 <h1 id="head-027e3666aea4dc02569ad386901ae9456bad5ae1">Set permissions</h1>
-<span class="anchor" id="line-89"></span><span class="anchor" id="line-90"></span>
+<span class="anchor" id="line-91"></span><span class="anchor" id="line-92"></span>
 <h2 id="head-3b8b040007c209e4621b176c8724b3bbcb755957">Administrators</h2>
-<span class="anchor" id="line-91"></span><span class="anchor" id="line-92"></span><p class="line886">Administrators need to restrict the permissions of the files, so that only the web server (and the administrator of course) can read and write them. For maximum security, no other user on the machine should be able to read or write anything in the wiki instance directory. Don't forget that this directory contains sensitive information, notably the (encrypted) passwords of the wiki users. <span class="anchor" id="line-93"></span></p><span class="anchor" id="line-94"></span><p class="line886">On Linux, the following commands should be enough: <span class="anchor" id="line-95"></span><span class="anchor" id="line-96"></span></p><pre>&gt; chown -R $USER.$GROUP $INSTANCE   # check that USER and GROUP are correct
-<span class="anchor" id="line-97"></span>&gt; chmod -R ug+rwX $INSTANCE         # USER.GROUP may read and write
-<span class="anchor" id="line-98"></span>&gt; chmod -R o-rwx $INSTANCE          # everybody else is rejected
-<span class="anchor" id="line-99"></span></pre><span class="anchor" id="line-100"></span><span class="anchor" id="line-101"></span>
+<span class="anchor" id="line-93"></span><span class="anchor" id="line-94"></span><p class="line886">Administrators need to restrict the permissions of the files, so that only the web server (and the administrator of course) can read and write them. For maximum security, no other user on the machine should be able to read or write anything in the wiki instance directory. Don't forget that this directory contains sensitive information, notably the (encrypted) passwords of the wiki users. <span class="anchor" id="line-95"></span></p><span class="anchor" id="line-96"></span><p class="line886">On Linux, the following commands should be enough: <span class="anchor" id="line-97"></span><span class="anchor" id="line-98"></span></p><pre>&gt; chown -R $USER.$GROUP $INSTANCE   # check that USER and GROUP are correct
+<span class="anchor" id="line-99"></span>&gt; chmod -R ug+rwX $INSTANCE         # USER.GROUP may read and write
+<span class="anchor" id="line-100"></span>&gt; chmod -R o-rwx $INSTANCE          # everybody else is rejected
+<span class="anchor" id="line-101"></span></pre><span class="anchor" id="line-102"></span><span class="anchor" id="line-103"></span>
 <h2 id="head-19c5987edf26a8517fbf6cbee5ba5dd5f36ec280">Normal users</h2>
-<span class="anchor" id="line-102"></span><span class="anchor" id="line-103"></span><p class="line879">Normal users, on the contrary, need to broaden the permissions of the files, so that the web server can read and write them. On recent Windows versions, and on some versions of Unix, Linux and other systems, <em>access control lists</em> can be used to that effect. They are, however, powerful and complicated, much beyond the scope of this document. Ask a knowledgeable person about them. <span class="anchor" id="line-104"></span></p><span class="anchor" id="line-105"></span><p class="line879">Without them, normal users have to allow <em>everybody</em> to access the instance directory. This is the only way the web server can enter it and do its work. This is, of course, <strong>VERY INSECURE</strong>, since any other user and program on the server can read the directory. You should <strong>not</strong> use such a setup for a wiki open to the public. <span class="anchor" id="line-106"></span></p><span class="anchor" id="line-107"></span><p class="line886">On Linux, the following commands will open the instance directory to the whole world: <span class="anchor" id="line-108"></span><span class="anchor" id="line-109"></span></p><pre>&gt; chmod -R a+rwX $INSTANCE
-<span class="anchor" id="line-110"></span></pre><span class="anchor" id="line-111"></span><span class="anchor" id="line-112"></span><p class="line903"><strong>Note:</strong> <span class="anchor" id="line-113"></span></p><ul><li><p class="line879">it is also possible to put the web server and the normal user in the same <em>group</em>, and then only open the instance directory to the members of that group. This is a bit more secure (depending on who else is in the group), but you need the cooperation of the server administrator; he is the one setting up groups. <span class="anchor" id="line-114"></span></p></li><li><p class="line879">the best other possibility is that the server administrator sets up <tt class="backtick">suexec</tt> to execute CGI scripts in user directories under the user id of that user. You don't need to give world permissions that way, so it is a quite secure setup, but you also need cooperation of the administrator. <span class="anchor" id="line-115"></span></p><span class="anchor" id="line-116"></span><span class="anchor" id="line-117"></span></li></ul>
+<span class="anchor" id="line-104"></span><span class="anchor" id="line-105"></span><p class="line879">Normal users, on the contrary, need to broaden the permissions of the files, so that the web server can read and write them. On recent Windows versions, and on some versions of Unix, Linux and other systems, <em>access control lists</em> can be used to that effect. They are, however, powerful and complicated, much beyond the scope of this document. Ask a knowledgeable person about them. <span class="anchor" id="line-106"></span></p><span class="anchor" id="line-107"></span><p class="line879">Without them, normal users have to allow <em>everybody</em> to access the instance directory. This is the only way the web server can enter it and do its work. This is, of course, <strong>VERY INSECURE</strong>, since any other user and program on the server can read the directory. You should <strong>not</strong> use such a setup for a wiki open to the public. <span class="anchor" id="line-108"></span></p><span class="anchor" id="line-109"></span><p class="line886">On Linux, the following commands will open the instance directory to the whole world: <span class="anchor" id="line-110"></span><span class="anchor" id="line-111"></span></p><pre>&gt; chmod -R a+rwX $INSTANCE
+<span class="anchor" id="line-112"></span></pre><span class="anchor" id="line-113"></span><span class="anchor" id="line-114"></span><p class="line903"><strong>Note:</strong> <span class="anchor" id="line-115"></span></p><ul><li><p class="line879">it is also possible to put the web server and the normal user in the same <em>group</em>, and then only open the instance directory to the members of that group. This is a bit more secure (depending on who else is in the group), but you need the cooperation of the server administrator; he is the one setting up groups. <span class="anchor" id="line-116"></span></p></li><li><p class="line879">the best other possibility is that the server administrator sets up <tt class="backtick">suexec</tt> to execute CGI scripts in user directories under the user id of that user. You don't need to give world permissions that way, so it is a quite secure setup, but you also need cooperation of the administrator. <span class="anchor" id="line-117"></span></p><span class="anchor" id="line-118"></span><span class="anchor" id="line-119"></span></li></ul>
 <h1 id="head-442871161f523855f2162b426248f0bb0523c289">Tune configuration</h1>
-<span class="anchor" id="line-118"></span><span class="anchor" id="line-119"></span><p class="line886">Now, you need to tune the configuration of your web server and of your wiki instance. Look at the appropriate help page for your web server, then come back here to tune the settings of your wiki instance. <span class="anchor" id="line-120"></span></p><span class="anchor" id="line-121"></span><p class="line879">Edit <tt class="backtick">wikiconfig.py</tt>. The default settings should work fine in most cases, but there are some things that you will probably want to change, like the name and logo of your wiki! <img alt=":)" height="15" src="wiki/htdocs/modern/img/smile.png" title=":)" width="15" /> Read the comments inside <tt class="backtick">wikiconfig.py</tt>, they will guide you through this process.  (Start with "Wiki identity", around line 25.) <span class="anchor" id="line-122"></span></p><span class="anchor" id="line-123"></span><p class="line903"><a href="http://moinmaster.wikiwikiweb.de/HelpOnConfiguration">HelpOnConfiguration</a> contains all the details about all the options, in case the comments in <tt class="backtick">wikiconfig.py</tt> are not enough. <span class="anchor" id="line-124"></span></p><span class="anchor" id="bottom_Include_HelpOnInstalling/WikiInstanceCreation"></span></div> <span class="anchor" id="line-51"></span></p><hr class="hr1" /><p class="line886"> <span class="anchor" id="line-52"></span><span class="anchor" id="linuxapache-install"></span> <span class="anchor" id="line-53"></span>
+<span class="anchor" id="line-120"></span><span class="anchor" id="line-121"></span><p class="line886">Now, you need to tune the configuration of your web server and of your wiki instance. Look at the appropriate help page for your web server, then come back here to tune the settings of your wiki instance. <span class="anchor" id="line-122"></span></p><span class="anchor" id="line-123"></span><p class="line879">Edit <tt class="backtick">wikiconfig.py</tt>. The default settings should work fine in most cases, but there are some things that you will probably want to change, like the name and logo of your wiki! <img alt=":)" height="15" src="wiki/htdocs/modern/img/smile.png" title=":)" width="15" /> Read the comments inside <tt class="backtick">wikiconfig.py</tt>, they will guide you through this process.  (Start with "Wiki identity", around line 25.) <span class="anchor" id="line-124"></span></p><span class="anchor" id="line-125"></span><div><table><tbody><tr>  <td><p class="line879"> <img alt="/!\" height="15" src="wiki/htdocs/modern/img/alert.png" title="/!\" width="15" /> <strong>Warning: don't forget to restart your web server in order to apply changes in <tt class="backtick">wikiconfig.py</tt></strong> </p></td>
+</tr>
+<span class="anchor" id="line-126"></span></tbody></table></div><span class="anchor" id="line-127"></span><p class="line903"><a href="http://moinmaster.wikiwikiweb.de/HelpOnConfiguration">HelpOnConfiguration</a> contains all the details about all the options, in case the comments in <tt class="backtick">wikiconfig.py</tt> are not enough. <span class="anchor" id="line-128"></span></p><span class="anchor" id="bottom_Include_HelpOnInstalling/WikiInstanceCreation"></span></div> <span class="anchor" id="line-51"></span></p><hr class="hr1" /><p class="line886"> <span class="anchor" id="line-52"></span><span class="anchor" id="linuxapache-install"></span> <span class="anchor" id="line-53"></span>
 <h1>Linux Installation using Apache</h1>
 <div dir="ltr" id="Include_HelpOnInstalling/ApacheOnLinux" lang="en"><span class="anchor" id="top_Include_HelpOnInstalling/ApacheOnLinux"></span>
 <span class="anchor" id="line-9"></span><p class="line879">This page describes the particular steps that need to be taken to create a wiki instance using <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> on Linux with the Apache web server. <strong>You should have already performed the <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a>. </strong>Installations on other Unices like FreeBSD are very similar. <span class="anchor" id="line-10"></span></p><span class="anchor" id="line-11"></span><p class="line886">Two scenarios are possible. You might be the administrator (root) of the server, able to install and modify files almost anywhere on the machine, and notably able to modifiy the Apache configuration. You might also be a simple user, only able to write files into your home directory, and unable to alter the master Apache config file. The two scenarios are discussed below. <span class="anchor" id="line-12"></span></p><span class="anchor" id="line-13"></span><p class="line903"><strong>Table of contents</strong> <ol><li><a href="#head-5a61f5b0107edba120089e4251cd633be60b6e15">Administrator (root)</a><ol><li><a href="#head-c27688fbe7f65d67190a47ce8d32eba244ab0d01">Create a wiki instance</a></li><li><a href="#head-e3e9e08058bb0ae34c33f53367cd58d6c7411998">Install moin.cgi</a></li><li><a href="#head-408a7a283b2406c4e6b24646b25ec7996d5ff459">Configure moin.cgi</a></li><li><a href="#head-b02e2f66403a66cc3b1ff0ce2c7261cf44e4f0d4">Configure Apache</a></li><li><a href="#head-ffa39b171f9d130bb07a8481a5fff1a5a9065e86">Configure MoinMoin</a></li><li><a href="#head-0f7a0fb8dccf6a13b6042fa17e0d7cda751fe3f3">Test the wiki</a></li><li><a href="#head-52920da3312438e6a484347d4dfaa369b86cb521">Apache tricks</a></li></ol><li><a href="#head-e559f024646d8751eee1135ad5423247d72ab7fd">Simple user (home directory installation)</a><ol><li><a href="#head-6a39e2829f37fd34c569c2ffa768c9b3ec2289cc">Make sure /~username works</a></li><li><a href="#head-c27688fbe7f65d67190a47ce8d32eba244ab0d01-2">Create a wiki instance</a></li><li><a href="#head-ec9ce458a3f08281e5906f6d1e2e5cc008d620db">Install the htdocs files</a></li><li><a href="#head-e3e9e08058bb0ae34c33f53367cd58d6c7411998-2">Install moin.cgi</a></li><li><a href="#head-408a7a283b2406c4e6b24646b25ec7996d5ff459-2">Configure moin.cgi</a></li><li><a href="#head-ffa39b171f9d130bb07a8481a5fff1a5a9065e86-2">Configure MoinMoin</a></li><li><a href="#head-0f7a0fb8dccf6a13b6042fa17e0d7cda751fe3f3-2">Test the wiki</a></li></ol><li><a href="#head-3f286acb05ce4ad64240f788c78a8f915f59e34e">Troubleshooting</a><ol><li><a href="#head-b8c0d1c1aba9cd39d0d15f86ea33025f7f25d48d">Adding permission to serve the htdocs directory</a></li></ol></li></ol> <span class="anchor" id="line-14"></span></p><span class="anchor" id="line-15"></span>
@@ -518,7 +525,7 @@
 <div dir="ltr" id="Include_HelpOnInstalling/ApacheOnWin32" lang="en"><span class="anchor" id="top_Include_HelpOnInstalling/ApacheOnWin32"></span>
 <span class="anchor" id="line-8"></span><p class="line903"><strong>Index</strong> <span class="anchor" id="line-9"></span><ol><li><a href="#head-3c727e631e2668b26b0f23f76dfaca64e810648e">Requirements</a></li><li><a href="#head-18c7f9f6c7f20cad8a2598f80aba6a6b36bae585">Preparation</a><ol><li><a href="#head-ce3f1899eb42247cc89c79893ca80eb5da56d2d4">MSI Installer</a></li><li><a href="#head-b1287e95efcad1b36cc2c15f825e1de198ebfcf6">Installing Apache</a></li><li><a href="#head-55b68c00864e2a0be48f87115a45f6a17a76bcc0">Installing Python</a></li></ol><li><a href="#head-c76f9a659995f587c02878baf3877ab5bd08a5bd">Installing MoinMoin</a></li><li><a href="#head-ba9ed0d8dd27b7bc62472aa0d24e8102dd103deb">Creating a Wiki Instance</a></li><li><a href="#head-42c812a9d38d3af1de6c09ed952ac1858c5221b8">Integrating MoinMoin into Apache</a></li><li><a href="#head-82ba5417401e5b5cb78836b4f23ef160fbc80630">Troubleshooting</a><ol><li><a href="#head-01d84d7e6494dcee0bd2abfbb04f43f812c9bdd7">Internal Server Error</a></li><li><a href="#head-7a4c0881ccb7242b9857811b27dc07ad836889d0">Not Found</a></li><li><a href="#head-d9b4f0491158f7280b4bf1693d990336527ebf4d">The Page Cannot be found</a></li><li><a href="#head-d47936fa3c21c07d857b27fdb811e5836635a100">FrontPage Loads Without Icons</a></li></ol></li></ol> <span class="anchor" id="line-10"></span></p><span class="anchor" id="line-11"></span>
 <h2 id="head-3c727e631e2668b26b0f23f76dfaca64e810648e">Requirements</h2>
-<span class="anchor" id="line-12"></span><span class="anchor" id="line-13"></span><p class="line879">Before you install Moin<tt class="backtick"></tt>Moin, you must have the necessary infrastructure in place. This procedure explains the steps necessary to install the infrastructure and provides detailed instructions for the installation of Moin<tt class="backtick"></tt>Moin.  <span class="anchor" id="line-14"></span></p><span class="anchor" id="line-15"></span><p class="line886">Downloading and installing all of the required components will require almost 100 MB of disk space - shouldn't be a problem nowadays, right? <span class="anchor" id="line-16"></span></p><span class="anchor" id="line-17"></span><p class="line879">Many users prefer to install software products in a folder other than the installation default. Python typically changes the default installation folder name with each point release, and Apache has changed the default installation folder name with the release of version 2.  Instead of enumerating all the possibilities at each step, this procedure will use the <strong>Reference</strong> name in the table below as the installed location for each product. Substitute your real installation location when editing configuration files and entering commands. <span class="anchor" id="line-18"></span></p><span class="anchor" id="line-19"></span><div><table><tbody><tr style="background-color: #EEDDAA;">  <td><p class="line879">Reference</p></td>
+<span class="anchor" id="line-12"></span><span class="anchor" id="line-13"></span><p class="line879">Before you install Moin<tt class="backtick"></tt>Moin, you must have the necessary infrastructure in place. This procedure explains the steps necessary to install the infrastructure and provides detailed instructions for the installation of Moin<tt class="backtick"></tt>Moin.  <span class="anchor" id="line-14"></span></p><span class="anchor" id="line-15"></span><p class="line886">Downloading and installing all of the required components will require almost 100 MB of disk space - shouldn't be a problem nowadays, right? <span class="anchor" id="line-16"></span></p><span class="anchor" id="line-17"></span><p class="line879">Many users prefer to install software products in a folder other than the installation default. Python typically changes the default installation folder name with each point release, and Apache has changed the default installation folder name with the release of version 2.  Instead of enumerating all the possibilities at each step, this procedure will use the <strong>Reference</strong> name in the table below as the installed location for each product. Substitute your real installation location when editing configuration files and entering commands. <span class="anchor" id="line-18"></span></p><span class="anchor" id="line-19"></span><div><table><tbody><tr>  <td><p class="line879">Reference</p></td>
   <td><p class="line879">Product</p></td>
   <td><p class="line879">Installation Default or Typical Name</p></td>
 </tr>
@@ -724,17 +731,17 @@
 <span class="line"><span class="LineNumber">   3 </span><span class="ID">sys</span><span class="Operator">.</span><span class="ID">path</span><span class="Operator">.</span><span class="ID">append</span><span class="Operator">(</span><span class="String">'C:/Moin/Lib/site-packages'</span><span class="Operator">)</span><span class="Text"></span></span>
 </pre></div><span class="anchor" id="line-87"></span><p class="line879">Notice that we're pointing to the directory which contains the Moin<tt class="backtick"></tt>Moin directory, not the directory itself. <span class="anchor" id="line-88"></span></p><span class="anchor" id="line-89"></span><p class="line886">Next, you'll need to create two virtual directories in IIS. One for the shared data, and one for this specific wiki instance.  <span class="anchor" id="line-90"></span></p><span class="anchor" id="line-91"></span><p class="line879">Go to <em>Control Panel =&gt; Administrative Tools =&gt; Internet Information Service</em>. Open up the tree to <em>Default Web Site</em>.  <span class="anchor" id="line-92"></span></p><span class="anchor" id="line-93"></span><p class="line879">Right click on <em>Default Web Site</em> and choose <em>New =&gt; Virtual directory</em>. This will bring up a wizard with the mandatory useless first screen, hit next. Enter "<tt class="backtick">wiki</tt>" for the alias name and hit next. Browse to "<tt class="backtick">C:\Moin\share\moin\htdocs</tt>" and hit next. Leave the <em>Access permissions</em> at their defaults and hit next. And now you're done, hit finish! <span class="anchor" id="line-94"></span></p><span class="anchor" id="line-95"></span><p class="line879">Now follow the same steps, but set the alias to "<tt class="backtick">mywiki</tt>" and the path to "<tt class="backtick">C:\Moin\mywiki</tt>".  <span class="anchor" id="line-96"></span></p><span class="anchor" id="line-97"></span><p class="line879">Use IIS Admin to remove permissions to read the data directory: expand the "<tt class="backtick">mywiki</tt>" node, right click on <tt class="backtick">data</tt>, select <tt class="backtick">Properties</tt>, and uncheck <tt class="backtick">Read</tt>. Repeat these steps with the <tt class="backtick">underlay</tt> directory. <span class="anchor" id="line-98"></span></p><span class="anchor" id="line-99"></span><p class="line879">Now you need to setup the 'mywiki' alias so that it will run Python to interpret <tt class="backtick">.cgi</tt> files. On Windows Server 2003, you will need to click the <em>Create</em> button under <em>Application Settings</em> to create an application space. Right click on your new 'mywiki' alias and choose <em>Properties</em>. On the first tab (<em>Virtual Directory</em>), click the <em>Configuration</em> button. The first tab is the <em>App Mappings</em> tab, which defines which programs to use for each file exetension. Click <em>Add</em>. Browse to your <tt class="backtick">python.exe</tt> (probably something like <tt class="backtick">c:\pythonXX\python.exe</tt>). Then add <tt>-u&nbsp;"%s"&nbsp;"%s"</tt> after the Python executable path. The <em>Executable</em> line will look something like this: <tt>"C:\Python22\python.exe"&nbsp;-u&nbsp;"%s"&nbsp;"%s"</tt>. In the <em>Extension</em> box enter <tt>.cgi</tt> with the begining period. Make sure that the <em>Check that file exists</em> option is not checked (if it is, Moin<tt class="backtick"></tt>Moin won't be able to display sub pages). Ok, you're done with the alias configuration, click <em>OK</em> several times to get back out of all the dialog boxes. <span class="anchor" id="line-100"></span></p><span class="anchor" id="line-101"></span><p class="line879">If you add another wiki instance, you'll only need to setup the reference to its folder, they can safely share the "<tt class="backtick">wiki</tt>" alias which points to static files only. <span class="anchor" id="line-102"></span></p><span class="anchor" id="line-103"></span><p class="line879">That is all, try to access your new-born wiki with the URL "<tt class="backtick">http://127.0.0.1/mywiki/</tt>". You should see the Front<tt class="backtick"></tt>Page, try to edit and save it, and if that works, see if your edit is reflected on the Recent<tt class="backtick"></tt>Changes page. <span class="anchor" id="line-104"></span></p><span class="anchor" id="line-105"></span><p class="line879">Finally, edit "<tt class="backtick">wikiconfig.py</tt>" and at least change "<tt class="backtick">sitename</tt>" and "<tt class="backtick">logo_string</tt>" to some personal values: <span class="anchor" id="line-106"></span><span class="anchor" id="line-107"></span></p><pre>sitename = u'My Wiki'
 <span class="anchor" id="line-108"></span>logo_string = u'&lt;img src="/mywiki/images/mywiki-logo.gif" alt="MyWiki Logo"&gt;My Wiki'
-<span class="anchor" id="line-109"></span></pre><span class="anchor" id="line-110"></span><p class="line879">Where "<tt class="backtick">images</tt>" is a directory under your "<tt class="backtick">mywiki</tt>" instance. <span class="anchor" id="line-111"></span></p><span class="anchor" id="line-112"></span><p class="line879">NOTE: The configuration variable "<tt class="backtick">url_prefix</tt>" in "<tt class="backtick">wikiconfig.py</tt>" should match the alias for "<tt class="backtick">C:\Moin\share\moin\htdocs</tt>" or themes will not work ("<tt class="backtick">/wiki</tt>" for the instructions above).  This way, any reference in "<tt class="backtick">wikiconfig.py</tt>" to "<tt class="backtick">/wiki/something</tt>" will look in the shared data directory and a reference to "<tt class="backtick">/mywiki/something</tt>" will look in the wiki instance directory.  These are considered absolute paths because relative paths will not work correctly. <span class="anchor" id="line-113"></span></p><span class="anchor" id="line-114"></span><p class="line903"><strong>Since <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> 1.3.5</strong>, it seems you need to change the Custom Errors setting for 404 before you can create new pages. You can accomplish this by performing the following steps: <span class="anchor" id="line-115"></span></p><span class="anchor" id="line-116"></span><ol type="1"><li><p class="line886">Go into the IIS Manager, right-click on 'mywiki' (or whatever your wiki instance directory is called), and select properties. <span class="anchor" id="line-117"></span></p><span class="anchor" id="line-118"></span></li><li class="gap"><p class="line886">Next, go to the Custom Errors tab and find the 404 entry, and click the Edit button. <span class="anchor" id="line-119"></span></p><span class="anchor" id="line-120"></span></li><li class="gap"><p class="line886">Set "Message type" to "Default" and click click click until you're out of all the dialogs. <span class="anchor" id="line-121"></span></p><span class="anchor" id="line-122"></span></li></ol>
+<span class="anchor" id="line-109"></span></pre><span class="anchor" id="line-110"></span><p class="line879">Where "<tt class="backtick">images</tt>" is a directory under your "<tt class="backtick">mywiki</tt>" instance. <span class="anchor" id="line-111"></span></p><span class="anchor" id="line-112"></span><p class="line879">NOTE: The configuration variable "<tt class="backtick">url_prefix</tt>" in "<tt class="backtick">wikiconfig.py</tt>" should match the alias for "<tt class="backtick">C:\Moin\share\moin\htdocs</tt>" or themes will not work ("<tt class="backtick">/wiki</tt>" for the instructions above).  This way, any reference in "<tt class="backtick">wikiconfig.py</tt>" to "<tt class="backtick">/wiki/something</tt>" will look in the shared data directory and a reference to "<tt class="backtick">/mywiki/something</tt>" will look in the wiki instance directory.  These are considered absolute paths because relative paths will not work correctly. <span class="anchor" id="line-113"></span></p><span class="anchor" id="line-114"></span><p class="line903"><strong>Since <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> 1.3.5</strong>, it seems you need to change the Custom Errors setting for 404 before you can create new pages. You can accomplish this by performing the following steps: <span class="anchor" id="line-115"></span></p><span class="anchor" id="line-116"></span><ol type="1"><li><p class="line886">Go into the IIS Manager, right-click on 'mywiki' (or whatever your wiki instance directory is called), and select properties. <span class="anchor" id="line-117"></span></p><span class="anchor" id="line-118"></span></li><li class="gap"><p class="line879">Next, go to the Custom Errors tab and find the 404 entry, and click the <em>Set to Default</em> button. <span class="anchor" id="line-119"></span></p><span class="anchor" id="line-120"></span><span class="anchor" id="line-121"></span></li></ol>
 <h3 id="head-890abdbd0d21bf874ce794be87067abf433a51d7">IIS 6.0 (Windows Server 2003)</h3>
-<span class="anchor" id="line-123"></span><span class="anchor" id="line-124"></span><p class="line879">The instructions below also apply to IIS 6.0 but the more aggressive security settings in newer version of IIS disallow the usage of <em>unknown CGI extensions</em>.  That means you will always get a 404 error unless you do this: <span class="anchor" id="line-125"></span></p><span class="anchor" id="line-126"></span><ol type="1"><li><p class="line879">Open IIS Manager by going to Start Menu-&gt;Programs-&gt;Administrative Tools-&gt;IIS Manager. <span class="anchor" id="line-127"></span></p><span class="anchor" id="line-128"></span></li><li class="gap"><p class="line879">Go to the <strong>Web Service Extensions</strong> folder. <span class="anchor" id="line-129"></span></p><span class="anchor" id="line-130"></span></li><li class="gap"><p class="line879">Under the <strong>Action</strong> menu, select <strong>Add a new Web service extension...</strong>. <span class="anchor" id="line-131"></span></p><span class="anchor" id="line-132"></span></li><li class="gap"><p class="line879">For Extension name, give it a name such as <em>.cgi</em> or <em>Python cgi</em> or something. <span class="anchor" id="line-133"></span></p><span class="anchor" id="line-134"></span></li><li class="gap"><p class="line879">Under <strong>Required files</strong> click the <strong>Add...</strong> button and type in the exact command-line string you used above. Eg: <em>c:\python24\python.exe -u "%s" "%s"</em>, then click the <strong>Ok</strong> button. <span class="anchor" id="line-135"></span></p><span class="anchor" id="line-136"></span></li><li class="gap"><p class="line879">Make sure the <strong>Set extension status to Allowed</strong> checkbox is checked and click the <strong>Ok</strong> button. <span class="anchor" id="line-137"></span></p><span class="anchor" id="line-138"></span></li></ol><p class="line886">Another change that may be necessary if you are receiving HTTP Error 403 19 1314 while using IIS 6.0 is to adjust the Identity settings for the Application Pool that is being used by your site.  The following steps assume you are adjusting the Default Web Site. <span class="anchor" id="line-139"></span></p><span class="anchor" id="line-140"></span><ol type="1"><li><p class="line879">Open IIS Manager by going to Start Menu-&gt;Programs-&gt;Administrative Tools-&gt;IIS Manager. <span class="anchor" id="line-141"></span></p><span class="anchor" id="line-142"></span></li><li class="gap"><p class="line879">Go to the <strong>Application Pool</strong> folder. <span class="anchor" id="line-143"></span></p><span class="anchor" id="line-144"></span></li><li class="gap"><p class="line879">Select the Application Pool you wish to adjust. (likely <strong>Default<tt class="backtick"></tt>App<tt class="backtick"></tt>Pool</strong> ) When you do this on the right you will see the Application pools for each site on the server.  This will include a Description (likely <strong>Default Application</strong> )and a Path (<strong>&lt;Default Web Site&gt;</strong>).  In this way you can be certain you are adjusting the appropriate Application Pool. <span class="anchor" id="line-145"></span></p><span class="anchor" id="line-146"></span></li><li class="gap"><p class="line879">With <strong>Default<tt class="backtick"></tt>App<tt class="backtick"></tt>Pool</strong> still selected right click and select <strong>Properties</strong>. <span class="anchor" id="line-147"></span></p><span class="anchor" id="line-148"></span></li><li class="gap"><p class="line879">Select the <strong>Identity</strong> tab and with <strong>Predefined</strong> clicked use the drop down box to change the <strong>Identity</strong> to <strong>Local System</strong> instead of Network Service. <span class="anchor" id="line-149"></span></p><span class="anchor" id="line-150"></span><p class="line903"><em>Please be aware that this is a workaround since you SHOULD set your group settings to allow Network Service to access the cgi scripts.</em> <span class="anchor" id="line-151"></span></p><span class="anchor" id="line-152"></span></li></ol><p class="line886">Under Windows Server 2003, you will also need to give your IUSR_MACHINENAME account Modify access to the mywiki\data and mywiki\underlay sub-directories, as file system permissions are more restricted by default than previous Windows versions. <span class="anchor" id="line-153"></span></p><span class="anchor" id="line-154"></span>
+<span class="anchor" id="line-122"></span><span class="anchor" id="line-123"></span><p class="line879">The instructions below also apply to IIS 6.0 but the more aggressive security settings in newer version of IIS disallow the usage of <em>unknown CGI extensions</em>.  That means you will always get a 404 error unless you do this: <span class="anchor" id="line-124"></span></p><span class="anchor" id="line-125"></span><ol type="1"><li><p class="line879">Open IIS Manager by going to Start Menu-&gt;Programs-&gt;Administrative Tools-&gt;IIS Manager. <span class="anchor" id="line-126"></span></p><span class="anchor" id="line-127"></span></li><li class="gap"><p class="line879">Go to the <strong>Web Service Extensions</strong> folder. <span class="anchor" id="line-128"></span></p><span class="anchor" id="line-129"></span></li><li class="gap"><p class="line879">Under the <strong>Action</strong> menu, select <strong>Add a new Web service extension...</strong>. <span class="anchor" id="line-130"></span></p><span class="anchor" id="line-131"></span></li><li class="gap"><p class="line879">For Extension name, give it a name such as <em>.cgi</em> or <em>Python cgi</em> or something. <span class="anchor" id="line-132"></span></p><span class="anchor" id="line-133"></span></li><li class="gap"><p class="line879">Under <strong>Required files</strong> click the <strong>Add...</strong> button and type in the exact command-line string you used above. Eg: <em>c:\python24\python.exe -u "%s" "%s"</em>, then click the <strong>Ok</strong> button. <span class="anchor" id="line-134"></span></p><span class="anchor" id="line-135"></span></li><li class="gap"><p class="line879">Make sure the <strong>Set extension status to Allowed</strong> checkbox is checked and click the <strong>Ok</strong> button. <span class="anchor" id="line-136"></span></p><span class="anchor" id="line-137"></span></li></ol><p class="line886">Another change that may be necessary if you are receiving HTTP Error 403 19 1314 while using IIS 6.0 is to adjust the Identity settings for the Application Pool that is being used by your site.  The following steps assume you are adjusting the Default Web Site. <span class="anchor" id="line-138"></span></p><span class="anchor" id="line-139"></span><ol type="1"><li><p class="line879">Open IIS Manager by going to Start Menu-&gt;Programs-&gt;Administrative Tools-&gt;IIS Manager. <span class="anchor" id="line-140"></span></p><span class="anchor" id="line-141"></span></li><li class="gap"><p class="line879">Go to the <strong>Application Pool</strong> folder. <span class="anchor" id="line-142"></span></p><span class="anchor" id="line-143"></span></li><li class="gap"><p class="line879">Select the Application Pool you wish to adjust. (likely <strong>Default<tt class="backtick"></tt>App<tt class="backtick"></tt>Pool</strong> ) When you do this on the right you will see the Application pools for each site on the server.  This will include a Description (likely <strong>Default Application</strong> )and a Path (<strong>&lt;Default Web Site&gt;</strong>).  In this way you can be certain you are adjusting the appropriate Application Pool. <span class="anchor" id="line-144"></span></p><span class="anchor" id="line-145"></span></li><li class="gap"><p class="line879">With <strong>Default<tt class="backtick"></tt>App<tt class="backtick"></tt>Pool</strong> still selected right click and select <strong>Properties</strong>. <span class="anchor" id="line-146"></span></p><span class="anchor" id="line-147"></span></li><li class="gap"><p class="line879">Select the <strong>Identity</strong> tab and with <strong>Predefined</strong> clicked use the drop down box to change the <strong>Identity</strong> to <strong>Local System</strong> instead of Network Service. <span class="anchor" id="line-148"></span></p><span class="anchor" id="line-149"></span><p class="line903"><em>Please be aware that this is a workaround since you SHOULD set your group settings to allow Network Service to access the cgi scripts.</em> <span class="anchor" id="line-150"></span></p><span class="anchor" id="line-151"></span></li></ol><p class="line886">Under Windows Server 2003, you will also need to give your IUSR_MACHINENAME account Modify access to the mywiki\data and mywiki\underlay sub-directories, as file system permissions are more restricted by default than previous Windows versions. <span class="anchor" id="line-152"></span></p><span class="anchor" id="line-153"></span>
 <h2 id="head-086499a2b43629c3fef3b36dc435cff210e32faa">Troubleshooting</h2>
-<span class="anchor" id="line-155"></span><span class="anchor" id="line-156"></span><p class="line879">If you see an error like "<tt>ImportError:&nbsp;No&nbsp;module&nbsp;named&nbsp;MoinMoin</tt>", it means that python cannot find Moin<tt class="backtick"></tt>Moin. See above for how to add to <tt class="backtick">sys.path</tt>. <span class="anchor" id="line-157"></span></p><span class="anchor" id="line-158"></span><p class="line886">If you see an error like Error 13: Permission Denied, it means that your web user permissions for the files do not have write/modify enabled. <span class="anchor" id="line-159"></span></p><span class="anchor" id="line-160"></span><p class="line879">If the page never loads after hitting <tt class="backtick">Save&nbsp;Changes</tt>, you should check the permissions of the <tt class="backtick">data</tt> directory.  Make sure the IUSR_COMPUTERNAME user has modify permissions. <span class="anchor" id="line-161"></span></p><span class="anchor" id="line-162"></span><p class="line879">If some images like <a href="http://moinmaster.wikiwikiweb.de/InterWiki">InterWiki</a> and <a class="nonexistent nonexistent" href="http://moinmaster.wikiwikiweb.de/WorldWideWeb">WorldWideWeb</a> don't show up, it could have been because of incorrect permissions or a bad "<tt class="backtick">url_prefix</tt>" in "<tt class="backtick">wikiconfig.py</tt>" or the cached pages need to be updated by an Edit or deleting them in the data folder. Or you are using MS IE which has broken CSS :before support - try another browser. <span class="anchor" id="line-163"></span></p><span class="anchor" id="line-164"></span><p class="line886">If you see an error message like: <span class="anchor" id="line-165"></span><span class="anchor" id="line-166"></span></p><pre>Check your URL regular expressions in the "wikis" list in "farmconfig.py". Content-type: text/html;charset=utf-8
-<span class="anchor" id="line-167"></span>MoinMoin Configuration Error
-<span class="anchor" id="line-168"></span>Could not find a match for url: "servername/wikiname/moin.cgi?
-<span class="anchor" id="line-169"></span>Check your URL regular expressions in the "wikis" list in "farmconfig.py".
-<span class="anchor" id="line-170"></span></pre><span class="anchor" id="line-171"></span><span class="anchor" id="line-172"></span><p class="line886">and you don't intend on using a serverfarm, remove the farmconfig.py and farmconfig.pyc files and try again.  The error message shouldn't appear when you refresh the page.  <span class="anchor" id="line-173"></span></p><span class="anchor" id="line-174"></span><p class="line879">If you are using URLScan, you might have to add the following setting in the file <tt class="backtick">%SystemRoot%\system32\inetsrv\urlscan\urlscan.ini</tt>: <span class="anchor" id="line-175"></span></p><pre>[options]
-<span class="anchor" id="line-176"></span>AllowHighBitCharacters=1
-<span class="anchor" id="line-177"></span></pre><span class="anchor" id="line-178"></span><span class="anchor" id="bottom_Include_HelpOnInstalling/InternetInformationServer"></span></div> <span class="anchor" id="line-75"></span></p><hr class="hr2" /><p class="line886"> <span class="anchor" id="line-76"></span><span class="anchor" id="trouble-shooting"></span> <span class="anchor" id="line-77"></span>
+<span class="anchor" id="line-154"></span><span class="anchor" id="line-155"></span><p class="line879">If you see an error like "<tt>ImportError:&nbsp;No&nbsp;module&nbsp;named&nbsp;MoinMoin</tt>", it means that python cannot find Moin<tt class="backtick"></tt>Moin. See above for how to add to <tt class="backtick">sys.path</tt>. <span class="anchor" id="line-156"></span></p><span class="anchor" id="line-157"></span><p class="line886">If you see an error like Error 13: Permission Denied, it means that your web user permissions for the files do not have write/modify enabled. <span class="anchor" id="line-158"></span></p><span class="anchor" id="line-159"></span><p class="line879">If the page never loads after hitting <tt class="backtick">Save&nbsp;Changes</tt>, you should check the permissions of the <tt class="backtick">data</tt> directory.  Make sure the IUSR_COMPUTERNAME user has modify permissions. <span class="anchor" id="line-160"></span></p><span class="anchor" id="line-161"></span><p class="line879">If some images like <a href="http://moinmaster.wikiwikiweb.de/InterWiki">InterWiki</a> and <a class="nonexistent nonexistent" href="http://moinmaster.wikiwikiweb.de/WorldWideWeb">WorldWideWeb</a> don't show up, it could have been because of incorrect permissions or a bad "<tt class="backtick">url_prefix</tt>" in "<tt class="backtick">wikiconfig.py</tt>" or the cached pages need to be updated by an Edit or deleting them in the data folder. Or you are using MS IE which has broken CSS :before support - try another browser. <span class="anchor" id="line-162"></span></p><span class="anchor" id="line-163"></span><p class="line886">If you see an error message like: <span class="anchor" id="line-164"></span><span class="anchor" id="line-165"></span></p><pre>Check your URL regular expressions in the "wikis" list in "farmconfig.py". Content-type: text/html;charset=utf-8
+<span class="anchor" id="line-166"></span>MoinMoin Configuration Error
+<span class="anchor" id="line-167"></span>Could not find a match for url: "servername/wikiname/moin.cgi?
+<span class="anchor" id="line-168"></span>Check your URL regular expressions in the "wikis" list in "farmconfig.py".
+<span class="anchor" id="line-169"></span></pre><span class="anchor" id="line-170"></span><span class="anchor" id="line-171"></span><p class="line886">and you don't intend on using a serverfarm, remove the farmconfig.py and farmconfig.pyc files and try again.  The error message shouldn't appear when you refresh the page.  <span class="anchor" id="line-172"></span></p><span class="anchor" id="line-173"></span><p class="line879">If you are using URLScan, you might have to add the following setting in the file <tt class="backtick">%SystemRoot%\system32\inetsrv\urlscan\urlscan.ini</tt>: <span class="anchor" id="line-174"></span></p><pre>[options]
+<span class="anchor" id="line-175"></span>AllowHighBitCharacters=1
+<span class="anchor" id="line-176"></span></pre><span class="anchor" id="line-177"></span><span class="anchor" id="bottom_Include_HelpOnInstalling/InternetInformationServer"></span></div> <span class="anchor" id="line-75"></span></p><hr class="hr2" /><p class="line886"> <span class="anchor" id="line-76"></span><span class="anchor" id="trouble-shooting"></span> <span class="anchor" id="line-77"></span>
 <h1>Trouble-shooting</h1>
 <div dir="ltr" id="Include_HelpOnInstalling/TroubleShooting" lang="en"><span class="anchor" id="top_Include_HelpOnInstalling/TroubleShooting"></span>
 <span class="anchor" id="line-8"></span><span class="anchor" id="line-9"></span><p class="line903"><strong>How to deal with common errors</strong> <span class="anchor" id="line-10"></span></p><span class="anchor" id="line-11"></span>
--- a/setup.py	Sun Mar 26 16:22:23 2006 +0000
+++ b/setup.py	Sun Mar 26 16:44:55 2006 +0000
@@ -213,10 +213,7 @@
         'MoinMoin.script.import',
         'MoinMoin.script.old',
         'MoinMoin.script.old.migration',
-        'MoinMoin.script.old.reducewiki',
-        'MoinMoin.script.old.unicode',
         'MoinMoin.script.old.xmlrpc-tools',
-        'MoinMoin.script.old.packages',
         'MoinMoin.server',
         'MoinMoin.stats',
         'MoinMoin.support',
--- a/tests/make_test.out	Sun Mar 26 16:22:23 2006 +0000
+++ b/tests/make_test.out	Sun Mar 26 16:44:55 2006 +0000
@@ -80,8 +80,8 @@
 error: create with encoded string ... ok
 error: create with any object ... ok
 error: create with unicode ... ok
-testSyntaxReference (MoinMoin._tests.test_formatter.FormatterTestCase) ... Formatting using <class MoinMoin.formatter.dom_xml.Formatter at 0x55b782fc>
-[('xml', {}), ('p', {'type': 'ol'}), ('ol', {'start': None, 'type': u'1'}), ('li', {})]
+testSyntaxReference (MoinMoin._tests.test_formatter.FormatterTestCase) ... Formatting using <class MoinMoin.formatter.dom_xml.Formatter at 0x55bbdbfc>
+[('xml', {}), ('ul', {}), ('li', {}), ('p', {}), ('attachment', {'href': u'filename.txt'})]
 ERROR
 testQuoting (MoinMoin._tests.test_packages.QuotingTestCase) ... ok
 testBasicPackageThings (MoinMoin._tests.test_packages.UnsafePackageTestcase) ... ok
@@ -124,10 +124,6 @@
 pysupport: import nonexistent attritbue raises AttributeError ... ok
 pysupport: import nonexistent module raises ImportError ... ok
 pysupport: import nonexistent wiki plugin fail ... ok
-repair_language: should replace known language ... ok
-repair_language: return crlf line endings ... ok
-repair_language: should not replace in page body ... ok
-repair_language: should not replace unknown langauge ... ok
 request: getPageNameFromQueryString: ascii ... ok
 request: getPageNameFromQueryString: non ascii ... ok
 request: getPageNameFromQueryString: under_score ... ok
@@ -213,9 +209,9 @@
     self.do(test, output)
   File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1074, in do
     super(StripWhitespaceTests, self).do(converter.strip_whitespace, text, output)
-  File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1064, in do
-    raise _tests.TestSkiped('xml.dom.ext module is not available')
-TestSkipped: xml.dom.ext module is not available
+  File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1058, in do
+    tree = converter.parse(text)
+TypeError: parse() takes exactly 2 arguments (1 given)
 
 ======================================================================
 ERROR: test2 (MoinMoin._tests.test_converter_text_html_text_x_moin.StripWhitespaceTests)
@@ -225,9 +221,9 @@
     self.do(test, output)
   File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1074, in do
     super(StripWhitespaceTests, self).do(converter.strip_whitespace, text, output)
-  File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1064, in do
-    raise _tests.TestSkiped('xml.dom.ext module is not available')
-TestSkipped: xml.dom.ext module is not available
+  File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1058, in do
+    tree = converter.parse(text)
+TypeError: parse() takes exactly 2 arguments (1 given)
 
 ======================================================================
 ERROR: test3 (MoinMoin._tests.test_converter_text_html_text_x_moin.StripWhitespaceTests)
@@ -237,9 +233,9 @@
     self.do(test, output)
   File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1074, in do
     super(StripWhitespaceTests, self).do(converter.strip_whitespace, text, output)
-  File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1064, in do
-    raise _tests.TestSkiped('xml.dom.ext module is not available')
-TestSkipped: xml.dom.ext module is not available
+  File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1058, in do
+    tree = converter.parse(text)
+TypeError: parse() takes exactly 2 arguments (1 given)
 
 ======================================================================
 ERROR: test4 (MoinMoin._tests.test_converter_text_html_text_x_moin.StripWhitespaceTests)
@@ -249,9 +245,9 @@
     self.do(test, output)
   File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1074, in do
     super(StripWhitespaceTests, self).do(converter.strip_whitespace, text, output)
-  File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1064, in do
-    raise _tests.TestSkiped('xml.dom.ext module is not available')
-TestSkipped: xml.dom.ext module is not available
+  File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_converter_text_html_text_x_moin.py", line 1058, in do
+    tree = converter.parse(text)
+TypeError: parse() takes exactly 2 arguments (1 given)
 
 ======================================================================
 ERROR: testSyntaxReference (MoinMoin._tests.test_formatter.FormatterTestCase)
@@ -261,20 +257,21 @@
     self.formatPage("SyntaxReference", formatter)
   File "/srv/moin_tw/moin--main--1.5/MoinMoin/_tests/test_formatter.py", line 45, in formatPage
     return self.request.redirectedOutput(page.send_page, self.request)
-  File "/srv/moin_tw/moin--main--1.5/MoinMoin/request.py", line 682, in redirectedOutput
+  File "MoinMoin/script/../../MoinMoin/request.py", line 718, in redirectedOutput
     function(*args, **kw)
-  File "../../MoinMoin/Page.py", line 1227, in send_page
-  File "../../MoinMoin/Page.py", line 1306, in send_page_content
-  File "../../MoinMoin/Page.py", line 1323, in format
-  File "/srv/moin_tw/moin--main--1.5/MoinMoin/parser/wiki.py", line 1061, in format
-    self.request.write(self._indent_to(indlen, indtype, numtype, numstart))
-  File "/srv/moin_tw/moin--main--1.5/MoinMoin/parser/wiki.py", line 571, in _indent_to
-    close.append(self.formatter.paragraph(0))
+  File "/srv/moin_tw/moin--main--1.5/MoinMoin/Page.py", line 1235, in send_page
+    start_line=pi_lines)
+  File "/srv/moin_tw/moin--main--1.5/MoinMoin/Page.py", line 1314, in send_page_content
+    self.format(parser)
+  File "/srv/moin_tw/moin--main--1.5/MoinMoin/Page.py", line 1331, in format
+    parser.format(self.formatter)
+  File "/srv/moin_tw/moin--main--1.5/MoinMoin/parser/wiki.py", line 1033, in format
+    self.request.write(self.formatter.paragraph(0))
   File "/srv/moin_tw/moin--main--1.5/MoinMoin/formatter/dom_xml.py", line 301, in paragraph
     return self._set_tag('p', on)
   File "/srv/moin_tw/moin--main--1.5/MoinMoin/formatter/dom_xml.py", line 159, in _set_tag
     raise ValueError, "<%s> expected <%s> given" % (last_tag, tag)
-ValueError: <li> expected <p> given
+ValueError: <attachment> expected <p> given
 
 ======================================================================
 FAIL: testComment01 (MoinMoin._tests.test_converter_text_html_text_x_moin.ConvertBlockRepeatableTests)
@@ -1241,6 +1238,6 @@
 AssertionError: "FrontPage" is NOT a system page
 
 ----------------------------------------------------------------------
-Ran 201 tests in 9.665s
+Ran 197 tests in 6.962s
 
 FAILED (failures=82, errors=5)
--- a/wiki/data/intermap.txt	Sun Mar 26 16:22:23 2006 +0000
+++ b/wiki/data/intermap.txt	Sun Mar 26 16:44:55 2006 +0000
@@ -89,7 +89,7 @@
 OddMuse http://www.oddmuse.org/
 OPAG http://opag.ca/wiki?
 OpenMind http://www2.iro.umontreal.ca/~paquetse/cgi-bin/om.cgi?
-OpenWiki http://openwiki.com/?
+OpenWiki http://openwiki.com/ow.asp?
 OrgPatterns http://www.easycomp.org/cgi-bin/OrgPatterns?
 PeriPeri http://www.srcf.ucam.org/~cjp39/Peri/
 PersonalTelco http://www.personaltelco.net/index.cgi/