##master-page:HelpTemplate
##master-date:Unknown-Date
#format wiki
#language pt

= Utilizar o MoinMoin com o Twisted =

O [[http://twistedmatrix.com/trac/wiki|Twisted]] é uma framework de trabalho em rede orientada a eventos para vários tipos de aplicações.
Para o [[WikiMoinMoin|MoinMoin]], o Twisted é utilizado como um servidro web que importa persistentemente o [[WikiMoinMoin|MoinMoin]]. Isto tem a vantagem que o interpretador de Python e todos os scripts de Python (incluindo o próprio Twisted e o [[WikiMoinMoin|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 [[WikiMoinMoin|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:

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

<<TableOfContents>>

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