| 
  • If you are citizen of an European Union member nation, you may not use this service unless you are at least 16 years old.

  • You already know Dokkio is an AI-powered assistant to organize & manage your digital files & messages. Very soon, Dokkio will support Outlook as well as One Drive. Check it out today!

View
 

dokuwiki

Page history last edited by PBworks 16 years, 8 months ago

Dokuwiki

Um wiki que usa web server mas não necessita de banco de dados,

neste link um manual do dokuwiki:

http://ubuntu.if.uff.br/wikidowiki/doku.php/tutorial:reconhecendoumwiki

 

Criando sites para intranet e trabalhos em equipe com o DokuWiki

Autor: Yves Junqueira Marques Teixeira

Data: 27/01/2005

Fonte: http://www.vivaolinux.com.br/artigos/impressora.php?codigo=2016

 

Definição segundo a wikipédia

DokuWiki é um programa wiki escrito em PHP voltado para as necessidades de documentação em pequenas empresas, escrito por Andreas Gohr. Usa para armazenar dados um arquivo de texto, não necessitando de um banco de dados. Possui uma sintaxe simples, porém completa, similar à usada na Wikipédia.

 

Apresentação do DokuWiki

 

Um software de Wiki é utilizado para fácil edição de páginas web - geralmente de forma colaborativa.

 

Sempre tive dificuldades em organizar minhas informações. Costumava anotar tudo em um caderno, mas era um meio de difícil acesso - caso eu não tivesse o caderno em mãos, não adiantava ter escrito tudo aquilo.

 

Tentei também guardar minhas anotações em uma conta de webmail grande, como o Gmail. Foi um grande passo, mas tudo ficava mal organizado, salvo como "Rascunho" na caixa, sem qualquer organização hierárquica ou possibilidade de links de um artigo para o outro.

 

Eis então que tive a idéia de anotar tudo em um wiki pessoal. Foi perfeito. Agora tudo está organizado, com referências entre páginas, é rápido fazer modificações e posso acessá-lo de qualquer lugar que tenha acesso à Internet. Além do mais, dá pra fazer backups com uma mão amarrada nas costas.

 

Um wiki é ambiente perfeito para "Brainstorm dumps". Melhor ainda, para "Brainstorm dumps" em equipe!

 

Assim dá pra entender por que páginas wiki estão sendo usadas por tanta gente. Trabalhos e documentações técnicas escritos em equipe são algumas das principais aplicações desses softwares.

 

Antes de escolher o DokuWiki, entretanto, como um geek dedicado eu baixei e testei diversos outros softwares de Wiki, incluindo:

 

* MediaWiki -> Complexo demais para um objetivo tão simples. Exige MySQL.

* TWiki -> Excelente! Poderoso e a instalação é fácil. No meu caso, entretanto, eu precisava de algo que rodasse em PHP, visto que o lugar em que eu iria hospedar só executa páginas PHP, e não Perl.

* MoinMoin -> Um pouco feio e roda em Python.

 

 

O DokuWiki, que é desenvolvido por um alemão chamado Andreas Gohr, superou as outras alternativas porque foi escrito em PHP - rodando no servidor em questão -, não exige banco de dados, a instalação é MUITO simples, é bonito e tem diversos recursos interessantes. Trata-se de um daqueles raros casos de software completo e poderoso mas com poucos requerimentos de ambiente.

 

Se quiser ver um exemplo, visite:

 

 

 

Bem, vou deixar de nhé-nhé-nhé e mostrar logo como se instala o DokuWiki.

 

 

Instalação: mamão com açúcar

 

Infelizmente ainda não há um pacote do DokuWiki pro Debian.

 

Ainda assim, a instalação é muito simples. Veja só:

 

Baixe a última versão do DokuWiki em:

 

 

 

Veja que na lista que aparece no lado direito, a versão mais nova é a mais de baixo e não a primeira!

 

$ cd /tmp

$ wget http://www.splitbrain.org/Programming/PHP/DokuWiki/dokuwiki-2004-11-10.tgz

$ tar zxvf dokuwiki*.tgz

$ mv dokuwiki-200* dokuwiki ; touch dokuwiki/changes.log

 

Se você for hospedar o dokuwiki em um servidor remoto em que você não tem acesso ao shell, ignore as próximas instruções. Posteriormente, após a configuração (na próxima página), você fará upload de tudo descompactado e já configurado, utilizando FTP ou outros métodos, de acordo com cada caso.

 

Ao invés disso, se for executá-lo localmente mesmo, em um diretório de acesso restrito, torne-se root:

 

$ su root

 

  1. mv dokuwiki /var/www/

(Substitua /var/www/ pelo diretório onde ficará o DokuWiki)

 

  1. chown www-data dokuwiki/data dokuwiki/attic dokuwiki/media dokuwiki/changes.log

 

  1. chmod o+rwx dokuwiki/data dokuwiki/attic dokuwiki/media dokuwiki/changes.log dokuwiki/conf/users.auth

 

