Índice

Perguntas "O que é um Wiki?"

1. O que é um ''Wiki''?

O termo Wiki é uma forma abreviada de SítioWebWikiWiki. Um Wiki ié uma colecção de páginas que podem ser editadas colaborativamente utilizando um navegador Web. São abertos, gratuitos/livres a todos para editarem como quiserem. O sistema cria ligações de referência cruzada entre as páginas automaticamente. Para mais informações, consulte o tópico SítioWebWikiWiki.

O MoinMoin é um programa wiki de python.

2. Para que serve?

É uma boa ferramenta independentemente do uso que lhe der. Comparando com fóruns e listas de correio, o WikiWiki permite-lhe a criação de conteúdo. Devido a isto, os Wikis têm menos ruído e mais informação. A informação é estruturada e é mais facilmente encontrada.

Pode instalar um wiki no seu sítio Web interno com muitas páginas, que descrevam vários projectos, arquitecturas, ideias, etc. para que outras pessoas comentem. Algumas páginas existem apenas e fornecem informação. Outras são um convite aberto à discussão e ao comentário. Pode instalar um wiki para uma simples base de dados de talentos.

No geral, um wiki é uma ferramenta de livre formato, cujo valor deriva da utilização que lhe é dada. Por exemplo, uma página num wiki pode servir o mesmo propósito do que um tópico de discussão. Pode utilizar uma página de wiki para trabalhar em cooperação num projecto.

Veja o tópico Histórias de Sucesso do MoinMoin para saber onde mais é utilizado.

3. Quais as maiores funcionalidades de um Wiki?

Eis algumas funcionalidades importantes do wiki:

• editável por qualquer pessoa - uma página wiki pode ser editada por qualquer pessoas com um navegador Web
• possibilidade de ver as alterações recentes
• possibilidade de pesquisar páginas (de várias formas)
• possibilidade de adicionar novas páginas de forma simples
• possibilidade de ver o histórico de alterações de um documento
• possibilidade de adicionar novos dados ou alterar dados já existentes

4. E relativamente à segurança do Wiki? Um Wiki não está sujeito a ser eliminado ou sabotado?

Esta é uma questão importante. Regra geral, os wikis costumavam NÃO ter segurança. (Isso mesmo!)

Para o MoinMoin esta situação mudou com a introdução de Listas de Controlo de Acesso. Veja o tópico AjudaComListasDeControloDeAcesso.

Mas, assumindo que não utiliza ACLs, existe a possibilidade de se destruir acidental/conscienciosamente, ou de se corromper as versões da página actual do wiki.

Existem duas formas de desvalorizar um wiki. Uma é através da eliminação, e a outra através da corrupção. Lidar com a eliminação não é muito difícil, porque existe um log de alteração (e cópias de segurança) de cada página e podem ser repostas com facilidade. Assim, quando se detectam páginas eliminadas ou muito conteúdo eliminado (o que deve ser rápido), as páginas podem ser repostas facilmente no bom estado anterior.

