Como comparar dois textos com um diff unificado

Para que serve e o que pode comparar

O Diff Checker serve para comparar dois valores de texto e tornar visíveis as linhas acrescentadas e removidas num formato de diff unificado. É útil quando precisa de rever alterações entre duas versões de conteúdo, verificar uma edição manual ou perceber rapidamente onde um texto mudou.

A comparação trabalha com um texto original e um texto modificado. Também pode ajustar o número de linhas de contexto mostradas à volta de cada alteração. Na interface atualmente disponível, existe apenas um valor de texto: quando o campo do texto original está vazio, esse valor é usado como original e o texto modificado permanece vazio. Por isso, a experiência disponível não permite introduzir duas versões distintas ao mesmo tempo.

Como utilizar o comparador

1. Prepare as duas versões em formato de texto. Identifique qual deve ser a versão original e qual deve ser a versão modificada; a ordem influencia a leitura das linhas acrescentadas e removidas.

2. Se a interface apresentar campos separados, coloque a versão anterior no campo do texto original e a versão nova no campo do texto modificado. Os dois valores são opcionais por defeito, mas uma comparação só produz um resultado bem-sucedido quando existe conteúdo efetivo num dos valores.

3. Se estiver disponível apenas o campo de valor único, cole nele o texto que pretende analisar. Nesse caso, o valor é tratado como texto original quando o campo original está vazio, enquanto o texto modificado continua vazio. Para comparar duas versões distintas, será necessário ter uma interface que aceite os dois valores.

4. Defina o número de linhas de contexto, se essa opção estiver disponível. O valor predefinido é 3; um valor diferente altera a quantidade de conteúdo mostrado em redor das alterações, não os textos introduzidos.

5. Execute a comparação e leia o diff unificado. Observe os marcadores de linhas acrescentadas e removidas e use as contagens apresentadas para confirmar a dimensão da alteração. Não introduza uma palavra-passe ou outro segredo juntamente com o texto que está a comparar.

Como ler o resultado e conhecer os limites

Um resultado bem-sucedido apresenta a representação das diferenças em diff unificado, o número de linhas acrescentadas, o número de linhas removidas, a contagem combinada das alterações e o número de linhas do texto original e do texto modificado. Use primeiro a representação das diferenças para localizar as mudanças e depois compare as contagens com o tamanho de cada versão.

As linhas de contexto ajudam a interpretar cada mudança no seu enquadramento. Reduzir esse valor torna a saída mais compacta; aumentá-lo mostra mais linhas próximas da alteração. Isso não substitui a comparação dos dois textos nem altera o conteúdo fornecido.

Na interface de valor único atualmente disponível, espere uma comparação entre o texto introduzido como original e um texto modificado vazio. Assim, esse modo é adequado para observar como uma entrada é representada perante um valor vazio, mas não para confirmar diferenças entre uma versão anterior e uma versão nova. Se o resultado for malsucedido, verifique se pelo menos um dos valores efetivos contém texto.

Exemplo prático

Ao rever uma nota de versão, cola a versão anterior no valor disponível para verificar como o comparador a apresenta perante um valor modificado vazio.

Cole o texto de uma versão no valor disponível e execute a comparação; consulte a representação das diferenças e as contagens apresentadas.

O resultado apresenta uma representação em diff unificado, contagens de linhas acrescentadas e removidas, uma contagem combinada das alterações e as contagens de linhas dos valores comparados.

Limitações

• A interface atualmente disponível fornece um único valor de texto, usado como original quando esse campo está vazio; não permite comparar duas versões distintas nesse modo.

Erros comuns

• Erro: deixar os dois valores efetivos vazios. Correção: introduza conteúdo no original ou no modificado antes de executar a comparação.

Perguntas frequentes

Posso comparar duas versões de texto na interface disponível?

A comparação entre duas versões exige dois valores de texto: um original e um modificado. A interface atualmente disponível fornece apenas um valor, tratado como original quando o original está vazio, pelo que não permite introduzir duas versões distintas nesse modo.

Posso alterar as linhas de contexto?

Sim. O número predefinido de linhas de contexto é 3, e a definição numérica controla quanto conteúdo próximo de cada alteração aparece no diff unificado.

O que acontece se eu não introduzir texto?

Não. Quando os dois valores efetivos estão vazios, o resultado é malsucedido. Introduza texto no original ou no modificado antes de executar a comparação.