adx - Um catálogo de endereços minimalista

Colaboração: Cesar Brod

Data de Publicação: 25 de outubro de 2013

Indo direto ao ponto, o adx é um catálogo de endereços que consiste em um arquivo XML (addressbook.xml) e uma folha de estilos (adx2html_phonelist.xsl) que transforma as informações do arquivo XML em um formato HTML que pode ser lido por qualquer navegador moderno.

Para começar a usar, você deve fazer o download dos arquivos compactados a partir da página do projeto. Uma vez descompactado, você terá os arquivos addressbook.xml, adx2html_phonelist.xsl e README.txt (este com instruções detalhadas de uso). Coloque os arquivos com as extensões xml e xsl dentro de uma pasta que seja conveniente para você e abra, com seu navegador preferido, o arquivo addressbook.xml. Você deve ver algo similar ao que encontra nesta página.

Edite seus endereços usando os modelos no arquivo addressbook.xml como exemplo.

  <contact>
   <forename>Cesar</forename>
   <surname>Brod</surname>
   <displayname>Brod</displayname>
   <phone use="home" type="mobile">+55 51 5555 5555</phone>
   <account type="Facebook">cesarbrod</account>
   <account type="twitter">cesarbrod</account>
   <account type="Google">cesar.brod</account> 
   <website display="">http://brodtec.com</website>
   <birthday>1963-09-18</birthday>
   <tag>Brod</tag>
   <tag>adx</tag>
   <tag>adx:frequency=high</tag>
   <tag>xfn:rel=me</tag>
   <comment>Autor do livro "Aprenda a Programar - a arte de ensinar o computador
   </comment>
  </contact>

Se você não tiver alguma informação sobre determinado contato, basta excluir a linha correspondente a ela. Em seu navegador, basta clicar no nome da pessoa ou empresa (definido pela tag <displayname>) que as informações sobre ela serão expandidas.

Como padrão, a folha de estilo adx2html_phonelist.xsl já exibirá um pequeno menu no topo da página que você vê no browser, incluindo um formulário de busca especialmente eficaz. Experimente fazer pequenas modificações neste arquivo começando, por exemplo, pela seguinte linha:

  <xsl:variable name="menu_opacity">0.9</xsl:variable><!-- possible values:
  [0.0 .. 1.0], e.g. 0.9 means opacity of menu pane of 90%. If you've problems
  with opacity set to "0" (omits all CSS opacity settings -->
  

Outros usos

1. Aprender XML e XSL
   O adx é especialmente útil para a aprendizagem do mecanismo de construção de páginas HTML a partir de arquivos XML e folhas de estilo. Uma rápida olhada nos arquivos que compõem o adx e algumas substituições textuais em um editor de textos simples permitirão a você, por exemplo, traduzi-lo integralmente para o português.
   O adx2html_phonelist.xsl é amplamente comentado, facilitando a descoberta dos vários componentes da página. Se você inseriu o contato que forneci como exemplo, acima, vai notar que ao clicar no nome Brod ele expandirá os ícones para meus perfis nas redes sociais. Eles estão em tons de cinza (grey, em inglês) uma busca por "grey" no arquivo permitirá a você a descoberta da seguinte linha:

     <xsl:variable name="accountIcons_colorStyle">grey</xsl:variable><!-- possible values: grey, color -->
   

   Pesquisando mais um pouco, você verá como estes ícones são armazenados no arquivo XSL:

     	.icon_facebook_grey { 
     		/* facebook16x16_grey.gif */
     		background-image: url(data:image/gif;base64,R0lGODlhEAAQAKIAAP///+7u74mOln+EjH6Di2lueGBmcQAAACH5BAEHAAcALAAAAAAQABAAAAM+eLrcOibKGYeiWN5MAgDRhnlfeGRGqZ2ZamJfDBqiFJD32846zNMs30RREBiPgs+xQEQelUbmAYKSWBzYRQIAOw==);
     	}
     	.icon_facebook_color, .icon_facebook_grey:hover { 
     		/* facebook16x16_color.gif */
     		background-image: url(data:image/gif;base64,R0lGODlhEAAQAKIAAP///+vu9G2EtGF5rGB4q0VinjtZmAAAACH5BAEHAAcALAAAAAAQABAAAAM+eLrcOibKGYeiWN5MAgDRhnlfeGRGqZ2ZamJfDBqiFJD32846zNMs30RREBiPgs+xQEQelUbmAYKSWBzYRQIAOw==);
     	}
   

   O Tumblr, por exemplo, não está contemplado entre as redes sociais do adx, mas experimente buscar, usando o formulário de pesquisa no Google, por exatamente estes termos (incluindo aspas): "data:image/gif;base64" tumblr
   Agora, com os resultados desta pesquisa e os elementos que já estão no arquivo XSL, você tem tudo o que precisa para incluir o Tumblr entre as redes sociais permitidas pelo adx.

2. Lista de contatos de uma empresa
   Nada impede que os arquivos do adx sejam expostos através da web, no mesmo servidor onde está a página de uma empresa. Uma pequena personalização da interface, usando Tags para departamentos da empresa e usando o útil formulário de contato pode facilitar - e muito! - a interação com clientes, fornecedores e colaboradores, inclusive - e porque não dizer, especialmente! - através das redes sociais. #ficaadica

3. Encontros de famílias, grupos de apoio e de interesses
   Imagine que bacana será distribuir, ao final de um encontro de família, de uma conferência sobre direitos humanos, transparência pública, ou de qualquer outro tipo, uma pendrive com os contatos dos participantes? Os arquivos do adx estão em formato texto, ocupam pouquíssimo espaço: qualquer pendrive bem baratinha ou aqueles CDs no formato de um cartão de visita podem acomodar milhares de contatos.

Tem mais uma ideia interessante para o uso do adx? Escreve aí nos comentários!

Cesar Brod é autor de Aprenda a programar - a arte de ensinar o computador.

Cesar Brod ministra cursos in-house adequados à necessidade de sua empresa, além de atuar como coach de equipes ágeis. Visite nosso portal para saber mais ou entre em contato diretamente com o autor para mais informações.