Transformações de texto salvas

Uma transformação é um pequeno conjunto de regras de busca e substituição que você salva para aplicar quando quiser: limpar texto colado, ordenar uma lista, remover espaços no fim das linhas ou delimitar um bloco de código. Você escolhe uma transformação no menu Format, confere as alterações propostas e decide se deseja aplicá-las.

A descrição em Settings explica: "Regras salvas de busca e substituição e algumas operações de texto integradas. Elas não são scripts: Varlig nunca executa comandos de shell, plug-ins ou solicitações de rede para aplicá-las, nem aplica uma transformação por conta própria — seja ao importar, colar ou abrir uma nota. Você escolhe uma em Format ▸ Transformations e confere as alterações antes de aplicar qualquer coisa."

Onde ficam

A lista fica em Settings › Editor › Text Transformations e começa vazia. Até você adicionar uma transformação, Format › Transformations mostra No Transformations, e nenhuma transformação é executada.

Add Transformation cria uma transformação chamada Transformation, com uma única regra Find and Replace. Cada transformação contém:

Cada linha da lista também tem um botão para duplicá-la e um para excluí-la.

Uma transformação que não está concluída — sem nome, sem regras ou um padrão que não compila — é sinalizada em Configurações com o motivo e deixada de fora de Format › Transformations até que você a conserte.

As transformações de texto salvas seguem pelo iCloud entre Mac, iPhone e iPad. No Mac, ative Sync notes with iCloud. Cada dispositivo mantém uma cópia local nas preferências, por isso as transformações funcionam offline; elas não fazem parte das exportações de notas nem dos backups da biblioteca.

As regras

As regras são executadas em ordem, cada uma no resultado da última. Não há condições e nem ramificação.

Uma regra é uma lista de valores, nunca código. Expressões regulares são compiladas e verificadas pelo mesmo mecanismo que Edit › Find and Replace (Advanced)…, e um padrão que não compila é sinalizado em Configurações antes mesmo de você aplicá-lo.

Aplicar uma transformação

No Mac, execute uma transformação em Format › Transformations › name. No iPhone e iPad, use o menu Transformations do editor. Transformações não têm atalho de teclado e nunca são executadas automaticamente ao abrir uma nota, importar, colar ou deixar o app em segundo plano.

Quando Applies to está definido como Selection, selecione o texto primeiro. Com Whole Note, as regras se aplicam à nota inteira.

Varlig executa as regras em uma cópia e abre uma janela de prévia com as listas Removes 4 lines e Inserts 4 lines. Elas mostram apenas os trechos que realmente mudam, limitados a 40 linhas em cada lado, com um aviso quando há mais. O rodapé informa: "A aplicação pode ser desfeita em uma única etapa. Nada muda até você pressionar Apply." Cancel mantém a nota intacta; Apply aplica a alteração como uma única edição, que Edit › Undo (⌘Z) desfaz de uma vez.

Se a nota mudou desde que a visualização foi feita, Apply recusa e pede uma nova execução em vez de escrever sobre o texto mais recente.

Quando uma transformação não é executada

Toda falha deixa a nota exatamente como estava — você nunca recebe uma transformação pela metade. Cada um diz o que aconteceu em vez de mudar qualquer coisa:

• "Transformações não são executadas em notas protegidas, somente leitura ou na lixeira." O mesmo vale para bibliotecas somente leitura.
• "Mais de 10.000 correspondências em uma regra. Restrinja a transformação."
• "A transformação demorou muito. Simplifique suas regras ou use um escopo menor."
• "Essa transformação não muda nada aqui."
• Uma regra com um padrão inválido, um grupo de captura ausente ou nenhum texto para encontrar, uma transformação sem nome ou sem regras, ou uma transformação Selection executada sem nada selecionado, cada um nomeado na mensagem.

Limites

Não há teste em várias notas: para alterar muitas notas ao mesmo tempo, use Edit › Replace in Notes…, que visualiza as alterações de cada nota separadamente.

Uma transformação só produz Markdown comum, então nada que ela escreve é especial para Varlig, e outro editor vê exatamente o que Varlig salvou.