KernelNewbiesRU:

Índice

Contents

  1. Perguntas "O que é um Wiki?"
    1. O que é um ''Wiki''?
    2. Para que serve?
    3. Quais as maiores funcionalidades de um Wiki?
    4. E relativamente à segurança do Wiki? Um Wiki não está sujeito a ser eliminado ou sabotado?
  2. Perguntas sobre o MoinMoin em geral
    1. Se o MediaWiki é mais conhecido e desenvolvido em PHP, porque se deve preferir o MoinMoin?
    2. Quais os prós e contras de utilizar o MediaWiki ou o MoinMoin?
    3. Quero que algumas páginas e sub-páginas não sejam legíveis para todos. O MoinMoin pode fazê-lo?
  3. Perguntas sobre a utilização deste Wiki
    1. Pesquisar e aceder a dados no Wiki
      1. Como posso pesquisar no wiki?
      2. Como vejo o que foi feito recentemente no wiki?
      3. Como vejo as AlteraçõesRecentes anteriores ao que me é exibido por omissão?
      4. O que são estas ligações esquisitas e coloridas de forma diferente, que eu encontro em todo o lado?
      5. Como aceder à sua página principal?
    2. Editar no wiki
      1. Como posso adicionar dados ao wiki, ou alterá-los quando algo está incorrecto?
      2. Existem algum procedimento a seguir para adicionar dados?
      3. Como posso adicionar dados sem ser em texto ao Wiki?
      4. Como posso colorir o meu texto?
      5. Como posso evitar o uso de <<BR>> e utilizar caracteres de nova linha normais como alternativa?
      6. Como posso adicionar uma imagem a uma página?
      7. Como posso criar uma nova página de modelo?
      8. Adicionar documentos numa intranet
      9. Devo ''assinar'' as minhas alterações?
      10. Se eu eliminar registos em páginas e outra pessoa as achar necessárias? São eliminiados completamente?
    3. Adicionar outros formatos de documentos ao wiki
      1. Posso adicionar HTML ao wiki?
    4. Criar ligações no wiki
      1. Como posso criar ligações para algo externo ao meu wiki, como um html uma tag?
  4. Instalação e Configuração
    1. Como posso activar a opção "EliminarPágina" / "RenomearPágina"?
    2. Como altero a página inicial?
    3. Protecção contra sobrecargas
  5. Gerir o Wiki
    1. Como posso gerir o wiki?
    2. Como elimino um utilizador?
    3. Posso repor uma página a partir de uma versão anterior?
    4. Como actualizo o meu wiki?
  6. Ajuda no desenvolvimento
    1. Por onde começar como programador?
    2. Por onde começar como designer ou tradutor?
    3. Diagnóstico do MoinMoin

Perguntas "O que é um Wiki?"

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.

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.

Quais as maiores funcionalidades de um Wiki?

Eis algumas funcionalidades importantes do wiki:

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

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

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

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

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

Pesquisar e aceder a dados no Wiki

Como posso pesquisar no wiki?

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

Como vejo o que foi feito recentemente no wiki?

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

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

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

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.

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.

Editar no wiki

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.

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.

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:

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

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.

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.

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:

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

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

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.

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.

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.

Adicionar outros formatos de documentos ao wiki

Posso adicionar HTML ao wiki?

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

Criar ligações no wiki

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

Instalação e Configuração

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

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.

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

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.

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

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

Como actualizo o meu wiki?

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

Ajuda no desenvolvimento

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

Por onde começar como designer ou tradutor?

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

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.