Após a segunda entrega do nosso projeto Cos2Me, realizada no dia 27 de junho, os professores pediram para nossa equipe continuar efetuando as correções para entregar novamente no dia 03 de julho. Além do documento e vídeo do nosso projeto, também foi pedido um documento gerado a partir do LatexDiff.
O LatexDiff é um utilitário que pode ser usado para comparar diferentes versões de um mesmo arquivo LaTeX e, a partir da comparação, é possível gerar um PDF com a marcação das mudanças como no exemplo a seguir:
Para instalar o LatexDiff a equipe utilizou os seguintes comandos no Ubuntu:
sudo apt-get update
sudo apt-get install latexdiff
Para usuários do Windows:
1. Instale o Perl:
http://www.perl.org/get.html
2. Faça o download do LatexDiff no CTAN:
https://ctan.org/tex-archive/support/latexdiff
3. Descompacte os arquivos do LatexDiff no diretório bin do Perl
Para utilizar o LaTeX, o seguinte comando deve ser executado no terminal:
latexdiff arquivo-original.tex arquivo-revisado.tex > modificacoes.tex
Após executar esse comando, o arquivo modificacoes.tex será preenchido com todas as mudanças ocorridas marcadas.
Nossa equipe utilizou o editor online Overleaf durante todo o desenvolvimento do projeto, então nós fizemos o download de duas versões diferentes da documentação para comparar, porém, nossa equipe passou por alguns problemas e dúvidas ao tentar efetuar a comparação e gerar o PDF:
- O arquivo gerado estava em branco;
- O arquivo gerado só possuía as diferenças de um arquivo e não de todo o documento;
- Era necessário efetuar a comparação arquivo por arquivo?
Após a busca por diversos tutoriais na internet, sanamos esses problemas da seguinte maneira:
1. O LatexDiff possui suporte ao SVN. Como nosso projeto está no SVN, fomos até o diretório no qual se encontravam os arquivos LaTeX:
~/progress2future/documentos/latex/
2. Após entrar no diretório que contem os arquivos LaTeX, utilizamos o comando svn log para listar os commits efetuados
3. Escolhemos o número do commit arquivos latex que é o 60453 que será comparado com a versão atual do projeto
4. Feito isso, executamos o comando latexdiff-svn <svn revision number> <filename>
5. Após efetuar esse comando, serão criados arquivos temporários para o uso da comparação e, como resultado da mesma, será gerado um arquivo tex contendo o projeto inteiro com suas marcações. Então é necessário efetuar os seguintes passos:
- Abrir o projeto atual em um editor LaTeX, no caso utilizamos o Overleaf;
- Copiar o arquivo gerado pelo latexdiff para o projeto contido no editor e configurá-lo como main;
- Compilar o projeto e verificar se as mudanças ocorreram de forma desejada;
- Gerar o PDF.
E foi assim que a nossa equipe conseguiu utilizar o LatexDiff!