Procurar

Categorias

Posts recentes

Arquivo

Blog feeds

Bookmarks


Wiki-format - formatação sem TAGs
sábado, 28 de abril de 2007


Os termos wiki (pronunciado "wiquie" ou "uikie" no Alfabeto fonético internacional) e WikiWiki são utilizados para identificar um tipo específico de colecção de documentos em hipertexto ou o software colaborativo usado para criá-lo. [veja mais… ]

O texo acima foi retirado da wikipedia e diz, em outras palavras, que o termo "wiki" é utilizado para definir websites colaborativos como a própria wikipedia (wikipedia, livremente interpretado, significa "enciclopédia colaborativa") ou os aplicativos usados para gerar esses sites.

Definido o que é "wiki" vamos ao "wiki-format" ou "formato wiki". Juntamente com essa idéia de colaborativizar a internet, surgiu um problema: como gerar o HTML necessário para ser exibido quando um usuário leigo quiser criar ou editar algum conteúdo? Os editores de HTML online são coisa nova e poucos funcionam a contento… Surgiu a idéia de gerar a formatação HTML a partir de certas combinações de caracteres comuns como apóstrofos, acentos, vírgulas, etc.

Existe uma gama enorme de aplicativos (web-based e de desktop) para gerar e manter conteúdos participativos na internet (veja aqui alguns) e a quase totalidade deles trabalha com algum tipo de formatação wiki, embora os sinais escolhidos variem um pouco - mas poucos ou nenhum em javascript. Descobri por que precisei de um tradutor wiki para usar em um sistema de comentários que é parte de um outro projeto… bem, não importa. O fato é que não achei nada em javascript que pudesse utilizar, então resolvi escrever o meu próprio wiki<=>HTML translator. Para isso tive primeiro que pensar num vocabulário, nos símbolos que representariam cada tag e que tags seriam permitidas. Acabei me baseando naquele que conhecia um pouco melhor, o sistema usado no projeto Trac, um gerenciador de projetos de software, aliás muito maneiro.

O sistema que desenvolvi tem recursos limitados em relação ao wiki format do Trac citado acima, mas é bastante funcional e, por ser em javascript, permite editar conteúdos no próprio navegador, vizualizar e modificar quantas vezes quiser antes de enviar ao servidor.

As razões para adotar o wiki format são muitas:

  • A inserção de tags na página diretamente pelo visitante é um risco e deve ser evitado. Na medida em as tags inseridas são geradas automaticamente, esse risco desaparece.
  • O risco de um desastre estético na sua página reduz consideravelmente.
  • O wiki format, ao contrário dos editores WYSIWYG, força o usuário a criar um conteúdo semântico. O resultado pode ser um pouco mais pobre, mas estará 100% dentros dos padrões e com uma construção semanticamente correta.
  • O usuário leigo pode aprender alguns símbolos simples bem mais facilmente do que compreender o HTML e seu funcionamento a ponto de usá-lo.
  • Os editores de HTML online ainda deixam muito a desejar…

O wikitext.js também inclui um sisteminha bem legal para codificar a resposta de wiki2html() em ASCII e decodificar o ASCII na resposta de html2wiki(), se desejar. Além disso, há a opção de usar CSS para exibir o resultado de forma mais estética. Fiquei pensando em como fazer isso e achei que a forma mais fácil era simplesmente colocar o resultado HTML dentro de um div com um id definido (como "wiki"), dessa forma podemos formatar, por exemplo, todos os cabeçalhos criados (h1 a h4) com classes como as mostradas a seguir.

.wiki h1 { font-family:verdana; font-size:2.1em; }
.wiki h2 { font-family:verdana; font-size:1.8em; }
.wiki h3 { font-family:verdana; font-size:1.5em; }
.wiki h4 { font-family:verdana; font-size:1.2em; }

 

Baixe aqui o script e veja um glossário dos símbolos adotados.

Veja aqui um aplicativo muito legal do Aurélio, o cara das expressões regulares: http://txt2tags.sourceforge.net/pt/. Este é um aplicativo em Python para gerar vários formatos a partir de textos wiki-formatados.

Abraços a todos, Cau Guanabara

0 Comentários »

Feeds para os comentários nesse post:
TrackBack: http://cauguanabara.blogsome.com/2007/04/28/wiki-format-formatacao-sem-tags/trackback/

Nenhum comentário

Say something! »















Por favor digite o texto da imagem acima.

lamp! Mapa do site
Wiki-format - formatação sem TAGs