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.