Como lidar com os erros comuns
Em primeiro lugar siga as instruções
O moin fornece as instruções para a utilização comum. Tente criar um wiki utilizando os valores por omissão das instruções. O seu wiki deve ser então guardado onde o seu está, e deve chamar-se mywiki ... mas pode alterar esse local, e este nome, DEPOIS de o wiki estar a funcionar. Os valores por omissão foram escolhidos cuidadosamente para funcionar para a maioria das pessoas na maior parte das plataformas, ou pelo menos ser um bom ponto de partida.
- Em primeiro lugar, siga as instruções
- Não altere nenhuma configuração a não ser que tenha mesmo de ser.
- Trabalhe com um wiki que funciona antes de o tentar personalizar.
Altere uma coisa de cada vez
Quando o seu wiki estiver a funcionar, personalize-o e adapte-o às suas necessidades, mas lembre-se de alterar apenas uma coisa de cada vez. Provavelmente não percebe como funcionam todas as opções completamente, e se estragar algumas coisas no mesmo passo, será mais difícil corrigi-las
Verifique se o ser servidor web pode utilizar Python
Isto encontra-se também em AjudaNaInstalação/InstalaçãoBásica. Utilize este script:
echo Content-Type: text/plain echo echo "Your web server is running as:" id echo "CGI scripts work" echo "Now we try to invoke Python interpreters and get their versions:" python -V 2>&1 python2.3 -V 2>&1 python2.4 -V 2>&1 python2.5 -V 2>&1 echo "Finished."
para ver se obtém a resposta de que o cgi funciona. Aí, saberá também quais as versões de python utilizáveis. Isto é especialmente útil para utilizadores sem acesso ao root.
Teste Built-in
Existe um modo de diagnóstico built-in útil ao fazer uma instalação; basta juntar "?action=test" ao URL do seu wiki:
lynx --dump http://`hostname`/mywiki?action=test
Se vir um erro de importação aqui, mas
python -c "import MoinMoin"
funciona, é provavelmente resultado de um permissões de ficheiro em falta ou uma definição incorrecta de PYTHONPATH no ambiente do servidor web.
Duelo de Pythons
O problema mais comum que pode encontrar é quando tem uma versão antiga de Python instalada no "/usr", e uma versão de distribuição de Python mais recente no "/usr/local"; isto é frequente nas distribuições de GNU/Linux, que ainda trazem uma versão antiga de Python.
Nesse caso, se escrever "python" na sua linha de comandos, obterá o interpretador de Python mais recente, porque o "/usr/local/bin" está no seu PATH. A situação é outra no ambiente do seu servidor web, e talvez tenha de alterar o caminho do "moin.cgi", assim:
"""
MoinMoin - CGI Driver Script
...
"""Ao instalar, certifique-se que instala o moin com a versão de Python com que quer executá-lo. O python setup.py install irá instalar com o primeiro python no caminho, que pode ser ou não a versão que espera! O /usr/local/bin/python2.4 irá instalar num python específico. Terá de utilizar o mesmo caminho no script do servidor do moin.
Permissões de ficheiro em falta
Se não for o root, os ficheiros instalados podem ser legíveis apenas pelo root, mas eles também precisam de ser legíveis pelo servidor web antes do wiki funcionar. Isto inclui os módulos Python e o próprio sítio. O servidor do wiki necessita também de permissões de escrita na directoria data. Para corrigir esta situação, é necessário descobrir onde está a directoria do módulo do Python; procure-a no install.log, ou execute o comando:
python -c "import sys; print '%s/lib/python%s/site-packages' % ( sys.prefix, sys.version[:3] )"
Para o exemplo em baixo, assumimos que a directoria do módulo do Python é /usr/local/lib/python2.3/site-packages. Torne os ficheiro legíveis a todos utilizando os seguintes comandos:
cd /usr/local chmod -R a+rX lib/python2.3/site-packages/MoinMoin
Defina as suas variáveis cuidadosamente
Tenha especial atenção se re-escrever em ver de cortar e colar. Os erros de citação no wikiconfig.py podem levar a que as coisas falhem. Os itens seguintes são também problemas com variáveis. Algumas funcionalidades funcionam apenas se forem activadas no wikiconfig.py ou farmconfig.py.
O moin.cgi foi encontrado, mas o Moin não funciona
Se tiver de adicionar a directoria do código do moin no caminho de sistema, especifique o local acima do próprio MoinMoin, para que a palavra MoinMoin seja reconhecida durante o pedido de importação.
Os ficheiros CSS não funcionam
Um erro muito comum é a falta de estilo CSS. O seu wiki parece feio e desinteressante, ao contrário deste belo wiki. Na maioria dos casos, estragou a configuração ao não ter lido as instruções, ou ao tentar personalizar as instruções, por ser mais esperto que nós. 
A correcção é muito simples: certifique-se que o seu Alias de Apache e o ScriptAlias NÃO são iguais. Esta configuração de Apache nunca funcionará:
Alias /wiki/ "/prefix/share/moin/htdocs/" ScriptAlias /wiki/ "/var/www/wiki/moin.cgi"
O Alias é utilizado para fornecer ficheiros estáticos: css, imagens etc. O ScriptAlias é utilizado para esconder o moin.cgi do URL. Tem de utilizar valores diferentes! Pode utilizar o que quiser como ScriptAlias, ou como Alias, mas o Alias tem de corresponder à opção de configuração do url_prefix_static. Eis um exemplo que funciona (o valor por omissão):
# Apache config Alias /moin_static160/ "/prefix/share/moin/htdocs/"
# Wiki config
url_prefix_static = '/moin_static160'