Utilizar o MoinMoin com o Twisted

O Twisted é uma framework de trabalho em rede orientada a eventos para vários tipos de aplicações. Para o MoinMoin, o Twisted é utilizado como um servidro web que importa persistentemente o MoinMoin. Isto tem a vantagem que o interpretador de Python e todos os scripts de Python (incluindo o próprio Twisted e o MoinMoin) só é carregado e iniciado uma vez, e os dados são guardado em memória cache de pedido a pedido, melhorando o desempenho do MoinMoin.

Para além da instalação geral, vai necessitar de 3 ficheiros:

  1. o script /path/to/cgi-dir/mointwisted (ver tópico "Iniciar o servidor" em baixo)

  2. o ficheiro do script do servidor web como mointwisted.py (que necessita de estar na mesma directoria que a sua directoria working).

  3. o ficheiro de configuração como /path/to/wikiconfig-dir/wikiconfig.py

Contents

  1. Utilizar o MoinMoin com o Twisted
    1. Instalar o Twisted
    2. Configurar o servidor Twisted
      1. Configuração do caminho de sistema
      2. Opções de classe config
    3. Configurar o wikiconfig.py
    4. Iniciar o servidor
      1. em Unix
      2. em Windows

Instalar o Twisted

Primeiro, instale o Twisted (ver URL em baixo). Muitas distribuições de Linux têm pacotes do Twisted. Para mais informações sobre a instalação, consulte a documentação do Twisted.

Configurar o servidor Twisted

Copie o ficheiro wiki/server/mointwisted.py para a sua directoria do wiki. Edite e adapte as definições às suas necessidades.

Configuração do caminho de sistema

Se efectuou a instalação standard e não é um programador, salte esta secção. Caso contrário, adicione o caminho para o moin e para o ficheiro config, assim: 

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

Opções de classe config

Se efectuou uma instalação standard, as opções por omissão são suficientes. Verifique e altere o que quiser:

Opção

Por Omissão

Comentário

docs

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

Caminho para os ficheiros partilhados do moin

user

'www-data'

Se executar como root, o servidor irá executar como este utilizador

group

'www-data'

Se executar como, o servidor irá executar como este grupo

port

8080

Porto para receber. Para receber um porto privilegiado abaixo de 1024 terá de executar como root

interfaces

['']

Uma lista de interfaces que o servidor prestará atenção. Se a lista contiver a entrada '' (como para a configuração por omissão), todas as outras entradas são ignoradas e o servidor prestará atenção a todas as interfaces.

logPath

'mointwisted.log'

Ficheiro de acessos.

profiler

commented python code

Útil apenas se for um programador do moin.

Configurar o wikiconfig.py

O ficheiro config de exemplo deve ser suficiente.

Não altere o url_prefix_static uma vez que o valor por omissão se encontra codificado no servidor Twisted.

Iniciar o servidor

em Unix

Em GNU/Linux, Mac OS X ou outro sistema operativo do tipo POSIX, copie o wiki/server/mointwisted para a sua directoria wiki. Adapte o PYTHONPATH e o caminho para twistd.

Inicie o servidor com o ./mointwisted start e teste o seu wiki em http://localhost:8080/. Pare o servidor com o ./mointwisted stop.

Para mais opções, execute o ./mointwisted sem argumentos.

Se quiser iniciar o servidor através de initscript certifique-se que o mointwisted encontra o montwisted.py no arranque!

em Windows

Copie o wiki/server/mointwisted.cmd para a sua directoria wiki. Altere o caminho para apontar para a directoria python-scripts.

Clique duas vezes em mointwisted.cmd para iniciar o servidor. Isto irá criar um nova janela do terminal. Para parar o servidor, feche a janela do terminal.