[Moin-devel] CVS: dist/wiki/data/text HelpOnInstalling_2fApacheOnWin32,NONE,1.1 HelpContents,1.9,1.10 HelpOnSkins,1.1,1.2 TitleIndex,1.3,1.4 WordIndex,1.3,1.4

J?rgen Hermann jhermann at users.sourceforge.net
Mon Feb 25 16:26:02 EST 2002


Update of /cvsroot/moin/dist/wiki/data/text
In directory usw-pr-cvs1:/tmp/cvs-serv2564

Modified Files:
	HelpContents HelpOnSkins TitleIndex WordIndex 
Added Files:
	HelpOnInstalling_2fApacheOnWin32 
Log Message:
HelpOnInstalling/ApacheOnWin32; some other minor changes


--- NEW FILE: HelpOnInstalling_2fApacheOnWin32 ---
'''Index'''
[[TableOfContents]]

== Requirements ==

Before you install MoinMoin, make sure you have the necessary infra-structure in place, namely the ''Apache for Microsoft Windows'' webserver, and a ''Python'' installation (version 2.0 or higher is recommended, don't run 1.5.2 without a compelling reason).

In the following description, we assume that you have installed or will install things to these locations:
 * `C:\Apache` - the webserver
 * `C:\Python` - the Python interpreter
 * `C:\Moin` - MoinMoin itself

Quite often, you might want to install things elsewhere, which is no problem at all; you just have to adapt any paths that appear in a command or config file to the locations you have chosen.

This installation procedure was tested with Apache 1.3.23 for Windows running on Windows/NT4SP6a, and using Python 2.0.

== Preparation ==

=== Installing Apache ===

You currently need an external webserver to run MoinMoin, the recommended option is to use Apache if you haven't installed one on your machine already. To install Apache, consult the [http://httpd.apache.org/docs/windows.html Using Apache With Microsoft Windows] document. Make sure that your webserver runs without problems before you start to install MoinMoin; problems with your webserver installation are not in the scope of this document.

=== Installing Python ===

Download [http://www.python.org/ftp/python/2.1.2/Python-2.1.2.exe Python 2.1.2] and install it. Python installation is done via a standard Windows installer program, which you should be familiar with.

=== Installing MoinMoin ===

Before creating a wiki instance, you have to download and install the basic MoinMoin software. We assume you already have downloaded the distribution archive to the "`C:\TEMP`" directory[[FootNote(If you want to install the current development version from CVS, replace "C:\TEMP" with the directory containing your "moin" working directory.)]].

Open a console window and enter the following commands:
{{{
C:
cd \temp
unzip moin-0.11.zip
cd moin-0.11
python setup.py install --prefix C:\Moin --record=install.log
}}}

This will install all necessary files to the "`C:\Moin`" directory, and create a "`install.log`" file listing all the files that are created there.

[[FootNote]]

== Creating a Wiki Instance ==

You could run your wiki directly using the sample wiki created in "`C:\Moin`", but this is not recommended for two reasons:
 1. updating your wiki is more complicated and more dangerous.
 1. creating a second wiki instance, even if you currently don't plan for one, is much easier.

So, enter these commands in a console window:
{{{
cd \Moin
md mywiki
md mywiki\data
xcopy share\moin\data mywiki\data /E
copy share\moin\cgi-bin mywiki
}}}

"`mywiki`" is the name of your wiki instance, you might want to chose a different name best fitting the intended use of this instance; just don't name it simply "`wiki`", because that would result in problems later on.

Next, start your editor and create the file "`C:\Moin\mywiki\moin.bat`" with the following content (remember to change any paths that are different with your setup): {{{
@echo off
set PYTHONPATH=C:\Moin
C:
cd \Moin\mywiki
C:\Python\python.exe moin.cgi
}}}

Then, append these lines to "`C:\Apache\conf\httpd.conf`": {{{
Alias /wiki/ "C:/Moin/share/moin/htdocs/"
ScriptAlias /mywiki "C:/Moin/mywiki/moin.bat"
}}}

The first line you only need once; the second line is needed once for each wiki instance (of course, each one with another wiki name and path).

That is all, '''restart your Apache server''' and try to access your new-born wiki with the URL "`http://127.0.0.1/mywiki/`". You should see the FrontPage, try to edit and save it, and if that works, see if your edit is reflected on the RecentChanges page.

Finally, edit "`moin_config.py`" and at least change "`sitename`" and "`logo_url`" to some personal values:
{{{
sitename = 'My Wiki'
logo_url = '/images/mywiki-logo.gif'
}}}

For a personal or intranet installation, you'll normally also add the line {{{
allowed_actions = ['DeletePage', 'AttachFile']
}}}

