Codex

Esta página descreve alguns dos conceitos que servem como guia para o design e implementação do PmWiki. 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 PmWiki. Sinta-se à vontade para expressar desacordo com qualquer item listado abaixo. Audiências 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 PmWiki é 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 PmWiki 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 PmWiki 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 PmWiki não é o que você deve usar para criá-los. O que o PmWiki tenta fazer é facilitar a ligação de um documento PmWiki a outro documento "não-wiki" da web, inserir páginas PmWiki dentro de páginas complexas da web, e permitir que outros documentos da web se liguem facilmente ao PmWiki.
Este princípio também parte do princípio acima "Favorece mais aos escritores do que aos leitores"--cada nova função acrescida ao PmWiki 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 PmWiki 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 PmWiki, 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 PmWiki 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 PmWiki. Alem do mais, em muitos casos o PmWiki 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 PmWiki 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. PmWiki 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.

<< MailingLists | Índice da Documentação | Notas de Design >>


Essa é possivelmente a tradução do original em : PmWiki.PmWikiPhilosophy - Links de retorno
Essa tradução se encontra em : PmWikiPtBr.PmWikiPhilosophy - Links de retorno
Últimas modificações da tradução feitas em : 10 de setembro de 2011, às 17:01
Últimas modificações feitas no original em : 28 de junho de 2012, às 12:16