<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>InstallDocs/QuickInstall</title></articleinfo><section><title>Quick Installation: The 1 minute MoinMoin install</title><orderedlist numeration="arabic"><listitem><para>Unpack the MoinMoin release archive (get it from MoinMoin:MoinMoinDownload). </para></listitem><listitem><para>Run wikiserver.py from the top level directory. </para></listitem><listitem><para>Read and follow this page in your wiki: <ulink url="http://localhost:8080/LanguageSetup"/> </para></listitem><listitem><para>You are done! Have fun! <inlinemediaobject><imageobject><imagedata depth="16" fileref="http://research.math.uvt.ro/wiki//static/moniker/img/smile.png" width="16"/></imageobject><textobject><phrase>:)</phrase></textobject></inlinemediaobject> </para></listitem></orderedlist><para>If these steps were not verbose enough for you, you can try one of these more detailed instructions: </para><itemizedlist><listitem><para><link linkend="qdlinux">Skip to Linux</link> </para></listitem><listitem><para><link linkend="qdmac">Skip to Mac OS X</link> </para></listitem><listitem><para><link linkend="qdwindows">Skip to Windows</link> </para></listitem></itemizedlist><!--rule (<hr>) is not applicable to DocBook--><para><anchor id="qdlinux"/> </para><section><title>Linux: Detailed Quick Installation</title><section><title>Download MoinMoin</title><para>Please read the MoinMoin:MoinMoinDownload wiki page to find and download the latest MoinMoin release version. </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="http://research.math.uvt.ro/wiki//static/moniker/img/idea.png" width="16"/></imageobject><textobject><phrase>(!)</phrase></textobject></inlinemediaobject> Please remember the path where you saved that download and also its exact filename. </para><para>The filename will likely be something like <code>moin-1.9.0.tar.gz</code> (for moin version 1.9.0), but we will just talk of moin-x.x.x because the concrete version number changes often. You have to use the real version number in the commands you enter, not x.x.x, of course. </para></section><section><title>Working on the shell</title><para>For the next steps, we will work on a shell prompt (for sure you can also do all the steps using some GUI tool of your favourite desktop environment, but because of the diversity of those environments, you will have to find out the right tools yourself using these steps as a guideline). </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="http://research.math.uvt.ro/wiki//static/moniker/img/idea.png" width="16"/></imageobject><textobject><phrase>(!)</phrase></textobject></inlinemediaobject> If you use some graphical desktop environment or some X Window Manager, you will first have to find a terminal window (usually called &quot;Terminal&quot;, &quot;XTerm&quot;, &quot;shell&quot;, &quot;bash&quot;, &quot;Command line window&quot; or similar) and start it. If you see something showing a $ and a blinking cursor to the right of it, it worked. We shall also refer to this window as the &quot;shell&quot;. </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="http://research.math.uvt.ro/wiki//static/moniker/img/alert.png" width="16"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> Note that you <emphasis role="strong">must not</emphasis> use a &quot;root shell&quot; for this type of installation. Just use a shell as the non-priviledged user you usually log in as. You can use the <code>id</code> command to display what user you are and it must not display &quot;root&quot;. </para><para>For the next steps, we assume you have downloaded the moin archive into your home directory and that the current directory is your home directory (that's the default when you start a shell, usually indicated by a shell prompt showing <code>~$</code> - the tilde means you are in your home directory and the dollar means that you can enter a command to the right of it). </para></section><section><title>Verify the integrity of your downloaded file</title><para>Make sure the archive downloaded correctly by verifying the md5sum (a checksum) of the archive: </para><screen><![CDATA[$ md5sum moin-x.x.x.tar.gz
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX  moin-x.x.x.tar.gz]]></screen><para>The value (XXX...) md5sum shown left of the filename must match the value published on the download page for the file you just downloaded! </para><para><inlinemediaobject><imageobject><imagedata depth="16" fileref="http://research.math.uvt.ro/wiki//static/moniker/img/alert.png" width="16"/></imageobject><textobject><phrase>/!\</phrase></textobject></inlinemediaobject> If it does not match, your download is corrupted somehow. Remove the file and try downloading it again. </para></section><section><title>Unpack MoinMoin</title><para>We use a gzipped tar archive for our release archives - you need to unpack it before using. </para><para>Unpack it using this command on the shell: </para><screen><![CDATA[$ tar xvzf moin-x.x.x.tar.gz
(it will show a long list of all files it has unpacked)]]></screen><para>This will create a directory <code>moin-x.x.x</code> in the current directory with all the MoinMoin release files in it. </para></section><section><title>Run MoinMoin</title><para>MoinMoin is written using the Python programming language so you need to start it using the python interpreter: </para><screen><![CDATA[$ cd moin-x.x.x
$ python wikiserver.py
(you will see the log output of the running MoinMoin server here)]]></screen><para>After MoinMoin has started, it will show some log output in your terminal window. Within that logging output, it will also announce on which IP address and port the server runs (e.g. <ulink url="http://127.0.0.1:8080"/>). </para><para>Now just leave that terminal window as it is and the builtin web server of MoinMoin will work as long as you don't stop it. </para><para>You can stop the server by closing that terminal window or by pressing <code>Ctrl-C</code> to interrupt it. </para></section><section><title>Use MoinMoin</title><para>Just point your web browser at the address you got from the terminal window (e.g.: <ulink url="http://127.0.0.1:8080/"/> or <ulink url="http://localhost:8080/"/> ). </para><para>You should now see your fresh moin wiki in your browser. Maybe bookmark that address so you don't have to enter it manually each time you want to use your wiki. </para><para>Your wiki is now ready to use. Have fun! <inlinemediaobject><imageobject><imagedata depth="16" fileref="http://research.math.uvt.ro/wiki//static/moniker/img/smile.png" width="16"/></imageobject><textobject><phrase>:)</phrase></textobject></inlinemediaobject> </para></section></section><!--rule (<hr>) is not applicable to DocBook--><para><anchor id="qdmac"/> </para><section><title>Mac: Detailed Quick Installation</title><para>Apple's Mac operating system comes with Python already installed as a part of the core system software making running a MoinMoin wiki very easy. </para><section><title>Download MoinMoin</title><orderedlist numeration="arabic"><listitem><para>Download the latest Moin from MoinMoin:MoinMoinDownload page. </para></listitem><listitem><para>Double-click to expand. </para></listitem></orderedlist></section><section><title>Starting Moin for the first time</title><para>By default, python scripts (.py) will open in TextEdit.app. For convenience, we'll want to associate .py files to open in Terminal.app so that we can simply double-click the <code>wikiserver.py</code> file to run Moin. </para><orderedlist numeration="arabic"><listitem><para>Right-click (control-click) on the <code>wikiserver.py</code> file. </para></listitem><listitem><para>From the contextual-menu, </para><orderedlist numeration="lowerroman"><listitem><para>Select &quot;Open with...&quot; &gt; &quot;Other...&quot;; </para></listitem><listitem><para>From the file dialog, select &quot;All Applications&quot;, check &quot;Always Open With&quot;, then navigate to Terminal.app (located in //Applications/Utilites/). </para><para> (The &quot;Always open with&quot; sets Terminal.app as the default application so in future you can double-click the <code>wikiserver.py</code> file). </para></listitem></orderedlist></listitem></orderedlist></section><section><title>Daily Use</title><orderedlist numeration="lowerroman"><listitem><para>Double-click on the wikiserver.py file and Terminal.app will launch. </para></listitem><listitem><para>Point your browser at <ulink url="http://localhost:8080"/> </para></listitem><listitem><para>To quit the wiki, simply close the terminal window. </para></listitem></orderedlist></section></section><!--rule (<hr>) is not applicable to DocBook--><para><anchor id="qdwindows"/> </para><section><title>Windows:  Detailed Quick Installation</title><para>MoinMoin relies on Python which requires a separate install on Windows. </para><section><title>Download &amp; Install Python</title><itemizedlist><listitem><para>Go to <ulink url="http://www.python.org/download/"/> and download the Python installer. </para></listitem><listitem><para>Run the installer! </para><itemizedlist><listitem><para>If you want to save some space, you can unselect all but the first two options (you won't need the 'Test Suite', 'Utility Scripts', or 'Documentation' unless you plan to develop in Python). </para></listitem><listitem><para>The installer will automatically associate .py files with Python. </para></listitem></itemizedlist></listitem></itemizedlist></section><section><title>Download &amp; Expand MoinMoin</title><orderedlist numeration="arabic"><listitem><para>Download the latest MoinMoin from the MoinMoin:MoinMoinDownload page. </para></listitem><listitem><para>Extract the files to a folder (using a utility such as <ulink url="http://www.7-zip.org">7-zip</ulink> or similar). </para></listitem><listitem><para>Simply double-click <code>wikiserver.py</code> which you will find in this folder. </para></listitem></orderedlist></section><section><title>Daily Use</title><orderedlist numeration="lowerroman"><listitem><para>Double-click on the <code>wikiserver.py</code> file and a black command window will open. </para></listitem><listitem><para>Point your browser to <ulink url="http://localhost:8080/"/>. </para></listitem><listitem><para>To quit the wiki, simply close the command window. </para></listitem></orderedlist></section></section><!--rule (<hr>) is not applicable to DocBook--></section></article>