Como criar um ‘resumo das alterações’ com latexdiff

Como criar um ‘resumo das alterações’ com latexdiff

Seguindo meupergunta anterior, criei com sucesso umdif.texarquivo de um projeto grande e complexo, cujos resultados podem ser vistosaqui. (Isso foi feito, no final, atualizandolátex diferentepara a versão mais recente: 1.0.3 que não está no Ubuntu 12.04 ppas e usando: PICTUREENV=(?:picture|DIFnomarkup|lstlisting|figure|table)[\w\d*@]*como oarquivo de configuração.

É ótimo poder percorrer o documento e ver todas as melhorias que foram feitas. Obrigado látexdiff!

O próximo problema é que o documento PDF é muito grande e as alterações são relativamente escassas - não posso esperar que meus examinadores examinem todas as 300 páginas em busca de texto em vermelho e azul para indicar alterações. O que eu preciso é de umSumário de Mudanças. Isso conteria, no mínimo, o texto que foi alterado. Idealmente, também conteria palavras circundantes para contexto e (um tiro no escuro) o número da página da alteração. Maneiras que pensei em fazer isso:

  • Redefina o \DIFdelbeginambiente
  • Use um regex como grep para extrair todas as linhas do dif.tex contendo \DIFe compilar isso separadamente
  • Faça isso usando comandos latexdiff (verifiquei a documentação, mas não consigo ver como.
  • Uma abordagem totalmente diferente seria melhor para resolver este problema (fazer uma lista acessível das alterações feitas, sem incluir o texto que permaneceu o mesmo).

Eu conheço umpergunta semelhantefoi fechado neste site. Esperamos que a clareza desta questão e o fornecimento de um exemplo a tornem útil para outros.

Responder1

Há uma nova funcionalidade no latexdiff desde a versão 1.1.0 que exibe apenas as páginas onde uma alteração foi feita.

Confira a opção --only-changespara latexdiff-vcou opções -s ONLYCHANGEDPAGEou -s ZLABELpara latexdiff. O primeiro é muito mais conveniente porque o pós-processamento é feito nos bastidores.

(Eu sei que esta pergunta é muito antiga, mas a melhoria no latexdiff nesse aspecto desde que as respostas originais foram publicadas é significativa)

Responder2

Acho que a maneira mais fácil, de longe, é usar grep. A implementação GNU de grep(que é o que você tem se estiver executando GNU/Linux), fornece uma opção chamada -Cpara fazer exatamente o que você deseja: fornece linhas de contexto em torno da correspondência.

Algo assim deve ajudar

grep -C 5 '\\DIF' source.tex > destination.tex

Isso fornecerá 5 linhas antes e 5 linhas depois da partida. Modificarad libido.

Maneiras que isso pode falhar

  • Se as linhas de contexto cruzarem os limites do ambiente/grupo LaTeX, seu novo documento não será compilado.
  • Se a \DIFexistir dentro de um "raio" de 5 linhas de outro, grepa saída de conterá duplicatas. Isso pode não ser um grande problema se suas edições forem realmente esparsas, mas talvez seja necessário verificar isso visualmente.

Responder3

Faça isso manualmente.

Descobri que a melhor maneira de criar um "resumo das alterações" era pesquisar nodif.texarquivo e escolha manualmente as alterações que eu precisava. Isso foi ótimo, pois me permitiu incluir apenas as alterações necessárias e incluir contexto suficiente para permitir que outras pessoas entendessem por que as alterações foram feitas.

O resultado (verdifsum.pdf), junto com os arquivos .tex relevantes e código reproduzível e tese de dados de exemplo foram colocados no GitHub para encorajar transparência eRepetivelpesquisar:https://github.com/Robinlovelace/thesis-reproducible. Esperamos que isso seja útil para outras pessoas que buscam otimizar o uso do LaTeX para a submissão e alteração de projetos de tese.

informação relacionada