Prontinho. Doeu?

 

Na próxima página iremos editar as configurações - processo rápido e indolor =].

 

 

Configuração (mais simples, impossível!)

 

A configuração do DokuWiki fica guardada no diretório "conf".

 

Se você quiser, mesmo sem configurar nada, o DokuWiki já está perfeito e pronto para uso. Basta sair editando os documentos, como em qualquer Wiki.

 

Na prática, o único arquivo que você deve precisar editar é o "conf/dokuwiki.php".

 

Entre as configurações que podem ser editadas ali incluem-se:

 

* $conf'lang' -> Linguagem da interface. Existe a opção "pt" que nos servirá muito bem, o pá!

* $conf'title' -> Título do wiki. Exemplo: "Sua Empresa", "Intranet do Time de Robôs da Alemanha"*, "Planejamento Pessoal", etc.

* $conf'start' -> O nome da página inicial. Exemplo: "Root", "Início", "Olá Mundo", etc.

* * - Baseado em fatos reais. Veja http://wiki.splitbrain.org/wiki:users, procure por "germanteam.org".

 

 

Não custa também citar que configurações avançadas são possíveis. Utilizando ACL (access control list) é possível determinar quem tem acesso a quais páginas. Além de habilitar o recurso de ACLs, mudando apropriadamente o valor de $conf'useacl' no "conf/dokuwiki.php", o restante do processo é feito editando-se diretamente o arquivo "conf/acl.auth".

 

É um recurso poderoso. Para mais informações veja o próprio arquivo, ou pergunte aqui através de um comentário.

 

Na próxima página, antes de concluir o artigo, apresentarei algumas dicas sobre como utilizar bem seu novo wiki.

 

 

Dicas de uso e conclusão

 

Backup

 

Um dos pontos fortes do DokuWiki é que ele guarda os dados em formato texto.

 

Assim, é muito simples fazer backup dos dados importantes e editar páginas em massa através de simples scripts shell.

 

Para fazer um backup simples das páginas, basta pegar todo o conteúdo do diretório "data/", incluindo os subdiretórios.

 

Aliás, são nestes subdiretórios do "data/" que ficam os "namespaces" do dokuwiki. Este é um recurso importante que merece destaque.

 

Namespaces

 

É possível organizar as páginas do DokuWiki em categorias, chamadas de "namespace" (espaço de nomes). Para categorizar uma página, basta criá-la com um nome que siga o padrão "categoria:página".

 

Essas categorias são úteis não só para organizar as informações. Ao se categorizar uma página, é possível impedir ou permitir o acesso aos documentos da categoria por parte de determinado grupo de usuários, utilizando ACLs.

 

Gerenciamento de usuários

 

Outro ítem importante é o gerenciamento de usuários. Há poucos recursos de interface para o gerenciamento dos usuários na versão atual. É possível apenas registrar um novo usuário, cuja senha será enviada por e-mail. Não é possível, de dentro do próprio dokuwiki, mudar senhas ou apagar usuários.

 

O segredo está em conhecer o arquivo "conf/users.auth".

 

O formato do arquivo é simples. Se quiser mudar a senha, basta inserir na segunda coluna o hash MD5 da senha que você escolher.

 

Por exemplo, se você quiser usar a senha "mamãe" para seu usuário, utilize o resultado do seguinte comando:

 

$ echo -n "mamãe" | md5sum

 

Comandos personalizados

 

Há uma outra possibilidade muito interessante no Dokuwiki. Podemos criar nossos próprias substituições de código para as páginas, facilitando muito a vida de quem insere determinadas expressões muito regularmente.

 

Eu, por exemplo, no meu wiki pessoal, marco com um "V" (um "check mark") as tarefas já concluídas. Sempre tinha que ficar repetindo o código "{{http://img49.exs.cx/img49/8576/check2zw.jpg}}" para incluir essa imagem. Pra simplificar, bastou editar o conf/custom.conf e inserir a seguinte linha:

 

/\{check\}/i ''

 

Agora, durante a edição de um artigo, usar {check} terá o efeito desejado. Bem mais fácil de lembrar do que toda aquela URL.

 

Pra finalizar, devo lembrar que bugs e atualizações de segurança podem ser relatados ou verificados em:

 

 

 

Para ser notificado sobre novas versões do DokuWiki, assine a lista do pacote na freshmeat:

 

 

 

No mais, agora é se concentrar no conteúdo do wiki - e manter o software atualizado.

 

Espero que este meu primeiro artigo tenha sido útil =]

 

Um abraço,

 

Yves Junqueira - http://www.yvesjunqueira.com

http://www.vivaolinux.com.br/artigos/verArtigo.php?codigo=2016

 

Referências

Comments (0)

You don't have permission to comment on this page.