Help on using PersonalMoinMoin

See also:

/AdminInterface   /MockHelp   /OtherSoftware   /StorageAndPackaging  

This page describe how typical task are (actually, will) done. First we will describe a sane behavior, then implement it.

How to install

  1. Download the tarball/zip

  2. Extract and copy MoinMoin to your disk

How to run MoinMoin

  1. Double click the MoinMoin application

  2. The default browser will open showing the admin interface

Or:

  1. The default browser will open showing a new untitled wiki
    • Problem: This wiki need to be saved to disk. We can show a save dialog as soon as you try to edit the wiki - edit a page or try to add a page etc.

How to create a wiki

The admin interface can be a read only wiki contained in the MoinMnoin application directory, and accessed by the address localhost:port/

  1. Run MoinMoin, or open a browser in localhost:8000 (or whatever port you chose)

  2. Click "Create a Wiki" button
  3. Fill the form
  4. Click "Save"

The wiki will be accessible at localhost:8000/wikiname

How to change the wiki setup

Each wiki can have a link from the FrontPage to WikiAdmin. This page can be something like UserPreferences for users. You set the wiki options and save.

  1. Visit the wiki WikiAdmin at localhost:port/wikiname/WikiAdmin

  2. Set the options you like
    • Here one can set the wikiname, wikiurl, etc.
  3. Click "Save"

If we go with the idea of everything is saved inside the farm, and we use standard location, one does not have to specify the file system location, just save and a wiki directory is created in the farm, lets say in ~./moinmoin on Linux, or ~/Library/MoinMoin/ on Mac OS X. In this case, we can add a farm_dir to the farm configuration, pointing to the location of the farm directory, if one want to put it in another location.

Discussion

Multiple wikis needed?

For a personal wiki, do we need to support creation and administration of multiple wikis? maybe a single auto created wiki on first run is just fine?

We can support one auto created wiki in the first version, and see what users want for the next version.

This can simplify everything. You get a new untitled wiki on the first request - saved automatically in the default farm location. Then you can change this wiki setup by the WikiAdmin page.

Admin security

There is also the question of security - we can let only localhost to admin a wiki, unless the admin added an admin user name and password. With a user name and password, we can enable remote admin of a wiki, or at least partial admin, e.g, we don't want to enabled remote deleting of a wiki.

MoinMoin: PersonalMoinMoin/MockHelp (last edited 2007-10-29 19:15:04 by localhost)