Ícone🔗

Definição. Pequena imagem associada a um nó e exibida à esquerda do texto. Um nó pode ter vários, na ordem em que foram adicionados.

Por que ícones e não cores🔗

Ícones são dados consultáveis. Filtros, fórmulas, scripts e estilos condicionais alcançam a lista de ícones de um nó. Uma cor de fundo, para todos esses mecanismos, é praticamente invisível.

A regra prática: registre com ícone, formate com estilo condicional. Você marca o fato, o programa cuida da aparência.

No arquivo🔗

<node TEXT="Aprovar orçamento">
  <icon BUILTIN="button_cancel"/>
  <icon BUILTIN="full-1"/>
</node>

O BUILTIN é o nome interno, que é o que fórmulas e scripts usam. Alguns dos mais comuns:

Nome interno	Ícone
`button_ok`	Check verde
`button_cancel`	X vermelho
`help`	Interrogação
`messagebox_warning`	Exclamação
`idea`	Lâmpada
`full-1` … `full-9`	Números 1 a 9
`0%`, `25%`, `50%`, `75%`, `100%`	Progresso
`calendar`	Calendário
`clock`	Relógio
`flag`	Bandeira
`stop-sign`	Placa de pare
`password`	Cadeado
`attach`	Clipe

A lista completa aparece no diálogo de filtro por ícone e na ajuda da API de scripting.

Ícones automáticos🔗

Alguns aparecem sem que você os coloque, e desaparecem sozinhos:

Nota — o nó tem uma nota.
Link — o nó tem um hiperlink.
Lembrete — há um lembrete com data.
Cadeado — o nó está criptografado.
Fórmula — em algumas configurações, indica nó calculado.

Não os inclua na sua convenção: eles são estado do programa, não seu.

O ícone de progresso🔗

0% a 100% em faixas de 25% marcam andamento. Combinados com Formatar → Progresso, o Freeplane calcula o valor de um nó pai a partir dos filhos, o que dá barras de andamento hierárquicas sem nenhum script.

Ícones do usuário🔗

Arquivos PNG colocados em:

~/.config/freeplane/1.11.x/icons/          # Linux
%APPDATA%\Freeplane\1.11.x\icons\          # Windows

aparecem no painel após reiniciar. Tamanho recomendado 16×16 ou 24×24, com transparência.

Eles não viajam com o .mm. Um mapa que usa ícones próprios, aberto noutra máquina, mostra um espaço vazio. Para distribuir, empacote os ícones num add-on.

Convenção🔗

Cinco ou seis ícones, com significado fixo, documentados num ramo Legenda dentro do próprio mapa. Mais que isso e ninguém lembra; menos e não se distingue nada.

Um conjunto que funciona: bloqueado, concluído, dúvida, prioridade, prazo, delegado.

Erros comuns

Empilhar ícones num nó até nenhum significar nada
Usar o mesmo ícone com dois sentidos em ramos diferentes do mesmo mapa
Registrar estado por cor, o que torna o mapa bonito e não consultável
Não documentar a convenção — seis meses depois, você não lembra o que a chave significa

Perguntas para reflexão

Por que ícone é preferível a cor para registrar estado?
Como um estilo condicional transforma ícone em cor automaticamente?
Onde você documentaria a convenção de ícones de um mapa, e por quê?
Que problema aparece quando o mesmo ícone tem dois sentidos no mesmo mapa?

Ícone