O que você vai aprender

Instalar e remover add-ons com segurança
Conhecer os add-ons mais úteis e o que cada um resolve
Entender a estrutura de um add-on
Empacotar seus próprios scripts como add-on

Antes de começar

Scripting em Groovy

Add-ons🔗

Um add-on é um pacote que estende o Freeplane: scripts, itens de menu, estilos, ícones, modelos e traduções, tudo num arquivo .addon.mm — que é, ele próprio, um mapa Freeplane.

Essa escolha de formato é elegante: para inspecionar um add-on antes de instalar, basta abri-lo como mapa e ler.

Instalando🔗

Ferramentas → Add-ons abre o gerenciador. De lá você pode instalar a partir de um arquivo baixado ou navegar pelos disponíveis.

O caminho manual: baixe o .addon.mm, abra-o no Freeplane, e um botão de instalação aparece no próprio mapa.

Depois de instalar, reinicie. Vários add-ons só registram seus menus na inicialização.

⚠

Add-ons rodam código com as permissões que você concedeu ao scripting. Instale apenas de fontes que você reconhece — o site oficial e o wiki do Freeplane são as referências.

Add-ons que valem a pena🔗

Add-on	O que faz
Presentation / Slides	Vistas nomeadas do mapa para apresentar em sequência
SVG export melhorado	Exportação vetorial com mais controle
Mind Map Diff	Compara dois mapas e mostra o que mudou
Formula Editor	Editor decente para fórmulas longas, com destaque de sintaxe
LaTeX	Renderiza fórmulas matemáticas nos nós
Scripting API help	Documentação da API como mapa navegável
Auto numbering	Numeração hierárquica automática dos nós
Task management	Campos de tarefa, prazos e vistas de andamento
Encrypted node	Ferramentas de nó criptografado

A disponibilidade varia com a versão. O gerenciador de add-ons mostra a compatibilidade antes de instalar, e um add-on feito para 1.8 pode simplesmente não funcionar em 1.11.

Atualizando e removendo🔗

O gerenciador lista o que está instalado, com versão. Remover é um clique — mas atenção: mapas que usam recursos de um add-on removido podem perder informação. Um mapa com slides do add-on de apresentação continua abrindo, só que os slides deixam de funcionar.

Antes de remover, verifique se algum mapa depende do add-on.

Por dentro de um add-on🔗

Abra um .addon.mm como mapa comum e você verá a estrutura:

Nome do add-on
├── description        (texto de apresentação)
├── version            (número da versão)
├── freeplaneVersionFrom / To  (compatibilidade)
├── author, homepage
├── scripts            (os .groovy, um por nó)
├── zips               (arquivos binários embutidos em base64)
├── preferences.xml    (opções que aparecem nas preferências)
├── translations       (strings por idioma)
└── images             (ícones do add-on)

Cada script vira um item de menu, com metadados nos atributos do nó: onde aparece no menu, atalho de teclado, modo de execução e permissões exigidas.

Ler o scripts de um add-on é a melhor escola de scripting Freeplane que existe.

Criando o seu🔗

Se você escreveu scripts que quer distribuir — ou só levar entre computadores — empacote-os:

Instale o add-on Add-on Packager (ou baixe o modelo de add-on do wiki).
Ele cria um mapa com a estrutura acima.
Preencha nome, versão, autor e compatibilidade.
Cole cada script num nó sob scripts, com os atributos de menu e permissão.
Rode o comando de empacotamento, que gera o .addon.mm final.
Teste instalando numa instalação limpa.

Vale mesmo para uso pessoal: um add-on próprio com seus dez scripts é instalado numa máquina nova em trinta segundos, contra copiar arquivos e reconfigurar atalhos um a um.

Onde encontrar🔗

freeplane.org, seção de add-ons — a lista oficial.
O wiki do Freeplane, com add-ons da comunidade e scripts avulsos.
O SourceForge do projeto, onde ficam os lançamentos.

Desconfie de add-ons distribuídos fora desses canais.

Erros comuns

Instalar add-on incompatível e não entender por que o menu não aparece — confira a versão
Esquecer de reiniciar depois de instalar
Remover um add-on de que mapas antigos dependem
Instalar de fonte desconhecida com permissões amplas de script habilitadas

Na prática🔗

Abra Ferramentas → Add-ons e anote o que já está instalado.
Baixe o add-on de ajuda da API de scripting e instale.
Reinicie e navegue pelo mapa de documentação que ele instala.
Abra o arquivo .addon.mm como mapa comum e leia a estrutura.
Localize um script dentro dele e entenda o que faz.

Add-ons