Com a corrupção explícita e intencional é mais difícil de lidar. Existe a possibilidade de alguém inserir dados incorrectos numa página, ou editar páginas para alterar intencionalmente os dados ficando incorrectos (por exemplo, podem mudar as atribuições de uma página para parecer que uma outra pessoa teceu um determinado comentário, ou alterar o conteúdo de um parágrafo, alterando o seu significado de forma prejudicial. Praticamente todos os sistemas cooperativos têm este problema. Na prática, a corrupção no wiki é extremamente rara e pode ser resolvida (se necessário) com a funcionalidade de avisos (para um editor fixo) quando novos dados forem submetidos.

Por outras palavras, a filosofia do wiki é a de lidar manualmente (o termo para isto é SoftSecurity) com os casos raros (excepções) de sabotadores, em vez de criar funcionalidades e overhead (ambas em implementação e utilização) para evitar os estragos provocados por um sabotador.

Perguntas sobre o MoinMoin em geral

1. Se o MediaWiki é mais conhecido e desenvolvido em PHP, porque se deve preferir o MoinMoin?

• Porque o MoinMoin é desenvolvido em Python (talvez não seja uma razão óbvia para todos, mas no final tudo se resume a isto).

• O MoinMoin suporta listas de controlo de acesso

• O MoinMoin é fácil de se expandir

• "O MediaWiki foi concebido em primeiro lugar para a Wikipedia e outros projectos da Wikimedia (e outros sítios de larga escala semelhantes, com pessoas que trabalham nos seus próprios servidores), em segundo lugar para pessoas que trabalham com dados dos nossos sítios em instâncias locais, e só depois, apenas incidentalmente a qualquer outra pessoa." Brion Vibber, desenvolvimento do MediaWiki

2. Quais os prós e contras de utilizar o MediaWiki ou o MoinMoin?

Veja o tópico Comparação de servidores Wiki.

3. Quero que algumas páginas e sub-páginas não sejam legíveis para todos. O MoinMoin pode fazê-lo?

Sim, o MoinMoin tem um bom sistema ACL que lhe permite dar controlo sobre páginas específicas a alguns grupos de utilizadores. Para mais informações, consulte o tópico AjudaComListasDeControloDeAcesso.

Perguntas sobre a utilização deste Wiki

1. Pesquisar e aceder a dados no Wiki

1.1. Como posso pesquisar no wiki?

Existem várias formas de pesquisar e/ou verificar o wiki:

• Utilizar a caixa de pesquisa ou a PesquisaDePáginas, onde pode pesquisar por palavras-chave no título, em todo o texto, com palavras normais ou com expressões regulares (wildcards).

• Clicar em ÍndiceDePáginas. Exibe uma lista ordenada alfabeticamente dos título das páginas.

• Clicar em ÍndiceDePalavras. Exibe uma lista ordenada alfabeticamente de todas as palavras de todos os títulos (ou seja, uma página com o título BlueTooth surge listada nas letras B / Blue e T / Tooth).

• Utilize a acção LikePages. Exibe páginas que contenham nos seus títulos palavras similares às do da página actual.

• Clique no título da página no topo da mesma. Exibe quais as páginas ligadas à página actual (que lhe permite encontrar páginas relacionadas).

1.2. Como vejo o que foi feito recentemente no wiki?

Clique na ligação das AlteraçõesRecentes no topo de cada página.

1.3. Como vejo as AlteraçõesRecentes anteriores ao que me é exibido por omissão?

Aceda e seleccione até ao máximo de 90 antes. É suficiente?

1.4. O que são estas ligações esquisitas e coloridas de forma diferente, que eu encontro em todo o lado?

Todos os nomes que contenham letras maiúsculas e minúsculas misturadas e que não tenham uma página correspondente, irão aparecer como uma ligação colorida de forma diferente.

1.5. Como aceder à sua página principal?

No tema por omissão, a ligação para a página principal do utilizador está no topo da página, junto à ligação PreferênciasDoUtilizador. No tema da barra lateral do lado direito, encontra-se debaixo da barra lateral "Utilizador". Terá de criar a página quando a visitar pela primeira vez. As páginas dos utilizadores são opcionais.

2. Editar no wiki

2.1. Como posso adicionar dados ao wiki, ou alterá-los quando algo está incorrecto?

Se encontrar algo que queira comentar, adicionar ou alterar, basta clicar na ligação EditText, ou clicar no ícone no topo da página. Essa página surgirá num painel de edição de texto no seu navegador, e poderá alterar o que quiser simplesmente. O formatador do wiki irá "tomar a decisão certa" relativamente ao texto que inserir. Se quiser dar asas à imaginação, poderá reproduzir a maioria dos mesmos tipos de formatação que o HTML lhe permite fazer. Para aceder a algumas dicas e exemplos, consulte o tópico AjudaNaFormatação.

2.2. Existem algum procedimento a seguir para adicionar dados?

Não muitas. Ajuda manter determinados tipos de dados formatados de uma forma consistente. Um procedimento importante que o pode ajudar com a consistência é utilizar as páginas "Modelo".

O wiki tem uma funcionalidade chamada "Modelos" que surgem ao criar uma nova página. Se clicar num deles ao criar uma nova página, a nova página terá uma estrutura similar a outras do mesmo tipo. Por exemplo, ao criar a sua página principal do Wiki, deve utilizar a página ModeloDePáginasPrincipais, que estará disponível quando criar uma nova página no wiki.

2.3. Como posso adicionar dados sem ser em texto ao Wiki?

Se o conteúdo já existir num sítio Web, basta adicionar uma ligação para a página do wiki. Siga estes passos:

• Obtenha o URL para o documento,

• Edite a página do Wiki (visite a página do Wiki e clique na ligação EditarTexto)

• Digite o URL onde quiser no documento
• Guarde as alterações.

O wiki criará automaticamente uma hiperligação a partir do texto digitado.

Pode "embelezar" a ligação, criando uma "capa" de palavras, entre parênteses rectos. A capa de palavras surgirá na página, mas a ligação guiará o utilizador para o URL ao clicar nela. Eis um exemplo:

  [http://o.seu.exemplo.de.dominio/foo.html Este será o texto da ligação]

resulta em:

Este será o texto da ligação

2.4. Como posso colorir o meu texto?

Numa tabela isto é possível por omissão. Caso contrário, a macro Color2, localizada no Mercado de Macros, tem de ser instalada.

2.5. Como posso evitar o uso de <<BR>> e utilizar caracteres de nova linha normais como alternativa?

Utilize { { { e } } } para envolver o seu texto pré-formatado num parágrafo pré-formatado.

2.6. Como posso adicionar uma imagem a uma página?

Pode adicionar um URL para a imagem na página. Exemplo:

http://c2.com/sig/inter/wikibase.gif

resulta em:

2.7. Como posso criar uma nova página de modelo?

Os modelos são páginas que surgem automaticamente como opções ao criar uma página em branco. Qualquer página que comece com a palavra Modelo (ver page_template_regex) irá aparecer automaticamente na lista. Se quiser que determinados tipos de páginas tenham uma formatação similar (cabeçalhos semelhantes, organização, etc.), defina uma página que comece com Modelo, e ao criar páginas deste tipo, seleccione esse modelo e edite-o. O wiki preenche o conteúdo inicial por si. Os modelos são páginas de wiki editáveis como quaisquer outras.

Para criar uma página de Modelo, basta criar uma nova página intitulada Modelo<QualquerCoisa>.

2.8. Adicionar documentos numa intranet

Se está a utilizar o MoinMoin numa intranet, talvez seja útil criar ligações para documentos em partilha de ficheiros, disponível aos que lêem o seu wiki. Por exemplo:

[file://///nomedoservidor/nomepartilhado/caminho/completo/para/ficheiro/nomedeficheiro.txt Clique aqui para ler nomedeficheiro.txt]

Pode também criar ligações para os ficheiros com espaços nos nomes dos ficheiros manualmente, inserindo a codificação do URL para espaços(%20):

[file://///nomedoservidor/nomepartilhado/caminho/completo/para/ficheiro/nome%20de%20ficheiro%20com%20espaços.txt Clique aqui para ler nome de ficheiro com espaços.txt]

Para mais informações, consulte o tópico Ligações a ficheiros.

Outra opção óbvia e possivelmente melhor, será utilizar a acção AttachFile.

2.9. Devo ''assinar'' as minhas alterações?

Se elas forem significativas, ou se deseja que as pessoas saibam que as fez, sim. Basta colocar @SIG@ depois do seu comentário. É comum criar um avanço no texto do comentário relativamente ao texto comentado. Para além disto, pode colocar o seu comentário em itálico para que se destaque do corpo principal da página que estiver a comentar.

No entanto, em alguns casos é mais apropriado fazer a alteração anonimamente. Corrigir ortografia, formatação, ou alterações triviais de palavras, são apenas alguns exemplos em que não é necessário (e é mesmo desaconselhado) assinar as suas alterações.

2.10. Se eu eliminar registos em páginas e outra pessoa as achar necessárias? São eliminiados completamente?

Se for preciso, pode repor as suas alterações. Veja o tópico PorQueWikiFunciona.

3. Adicionar outros formatos de documentos ao wiki

3.1. Posso adicionar HTML ao wiki?

• Tudo isto só funciona se as extensões de HTML inseguras (macro e parser HTML) estiverem instaladas.

Se quiser adicionar uma linha única de HTML, utilize a macro HTML. Faça-o colocando o seu texto de HTML como um parâmetro da macro HTML, assim:

[[HTML(<font size=+12>Esta é uma fonte grande</font>)]]

Isto surgirá na página como:

HTML(<font size=+12>Esta é uma fonte grande</font>)

É igualmente possível colocar um documento de HTML na página adicionando-lhe #format html na primeira linha. Se esta linha lá estiver, toda a página será interpretada como HTML (criar ligações para outras páginas torna-se um pouco mais difícil!) Certifique-se de que apenas adiciona a parte do corpo da página (ou seja, sem os cabeçalhos de HTML, ou qualquer outra coisa fora do corpo, incluindo a própria tag <BODY>).

4. Criar ligações no wiki

4.1. Como posso criar ligações para algo externo ao meu wiki, como um html uma tag?

• Utilize uma ligação de LigaçõesEntreWikis para outro wiki (por exemplo PáginaPrincipal devolve PáginaPrincipal)

• http://moin.sourceforge.net/ resulta em http://moin.sourceforge.net

• página do moin sourceforge fica como página do moin sourceforge

Instalação e Configuração

• Para obter ajuda geral sobre este tópico, consulte a página AjudaNaAdministração

1. Como posso activar a opção "EliminarPágina" / "RenomearPágina"?

Para ter permissão para eliminar ou renomear páginas, terá de aceder (através das PreferênciasDoUtilizador).

2. Como altero a página inicial?

Defina page_front_page = u'OutraPáginaInicial' no seu wikiconfig.py. Veja o tópico AjudaComIdiomas. O tópico AjudaNaConfiguração contém mais variáveis que talvez queira definir.

3. Protecção contra sobrecargas

O MoinMoin está protegido contra o uso abusivo. Se alterar páginas ou descarregar anexos com muita frequência, pode ver uma mensagem como esta: "Activou a protecção contra sobrecargas do wiki ao fazer muitos pedidos num curto espaço de tempo". Se quiser alterar este comportamento, terá de definir o surge_action_limits no seu ficheiro wikiconfig e alterar os valores por omissão. Os valores por omissão são:

surge_action_limits = { # permite no máximo <count> pedidos de <action> por <dt> segundos
        # action: (count, dt)
        'all': (30, 30),
        'show': (30, 60),
        'recall': (5, 60),
        'raw': (20, 40), # algumas pessoas utilizam isto para css
        'AttachFile': (90, 60),
        'diff': (30, 60),
        'fullsearch': (5, 60),
        'edit': (10, 120),
        'rss_rc': (1, 60),
        'default': (30, 60),
    }

Gerir o Wiki

1. Como posso gerir o wiki?

Encontrará muita informação sobre administração na página InformaçãoDeSistema, incluindo o número de páginas, e as macros e acções instaladas.

Pode configurar uma !AdminPage, onde pode colocar macros úteis, bem como dados sobre a localização física real das páginas, e macros para as páginas orfãs e outros aspectos que um administrador de wiki possa quer vigiar.

Para obter mais ajuda, consulte o tópico AjudaNaAdministração.

2. Como elimino um utilizador?

A melhor forma (desde a versão 1.5.2) é um Super Utilizador assumir a identidade do utilizador a ser eliminado, aceder às PreferênciasDoUtilizador, seleccionar "Desactivar esta conta para sempre" e clicar em "Guardar".

3. Posso repor uma página a partir de uma versão anterior?

1. Clique em Info (ou no ícone do "i" pequeno) no canto superior direito.

2. Clique na ligação revert da versão que deseja repor.

Para poder repor páginas, precisa de aceder (através das PreferênciasDoUtilizador).

4. Como actualizo o meu wiki?

Para obter ajuda sobre actualizações, consulte o tópico AjudaNaActualização.

Ajuda no desenvolvimento

1. Por onde começar como programador?

Se quiser ajudar a programar, pode fazê-lo ao:

1. Aprender Python, se ainda não souber trabalhar com esta linguagem: Guia para principiantes

2. Aprender o essencial sobre o MoinMoin na página de Desenvolvimento do Moin

2. Por onde começar como designer ou tradutor?

Se não for programador, mas quiser ajudar, pode fazê-lo relativamente a:

• Desenvolvimento do Moin/Temas - desenvolvimento de temas CSS e estrutura (X)HTML correspondente.

• Desenvolvimento do Moin/Tradução - tradução da interface e das páginas de ajuda

3. Diagnóstico do MoinMoin

Se pensa ter encontrado um erro ou um problema, pode fazer alguns testes. As verdadeiras falhas exibem-lhe uma página de erro. Deve guardar essa página, visitar a página Falhas do MoinMoin, verificar se encontra uma página semelhante e só depois criar uma página de nova falha, com o traceback anexado.

Pode testar o seu wiki ao adicionar ?action=test ao URL normal. Obtém uma página intitulada "Diagnóstico do MoinMoin" ("MoinMoin Diagnosis"), que lhe fornece muita informação. A grande maioria só faz sentido para os informáticos, mas se for um ou se for um geek de Python, talvez a ache útil.

Se as suas perguntas não foram respondidas nesta página, por favor, veja o tópico Perguntas sobre o MoinMoin.