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.

$/!\$ Primeiro faça uma ../InstalaçãoBásica e uma ../CriaçãoDeInstânciasDoWiki.

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

o script /path/to/cgi-dir/mointwisted (ver tópico "Iniciar o servidor" em baixo)
o ficheiro do script do servidor web como mointwisted.py (que necessita de estar na mesma directoria que a sua directoria working).
o ficheiro de configuração como /path/to/wikiconfig-dir/wikiconfig.py

Contents

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

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

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

2.1. 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')

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

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

4. Iniciar o servidor

4.1. 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!

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