[Alice]

HelpOnInstalling/TwistedWeb

The following 156 words could not be found in the dictionary of 635 words (including 635 LocalSpellingWords) and are highlighted below:

above   adapt   add   advantage   all   and   Another   applications   at   available   based   Basic   be   cached   can   Check   class   close   cmd   Comment   commented   Config   config   configuration   Configuring   Creation   css   default   Default   developer   did   distributions   docs   documentation   Double   enhancing   file   files   fine   for   framework   from   group   how   htdocs   if   If   ignored   images   imports   in   including   initialized   insert   Install   install   Installation   Instance   interfaces   interpreter   itself   just   kinds   like   Linux   list   listen   loaded   localhost   Log   log   Mac   Many   many   memory   might   mointwisted   need   needs   new   of   one   only   Option   options   or   other   packages   path   Path   performance   persistently   pointing   port   Port   posix   prefix   privileged   probably   profiler   python   Python   refer   request   root   run   sample   scripts   section   serve   server   set   settings   share   shared   should   skip   standalone   standard   Start   start   Starting   stop   Stop   sys   System   terminal   test   that   This   this   time   to   To   twistd   Twisted   twistedmatrix   under   Unix   use   Useful   user   Using   usr   want   we   web   what   wikiconfig   will   window   Windows   with   You   you   your  

Clear message

Using MoinMoin with Twisted

[WWW] Twisted is a standalone python framework for many kinds of applications. For MoinMoin, we use Twisted as a python web server that just imports MoinMoin persistently.

This has the advantage that the Python interpreter and all Python scripts (including Twisted itself and also MoinMoin) is only loaded and initialized one time, and that data can be cached in memory from request to request, enhancing the performance of MoinMoin.

Another advantage is that this is all based on Python. ;)

First do ../BasicInstallation and ../WikiInstanceCreation.

Install Twisted

First, install Twisted (see URL above). Many Linux distributions have Twisted packages. Please refer to the documentation of Twisted how to install it.

Configuring the Twisted server

Copy the file wiki/server/mointwisted.py to your wiki directory. Edit and adapt the settings to your needs.

System path configuration

If you did a standard install, and you are not a developer, you probably want to skip this section. If not, you might want to add the path to moin and config file, like that:

sys.path.insert(0, '/path/to/moin')
sys.path.insert(0, '/path/to/wikiconfig')

Config class options

If you did a standard install, the default options might be just what you need. Check and change what you like:

Option

Default

Comment

docs

'/usr/share/moin/wiki/htdocs'

Path to moin shared files

user

'www-data'

If you run as root, the server will run with as this user

group

'www-data'

If you run as root, the server will run with as this group

port

8080

Port to serve. To serve privileged port under 1024 you will have to run as root

interfaces

['']

The interfaces the server will listen to. The default will listen to all. You can set to a list of interfaces you like to listen. If '' is in the list, all other ignored.

logPath

'mointwisted.log'

Log file. Default is commented.

profiler

commented python code

Useful only if you are a moin developer.

Configuring wikiconfig.py

The sample config file should be just fine.

Option

Default

Comment

url_prefix

'/wiki'

You should not change this, or images and css file will not be available to the wiki!

Starting the server on Unix

On GNU/Linux, Mac OS X or other posix like OS, copy wiki/server/mointwisted to your wiki directory. You might want to adapt the python path and the path to twistd.

Start the server with ./mointwisted start and test your wiki at [WWW] http://localhost:8080/. Stop the server with ./mointwisted stop.

Starting the server on Windows

Copy wiki/server/mointwisted.cmd to your wiki directory. You might have to change the path pointing to the python-scripts directory.

Double click mointwisted.cmd to start the server. It will create a new terminal window. To stop the server, close the terminal window.