Brevemente irei começar a publicar documentação e código da minha framework e dos seus projectos associados. Para esse efeito tenho estado a experimentar alguns sistemas para suportar o site que quero colocar online. Wikis, principalmente.

Para quem quiser escolher um wiki php, com ou sem base-de-dados, este artigo pode ser interessante.

MediaWiki

Tenho muita experiência com o MediaWiki que já usei em vários ambientes, nomeadamente na última empresa em que trabalhei, onde onde organizei toda a actividade da equipa de desenvolvimento e seus vários projectos em torno de uma isntalação do mais famoso Wiki.

O MediaWiki sempre se portou muito bem e é respeitável em várias frentes. Para começar é robusto e fiável. Indispensável num ambiente profissional. Também o considero rápido (YMMV) e intuitivo. Acima de tudo é muito podereoso, principalmente se instalarmos alguns plugins, nomeadamente o SemanticMediaWiki que extende a semântica do sistema e o torna capaz de adicionar atributos aos items e definir tipos de relações possíveis (explicação curta e grossa para um assunto que merecia um ou mais posts só por si!).

Contudo, o MediaWiki não é fácil de personalizar. Está demasiado comprometido com a gestão de saber enciclopédico e não se adapta bem a outras ontologias, nomedamente a gestão do conhecimento num projecto de desenvolvimento: Ao mesmo tempo, implementa funcionalidades, como as páginas do utilizadores, que simplesmentes não me interessam e são difíceis de remover/ocultar. Além do mais o sistema de templating é algo complexo.

O MediaWiki mão deixará tão cedo de ser a minhaa escolha para Intranet onde o template ou as funcionalidades parasitas são menos relevantes. Mas neste caso procuro algo que possa partilhar com mais eficácia e segurança.

Trac

Da experiência que tenho como utilizador/colaborador do mundo open-source, o Trac é mesmo o software mais utilizado.

E provavelmente é mesmo o melhor: providencia uma interface para o Subversion, gestão de tickets e um wiki, all in one. Integrated Source Code Management & Project Management? Wow…

Porém está escrito em Python. O que só diz bem do Python claro, mas não deixa de ser uma barreira à entrada de muitos utilizadores que, como eu, estamos “limitados” ao PHP. No meu host tenho perl, asp e ruby. Mas não python. E nunca me passou pela cabeça instalar em casa.

Mas na verdade, não me importo muito de não usar o “melhor”. Pronto, só um pequeno Na verdade o meu projecto é ainda muito modesto e só agora verá a luz do dia. Assim, nothing to see here, move along…

Outros wikis

As listas de wikis são extensa e mesmo com a ajuda desta ferramenta onde é possível comparar as características de vários wikis, da última vez que fiz uma ronda a testar soluções passei horrores a ler installs.txt e a lutar com problemas das mais variadas ordens.

Desta vez decidi que o ideal seria acrescentar à minha anterior experiência alguns artigos de opinião, testemunhos de utilizadores de cada um dos sistemas.

À partida os meus requisitos estão bastante claros: tenho que o poder alojar em php5, tem que ter templating, controlo de acessos, sistema de plugins; tem que ser leve, rápido e usável; não deve impingir uma data de funcionalidades e “special pages”.

PmWiki

Acabei por ler vários artigos e forums onde o PmWiki é várias vezes apontado como um compromisso simpático: poderoso, simples de usar, mantido por uma comundiade activa.

O sistema é baseado num sitema de plugins (a que chamaram recipes - um nome bastante criativo, o pessoal do cake perdeu aqui uma oportunidade interessante de fazer mais uma piada) e é altamente personalizável, principalmente no que toca ao templating. Nesta lista de casos em que o PmWiki é usado ficamos impressionados pela falta de “espectacularidade” das instalações. No mínimo 90% são dignas de um “soooo 90’s”. Mas bastar-me-ía ver uma boa instalação para não cair no preconceito. Themeing é themeing se um consegue, desde que seja fácil e transparente, tudo é possível.

Nota: o PmWiki não usa base da dados e necessita que lhe seja dada autorização de escrita no servidor. Mas isso não é um problema… que servidor

Wiki as a Service

Para quem não tem alojamento próprio fica duas notas finais: 1) alojamento php é tão barato como meia dúzia de cafés por mês 2) se ainda não assim não quiserem embarcar nessa aventura, o serviço PbWiki oferece alojamento gratuito de wikis limitados a 10MB. Mas tem algumas features interessantes e muito bem integradas na interface.

Usar uma plataforma destas não é minimamente interessante para publicar a documentação de um projecto Open Source, mas não vou guardar este nome porque pode dar jeito em diversas situações, nomeadamente para publicar conteúdos temporários, por exemplo no caso de um grupo de trabalho informal ou no caso de uma formação.