Externals são objetos ou primitivas construídas para serem utilizadas dentro do Pure Data, escritos em alguma linguagem de programação. Há vários motivos para se construir um external:
- A primitiva implementada exige recursos não disponíveis em oturos patches ou bibliotecas
- Desempenho do objeto
- Diversão
- Maior flexibilidade
O “Externals Howto”, escrito por Johannes Zmölnig, é um documento que descreve como construir um External utilizando algumas estruturas básicas da API disponível. Serve como um guia introdutório e de referência, mas não aborda com profundidade nenhum aspecto. Ele está disponível na língua inglesa e alemã em vários endereços como: http://pdstatic.iem.at/externals-HOWTO/. Este experimento relata a tradução deste documento para a língua portuguesa, mas se estenderá com anexos e informações adicionas oriundas do aprendizado da API e dos externals implementados pela equipe.
A tradução se dá a partir de um arquivo escrito na linguagem Latex e está publicado no endereço:
http://github.com/global/externals_howto/tree/master
ou pode ser obtido através do comando:
git clone git://github.com/global/externals_howto.git
É necessário ter o latex instalado e mais um conjunto de pacotes relacionados. No Debian instale o pacote tetex-extra que ele instalará o necessário. Após a instalação, você poderá gerar o pdf, ps ou html da seguinte forma, respectivamente:
make pt_br_ps
make pt_br_pdf
make pt_br_html
ou apenas make para gerar em todas as línguas.


