帮助-安装/Apache和MacOsx

Create wiki instance. You can create and serve as many wikis as you like.

Installing MoinMoin

Download

Download the source on the Desktop. You should see a moin-1.3.tar.gz file. Extract this file on the desktop with Stuffit Expander, or from the terminal (faster and safer):

cd ~/Desktop
tar -xzf moin-1.3.0.tar.gz

Install procedure

Use these commands in the terminal to install the MoinMoin wiki engine into the system.

First, open a shell as root. You will need this to install MoinMoin and configure the wiki. When asked, enter your password.

sudo -s
... password:

Now you have root privileges in this shell.

Install:

cd moin-1.3.0
python setup.py install --install-data='/usr/local'

The --install-data='/usr/local' will put the shared data in the convenient '/usr/local/share/moin' folder. If you don't use it, your shared data will be at '/System/Library/Frameworks/Python.framework/Versions/2.3/share/moin'. On Mac OS X, '/usr' belong to Apple, and it is safer to install in '/usr/local'.

The default Python used by Apache is the framework one supplied by Apple. If you have added another Python version such as through DarwinPorts or Fink, then you should substitute "/usr/bin/python" for "python" above or you should substitute the specific path for the Python that will be used by Apache.

Now the installation is finished. You will not have to repeat this step unless you upgrade moin.

Optional Installs

RSS

If you want your wiki to support RSS and Mozilla Firefox Live Bookmarks features, you have to install PyXML. Get PyXML from http://sourceforge.net/projects/pyxml/ and install according to the instructions.

Creating a wiki

After you have installed the software, you need to create a wiki. You may create several wikis if you need.

Copying a template wiki

Copy a template wiki from the /usr/local/share/moin. Do not try to run the wiki from /usr/local/share/moin/data because your wiki will be overwritten when you install a new version of moin.

Security warning: do not put your wiki folder where the web server can access it! Your wiki should not be at the "Sites" folder in your home folder.

The following instructions will create a wiki called "mywiki". You can choose any name you like, except the reserved name "wiki".

You should see a report on the wiki and tests results for the MoinMoin engine. If some of the tests fail, please report the problem on MoinMoinBugs.

Configuring Your wiki

The wiki you created is a new "Untitled Wiki", using the default configuration. You want to give a better name and setup some configuration values. Open wikiconfig.py and read the comments. You can edit the file with any text editor, like pico, emacs, or BBEdit.

Note that the file belongs to user and group www:www. You can edit the file as root, or change the group of the file to yourself with chown www:username wikiconfig.py.