De kk2011

PmWikiPtBr: Filosofia do PmWiki

Esta página descreve alguns dos conceitos que servem como guia para o design e implementação do Pm Wiki. Patrick Michaud não atesta que qualquer coisa listada abaixo seja uma idéia original; estas são apenas algumas diretrizes que impulsionam o desenvolvimento do Pm Wiki. Sinta-se à vontade para expressar descordo com qualquer item listado abaixo. Audiences (en) também descreve muitas das razões por trás das idéias expostas abaixo.

1. Favorece mais aos escritores do que aos leitores
Na sua essência, o Pm Wiki é um sistema autoral colaborativo para documentos com links de hipertexto. É difícil o bastante conseguir com que as pessoas (inclusive o Pm) contribuam com material escrito; fazer com que autores lidem com marcação HTML e links colocam mais obstáculos para uma contribuição ativa. Então, o Pm Wiki almeja facilitar a criação de documentos, mesmo que fazendo desta forma limite os tipos de documentos criados.
2. Não tente substituir o HTML
O Pm Wiki não faz qualquer tentativa para fazer tudo que pode ser feito em HTML. Existem boas razões porque as pessoas não usam web browsers para editar HTML - não é muito eficaz. Se você precisa escrever códigos em HTML com muito estilo, então o Pm Wiki não é o que você deve usar para criá-los. O que o Pm Wiki tenta fazer é facilitar a ligação de um documento Pm Wiki a outro documento "não-wiki" da web, inserir páginas Pm Wiki dentro de páginas complexas da web, e permitir que outros documentos da web se liguem facilmente ao Pm Wiki.
Este princípio também parte do princípio acima “Favorece mais aos escritores do que aos leitores”—cada nova função acrescida ao Pm Wiki requer algum tipo de marcação adicional para apóia-la. Logo o documento fonte se tornaria bastante complicado, o que seria melhor para todos se apenas usássemos HTML.
Outra razão para se evitar HTML arbritrário é que HTML mal formatado pode fazer com que as páginas parem de funcionar completamente, e HTML arbitrário pode apresentar um risco de segurança a mais, maior ainda quando as páginas podem ser criadas anonimamente. Visite http://www.cert.org/advisories/CA-2000-02.html para mais informações.
3. Evite funções gratuitas (ou “funções em excesso”)
Em geral as funções do Pm Wiki são implementadas em resposta a necessidades específicas, ao invés de alguém identificar algo que “possa ser útil”. Em todo tipo de sistema útil, é difícil mudar uma função mal desenhada uma vez que as pessoas construíram uma estrutura grande baseada nela. (Precisa de um exemplo? Veja o do MS-DOS ou Windows.) Uma maneira de evitar um desenho ruim é resistir a tentação de implementar algo até que se tenha uma idéia clara de como isto será utilizado.
4. Suporta manutenção colaborativa de páginas da web
Apesar desta não ter sido a intenção original do Pm Wiki, se tornou óbvio rapidamente que os princípios do WikiWikiWeb poderiam ser usados para facilitar a colaboração de grupos no desenho e manutenção da presença pública de um site. O Pm Wiki permite que páginas individuais possam ser protegidas por senha, e um conjunto de personalizações facilitam a proteção de grandes sessões de páginas do Pm Wiki. Alem do mais, em muitos casos o Pm Wiki oferece “páginas de estilo turbinadas”. Você pode mudar o cabeçalho, rodapé, e outros elementos em um grupo grande de páginas sem nunca ter que precisar tocar o conteúdo individual das páginas. Para terminar, é relativamente fácil acrescentar marcação personalizada (en) para aplicações especializadas.
5. É fácil de se instalar, configurar, e manter
Com um arquivo compactado gzip de tamanho aproximado de 200k, subir Pm Wiki para o seu servidor é uma operação rápida. Dê um comando chmod ou dois, atualize algumas configurações em config.php e você deverá estar pronto para rodar. Pm Wiki armazena todos os dados em arquivos únicos, então não há a necessidade do MySQL ou outros utilitários. Atualizar é geralmente uma simples questão de copiar a última versão por cima dos arquivos da sua instalação existente do Pmwiki.

<< | Documentação | >>

Originário de http://kk2011.confabulando.org/index.php/PmWikiPtBr/PmWikiPhilosophy
Pagina modificada em 11 de March de 2010, às 22h54