Visualizar graficamente as diferenças entre dois ficheiro Latex!

Quinta-feira, 5 de Janeiro de 2012

latex logo INTRODUÇÃO

Por vezes é útil saber-se o que foi alterado entre duas versão de um documento Latex. Com o latexdiff isso é possível (ver figura seguinte). Tendo-se dois ficheiros tex é possível marcar graficamente as suas diferenças. O latexdiff compara dois ficheiros e cria um terceiro com anotações que mostram as inserções e eliminações realizadas entre os dois ficheiros.

latexdiff example
Figura 1 - Documento marcado usando o latexdiff

COMO INSTALAR E USAR O latexdiff (em Windows)

Para o sistema operativo Windows, o latexdiff faz parte do MiKTeX.
Assumindo que o MikTeX já se encontra instalado, para usar o comando latexdiff, deve-se abrir uma linha de comandos e digitar o comando latexdiff, cuja sintaxe é:

latexdiff [OPCÕES] doc_antigo.tex doc_novo.tex > dif.tex

Exemplo: Imagine-se que se pretende saber as diferenças entre os ficheiros doc_antigo.tex e doc_novo.tex que se assume estarem no directório "C:\Users\PSantos\docs latex". Depois de aberta a linha de comandos, digita-se:

C:\Users\PSantos>cd "docs latex"
C:\Users\PSantos\docs latex>latexdiff doc_antigo.tex doc_novo.tex > dif.tex


Se tudo correr bem, é criado o ficheiro dif.tex com as diferenças entre os ficheiros antigo.tex e novo.tex.
Contudo, na primeira vez que se usa o comando, o mais provável é ocorrer o erro seguinte.

C:\Users\PSantos\docs latex>latexdiff doc_antigo.tex doc_novo.tex > dif.tex
latexdiff:the Pearl interpreter cannot be found.

O erro ocorre porque o latexdiff precisa de um interpretador Perl para executar o Algorithm::Diff que se encontra num pacote Perl (disponível em http://www.cpan.org).
Para resolver o erro torna-se necessário instalar um interpretador Perl e o pacote mencionado. Estes dois requesitos, resolvem-se descarregando e instalando, por exemplo, o interpretador Perl Strawberry disponível gratuitamente aqui.

Por fim, abre-se uma nova linha de comandos (não usar a janela aberta inicialmente) e volta-se a digitar o comando latexdiff indicado acima. Se o erro "latexdiff:the Pearl interpreter cannot be found." continuar a aparecer, experimentar reeniciar o computador e de seguida voltar a digitar o comando.

FONTES:
- Mensagem do utilizador Vita em http://www.academicproductivity.com/...
- Discussão em http://newsgroups.derkeiler.com/...
- Manual do latexdiff