Add-ons🔗

Definição. Pacote de extensão do Freeplane distribuído como um mapa .addon.mm, contendo scripts, itens de menu, estilos, ícones, modelos e traduções.

O verbete add-on aparece também no glossário consolidado do guia.

Estrutura interna🔗

Um .addon.mm é um mapa comum, com estrutura convencionada:

Nome do add-on
├── description
├── version
├── author
├── homepage
├── freeplaneVersionFrom
├── freeplaneVersionTo
├── preferences.xml
├── deinstall
├── scripts
│   └── NomeDoScript
│       ├── [menuLocation]
│       ├── [menuTitleKey]
│       ├── [keyboardShortcut]
│       ├── [executionMode]
│       └── [permissions]
├── zips
├── images
└── translations

Como é um mapa, você pode abri-lo e inspecioná-lo antes de instalar. Ler a seção scripts de um add-on é a melhor forma de aprender scripting Freeplane.

Instalação🔗

Ferramentas → Add-ons — gerenciador com instalação, atualização e remoção.
Ou abrir o .addon.mm diretamente; um botão de instalação aparece no próprio mapa.

Reinicie depois. Muitos add-ons só registram menus na inicialização.

Compatibilidade🔗

freeplaneVersionFrom e freeplaneVersionTo declaram a faixa suportada. Um add-on feito para 1.8 frequentemente não funciona em 1.11 — a API muda.

Sintoma típico de incompatibilidade: o add-on instala sem erro e nenhum menu aparece.

Remoção🔗

O gerenciador remove. O nó deinstall do add-on descreve o que desfazer.

Cuidado: mapas que usam recursos de um add-on removido perdem funcionalidade. Um mapa com slides do add-on de apresentação continua abrindo, mas os slides param de funcionar. Verifique antes.

Add-ons de referência🔗

Add-on	Função
Presentation / Slides	Vistas nomeadas para apresentar
Mind Map Diff	Compara dois mapas
Scripting API help	Documentação da API como mapa
Formula Editor	Editor com destaque de sintaxe para fórmulas
LaTeX	Suporte ampliado a matemática
Auto numbering	Numeração hierárquica automática
Task management	Campos de tarefa e vistas de andamento
Add-on Packager	Empacota seus scripts como add-on

Disponibilidade e nomes variam com a versão; consulte o gerenciador.

Segurança🔗

Add-ons executam código Groovy com as permissões que você concedeu ao scripting. Um add-on malicioso pode ler e escrever arquivos, executar programas e acessar a rede.

Instale apenas do site oficial (freeplane.org), do wiki do projeto ou do SourceForge oficial. Antes de instalar de outra fonte, abra o .addon.mm e leia os scripts — o formato foi feito para permitir exatamente isso.

Criando o seu🔗

O Add-on Packager gera o esqueleto. Preencha metadados, cole os scripts nos nós correspondentes, defina permissões e local de menu, e empacote.

Vale mesmo para uso pessoal: um add-on com seus dez scripts se instala numa máquina nova em segundos, contra copiar arquivos e reconfigurar atalhos um a um.

Erros comuns

Instalar sem conferir freeplaneVersionFrom/To e não entender por que o menu não aparece
Instalar de fonte desconhecida com permissões amplas de script habilitadas
Remover um add-on de que mapas antigos dependem — as funções somem, os mapas ficam
Esquecer de reiniciar o Freeplane depois de instalar

Perguntas para reflexão

Que propriedade de segurança você ganha por o add-on ser um mapa?
Onde ficam declaradas as versões compatíveis, e o que acontece se ignorá-las?
Por que ler a seção scripts de um add-on é um bom exercício de aprendizado?
O que acontece com um mapa que usa um add-on removido?

Add-ons