Index: HelpContents
===================================================================
RCS file: /cvsroot/moin/dist/wiki/data/text/HelpContents,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -r1.9 -r1.10
*** HelpContents	20 Feb 2002 21:11:55 -0000	1.9
--- HelpContents	26 Feb 2002 00:25:10 -0000	1.10
***************
*** 19,21 ****
--- 19,23 ----
  An automatically generated index of all help pages is on HelpIndex. See also HelpMiscellaneous/FrequentlyAskedQuestions for answers to frequently asked questions.
  
+ If you find any errors on the help pages, describe them on HelpErrata. 
+ 
  ''[Please do not add redundant information on these pages (which has to be maintained at two places then), and follow the established structure of help pages. Also note that the master set of help pages is not public, that this very page you read and all other help pages may be overwritten when the wiki software is updated. So if you have major contributions that should not get lost, send an extra notification notice to the MoinMoin user mailing list.]''

Index: HelpOnSkins
===================================================================
RCS file: /cvsroot/moin/dist/wiki/data/text/HelpOnSkins,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -r1.1 -r1.2
*** HelpOnSkins	20 Feb 2002 20:57:58 -0000	1.1
--- HelpOnSkins	26 Feb 2002 00:25:10 -0000	1.2
***************
*** 1,5 ****
  == Changing the page layout ==
  
! While MoinMoin currently has no full support for HTML templates, and switching between several layouts, you can change the most important parts of the generated HTML code, and add your own HT;L fragments.
  
   * configurable footer ("page_footer1" and "page_footer2") 
--- 1,7 ----
+ <!> TODO
+ 
  == Changing the page layout ==
  
! While MoinMoin currently has no full support for HTML templates, and switching between several layouts, you can change the most important parts of the generated HTML code, and add your own HTML fragments.
  
   * configurable footer ("page_footer1" and "page_footer2") 

Index: TitleIndex
===================================================================
RCS file: /cvsroot/moin/dist/wiki/data/text/TitleIndex,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -r1.3 -r1.4
*** TitleIndex	13 Feb 2002 21:52:28 -0000	1.3
--- TitleIndex	26 Feb 2002 00:25:10 -0000	1.4
***************
*** 1,9 ****
  ##cvsid: $Id$
  
! This is an index of all pages in the MoinMoin Wiki.  
  
  See also:
!   * WordIndex -- a permuted index of all words occuring in titles
!   * RecentChanges
  
  ----
--- 1,9 ----
  ##cvsid: $Id$
  
! This is an index of all pages in the this Wiki.  
  
  See also:
!  * WordIndex -- a permuted index of all words occuring in titles
!  * SiteNavigation -- other indexing schemes
  
  ----

Index: WordIndex
===================================================================
RCS file: /cvsroot/moin/dist/wiki/data/text/WordIndex,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -r1.3 -r1.4
*** WordIndex	13 Feb 2002 21:52:28 -0000	1.3
--- WordIndex	26 Feb 2002 00:25:10 -0000	1.4
***************
*** 5,9 ****
  See also:
   * TitleIndex -- a shorter index
!  * RecentChanges
  
  ----
--- 5,9 ----
  See also:
   * TitleIndex -- a shorter index
!  * SiteNavigation -- other indexing schemes
  
  ----





More information about the Moin-devel mailing list