welcome: please sign in

The following 217 words could not be found in the dictionary of 7 words (including 7 LocalSpellingWords) and are highlighted below:
above   adapt   add   advantage   all   also   an   and   another   applications   are   arguments   as   at   Basic   be   below   Besides   cached   can   cgi   change   Check   class   click   close   cmd   code   com   Comment   commented   Config   config   configuration   Configuring   contains   Contents   copy   Copy   create   Creation   data   default   Default   developer   did   dir   directory   distributions   do   docs   documentation   Don   Double   driven   Edit   enhancing   entries   entry   event   file   files   finds   fine   First   For   for   framework   from   general   group   hardcoded   has   have   htdocs   http   if   If   ignored   imports   in   including   information   initialized   initscript   insert   Install   install   Installation   installation   Instance   interfaces   interpreter   is   It   itself   just   kinds   like   Linux   list   listen   loaded   localhost   Log   log   Mac   make   many   Many   memory   might   mointwisted   montwisted   more   need   needs   networking   new   not   Of   of   On   on   one   only   Option   options   or   other   Otherwise   packages   path   Path   performance   persistently   Please   pointing   port   Port   prefix   privileged   probably   profiler   py   python   refer   request   root   run   same   sample   script   scripts   section   see   serve   server   settings   share   shared   should   skip   standard   Start   start   Starting   startup   static   stop   Stop   sure   sys   System   Table   terminal   test   that   The   the   This   this   time   to   To   trac   twistd   Twisted   twistedmatrix   Unix   url   used   Useful   user   Using   usr   value   via   want   web   webserver   what   where   which   wiki   Wiki   wikiconfig   will   window   Windows   with   without   working   www   You   you   your  

Clear message
Page Locked

HelpOnInstalling / TwistedWeb

1. Using MoinMoin with Twisted

Twisted is an event-driven networking framework for many kinds of applications. For MoinMoin Twisted is used as a 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.

Besides the general installation you need 3 files:

  1. the script /path/to/cgi-dir/mointwisted (see "Starting the server" below)

  2. the webserver script file like mointwisted.py (which needs to be in the same directory where your working directory is).

  3. the configuration file like /path/to/wikiconfig-dir/wikiconfig.py

Contents

  1. Using MoinMoin with Twisted
    1. Install Twisted
    2. Configuring the Twisted server
      1. System path configuration
      2. Config class options
    3. Configuring wikiconfig.py
    4. Starting the server
      1. on Unix
      2. on Windows

1.1. Install Twisted

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

1.2. Configuring the Twisted server

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

1.2.1. System path configuration

If you did a standard install, and you are not a developer, you probably want to skip this section. Otherwise, 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')

1.2.2. 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 as this user

group

'www-data'

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

port

8080

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

interfaces

['']

A list of interfaces the server will listen to. If the list contains the entry '' (like for the default configuration), all other entries are ignored and the server will listen to all interfaces.

logPath

'mointwisted.log'

Log file.

profiler

commented python code

Useful only if you are a moin developer.

1.3. Configuring wikiconfig.py

The sample config file should be just fine.

Don't change url_prefix_static as the default value is hardcoded in the Twisted server.

1.4. Starting the server

1.4.1. on Unix

On GNU/Linux, Mac OS X or another POSIX-like OS, copy wiki/server/mointwisted to your wiki directory. You might want to adapt PYTHONPATH and the path to twistd.

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

For more options run ./mointwisted without arguments.

If you want to start the server via initscript make sure mointwisted finds montwisted.py on startup!

1.4.2. 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.