{"id":591,"date":"2025-12-19T11:32:33","date_gmt":"2025-12-19T14:32:33","guid":{"rendered":"http:\/\/www.inf.ufes.br\/~vitorsouza\/?p=591"},"modified":"2026-02-20T15:04:13","modified_gmt":"2026-02-20T18:04:13","slug":"controle-de-alteracoes-em-latex-usando-overleaf","status":"publish","type":"post","link":"https:\/\/inf.ufes.br\/~vitorsouza\/controle-de-alteracoes-em-latex-usando-overleaf\/","title":{"rendered":"Controle de altera\u00e7\u00f5es em LaTeX usando Overleaf"},"content":{"rendered":"\n

Ao longo da carreira docente, em particular na fun\u00e7\u00e3o de orienta\u00e7\u00e3o de estudantes, mais especificamente ainda na revis\u00e3o de textos (relat\u00f3rios, monografias, artigos, etc.) produzidos por eles, h\u00e1 muito indico o LaTeX<\/a> como linguagem de marca\u00e7\u00e3o para escrita de textos acad\u00eamicos\/cient\u00edficos (veja aqui<\/a> ou aqui<\/a> alguns dos motivos pra isso). <\/p>\n\n\n\n

Para o controle de altera\u00e7\u00e3o e coment\u00e1rios na revis\u00e3o destes textos, vinha usando o Git<\/a>, sistema de controle de vers\u00f5es muito usado para software, inicialmente num reposit\u00f3rio em servidor local<\/a> e, posteriormente, me rendendo a uma plataforma Git na nuvem (BitBucket)<\/a>. Mais recentemente, me rendi ao Overleaf<\/a>, um editor LaTeX colaborativo na Web, cuja vers\u00e3o paga permite controle de altera\u00e7\u00f5es mais amig\u00e1vel, particularmente para n\u00e3o-devs<\/a>.<\/p>\n\n\n\n

Ainda assim, para um processo de escrita colaborativo, em especial na revis\u00e3o de textos escritos por orientados, \u00e9 interessante estabelecer um protocolo de revis\u00e3o, de modo a n\u00e3o ter retrabalho (ex.: ter que reler uma se\u00e7\u00e3o que j\u00e1 foi revisada, mas teve altera\u00e7\u00f5es apenas em poucos trechos) e o processo ser mais eficiente. Esse post<\/em> descreve o protocolo que uso com meus orientados.<\/p>\n\n\n\n\n\n\n\n

Como as fun\u00e7\u00f5es necess\u00e1rias para este protocolo requerem a vers\u00e3o paga do Overleaf, em primeiro lugar o projeto deve ser criado por algu\u00e9m com conta paga no Overleaf (por exemplo, eu) e compartilhado com os demais coautores. Em seguida inicia-se o processo de Escrita<\/strong>, Revis\u00e3o<\/strong> e Edi\u00e7\u00e3o<\/strong>, seguido por ciclos de Revis\u00e3o-Edi\u00e7\u00e3o<\/strong>. Na sequ\u00eancia, descrevemos o processo mais simples de trabalho entre Estudante<\/strong> e Orientador<\/strong>. No caso de haver outros coautores o processo deve ser adaptado:<\/p>\n\n\n\n

Escrita inicial (estudante)<\/h3>\n\n\n\n

A primeira vers\u00e3o do texto o estudante<\/strong> escreve normalmente (ou seja, em modo edi\u00e7\u00e3o no Overleaf). Quando achar que tem algo que j\u00e1 pode ser enviado para revis\u00e3o do orientador<\/strong>, deve avis\u00e1-lo. <\/p>\n\n\n\n

Aqui, o texto escrito a ser revisado pode ser um documento inteiro, um cap\u00edtulo, uma se\u00e7\u00e3o, de acordo com a organiza\u00e7\u00e3o do estudante<\/strong>. Lembrando que sempre que um texto \u00e9 enviado para revis\u00e3o, deve-se aguardar a revis\u00e3o para voltar a mexer naquele texto. Enquanto isso, pode-se adiantar outras partes do documento. Recomenda-se, portanto, dividir a revis\u00e3o nos cap\u00edtulos\/se\u00e7\u00f5es do documento.<\/p>\n\n\n\n

Revis\u00e3o (orientador)<\/h3>\n\n\n\n

Assim que poss\u00edvel, o orientador<\/strong> faz sua revis\u00e3o (lembrando que h\u00e1 sempre uma fila de textos para revis\u00e3o a ser observada). A revis\u00e3o no Overleaf ser\u00e1 feita no modo Reviewing<\/em>, que \u00e9 habilitado clicando num bot\u00e3o com o \u00edcone de um l\u00e1pis que fica abaixo da barra de formata\u00e7\u00e3o, no topo do editor e trocando de Editing<\/em> para Reviewing<\/em>, como mostra a Figura 1. <\/p>\n\n\n\n

\"\"
Figura 1 – Trocando do modo edi\u00e7\u00e3o para o modo revis\u00e3o no Overleaf.<\/figcaption><\/figure>\n\n\n\n

Neste modo, a edi\u00e7\u00e3o realizada no documento ficar\u00e1 expl\u00edcita de duas formas:<\/p>\n\n\n\n

(a) Ao marcar um texto e adicionar um coment\u00e1rio, o texto fica marcado de laranja e o coment\u00e1rio aparece numa barra Review<\/em> ao lado do editor, como ilustra a Figura 2. Como pode ser visto, os coment\u00e1rios possuem um bot\u00e3o de checkmark<\/em> (\u2705). Este bot\u00e3o serve para resolver um coment\u00e1rio, o que faz o coment\u00e1rio “sumir” (retornaremos a este assunto abaixo).<\/p>\n\n\n\n

\"\"
Figura 2 – Coment\u00e1rio feito em um trecho do documento.<\/figcaption><\/figure>\n\n\n\n

(b) Ao editar diretamente o texto em modo revis\u00e3o, novos textos aparecem marcados de verde e a mudan\u00e7a \u00e9 tamb\u00e9m destacada ao lado do editor, junto dos coment\u00e1rios, como pode ser visto na Figura 3. Diferentemente dos coment\u00e1rios, no entanto, as mudan\u00e7as apresentam dois bot\u00f5es: o checkmark<\/em> (\u2705), que serve para aceitar uma mudan\u00e7a e um X (\u274c) que serve para rejeitar a mudan\u00e7a.<\/p>\n\n\n\n

\"\"
Figura 3 – Modifica\u00e7\u00e3o no texto feita em modo revis\u00e3o.<\/figcaption><\/figure>\n\n\n\n

Edi\u00e7\u00e3o (estudante)<\/h3>\n\n\n\n

Assim que o orientador<\/strong> avisar ao estudante<\/strong> que fez a revis\u00e3o, o estudante<\/strong> abre novamente o texto revisado no Overleaf e a primeira coisa que deve fazer \u00e9 mudar para o modo Reviewing<\/em> como feito anteriormente pelo orientador<\/strong> (vide Figura 1), para que o orientador<\/strong> possa posteriormente ver o que o estudante<\/strong> mudou no texto que ele j\u00e1 revisou. Isso \u00e9 MUITO importante, pois do contr\u00e1rio o orientador<\/strong> talvez precise ler todo o texto novamente, mesmo em caso de mudan\u00e7as pontuais, fazendo com que o processo fique mais ineficiente e demorado do que o necess\u00e1rio.<\/p>\n\n\n\n

Em seguida, o estudante<\/strong> deve:<\/p>\n\n\n\n

  1. Passar pelas modifica\u00e7\u00f5es<\/span> feitas na revis\u00e3o e ver se concorda com elas. Caso concorde, deve clicar no checkmark<\/em> (\u2705) para aceitar<\/span>. Caso discorde, N\u00c3O deve rejeit\u00e1-las<\/span>, mas adicionar um coment\u00e1rio<\/span> explicando porque discorda. Para adicionar um coment\u00e1rio, marque um trecho de texto e clique no bot\u00e3o Add comment<\/em> que aparece acima do texto marcado.<\/li>
  2. Passar pelos coment\u00e1rios<\/span> feitos pelo orientador<\/strong>, fazer as altera\u00e7\u00f5es solicitadas e responder o coment\u00e1rio<\/span> explicando o que foi feito para atend\u00ea-lo. N\u00c3O resolva coment\u00e1rios<\/span>, eles ser\u00e3o resolvidos pelo orientador<\/strong>.<\/li>
  3. Avisar o orientador<\/strong> quando a edi\u00e7\u00e3o for concluida e o texto pode seguir para nova revis\u00e3o.<\/li><\/ol>\n\n\n\n

    Ciclos de Revis\u00e3o-Edi\u00e7\u00e3o<\/h3>\n\n\n\n

    A partir daqui, os procedimentos de Revis\u00e3o pelo orientador<\/strong> e Edi\u00e7\u00e3o pelo estudante<\/strong> se repetem em quantos ciclos forem necess\u00e1rios at\u00e9 o texto ser conclu\u00eddo.<\/p>\n\n\n\n

    Em novos procedimentos de Revis\u00e3o, o orientador<\/strong> resolve os coment\u00e1rios que j\u00e1 foram atendidos de forma satisfat\u00f3ria e adiciona tr\u00e9plicas nos que ele n\u00e3o considerar resolvidos pra que sejam reconsiderados pelo estudante<\/strong> no pr\u00f3ximo ciclo de Edi\u00e7\u00e3o. Modifica\u00e7\u00f5es feitas pelo estudante<\/strong> tamb\u00e9m ser\u00e3o aceitas ou comentadas, conforme o caso.<\/p>\n\n\n\n

    Produ\u00e7\u00e3o da vers\u00e3o final (p\u00f3s-banca)<\/h3>\n\n\n\n

    No caso de monografias, disserta\u00e7\u00f5es, teses e outros documentos que s\u00e3o apresentados diante de uma banca, ap\u00f3s a argui\u00e7\u00e3o por parte desta o estudante<\/strong> precisa produzir uma vers\u00e3o final levando em considera\u00e7\u00e3o os coment\u00e1rios dos membros da banca. Cabe ao orientador<\/strong> geralmente garantir que os coment\u00e1rios foram todos levados em conta.<\/p>\n\n\n\n

    Para a produ\u00e7\u00e3o desse documento final, ent\u00e3o, uso o seguinte protocolo:<\/p>\n\n\n\n

    1. Ap\u00f3s receber os coment\u00e1rios da banca, o estudante<\/strong> deve analis\u00e1-los e:
      • Para corre\u00e7\u00f5es simples (ex.: erro de digita\u00e7\u00e3o, ortografia, etc.), j\u00e1 efetuar a corre\u00e7\u00e3o;<\/li>
      • Para coisas mais complexas, num primeiro momento apenas adicionar um coment\u00e1rio no respectivo trecho do documento contendo o nome do(a) membro da banca e exatamente o que ele(a) falou no coment\u00e1rio.<\/li><\/ul><\/li>
      • Em seguida, o estudante<\/strong> come\u00e7a a trabalhar nas altera\u00e7\u00f5es solicitadas nos coment\u00e1rios mais complexos, sempre em modo revis\u00e3o para que as mudan\u00e7as fiquem destacadas para futura an\u00e1lise do orientador<\/strong>;<\/li>
      • Para cada coment\u00e1rio que for sendo satisfeito, o estudante<\/strong> responde ao coment\u00e1rio que tem o nome do(a) membro da banca, indicando o que foi feito em rela\u00e7\u00e3o \u00e0quele ponto;<\/li>
      • Quando o estudante indicar que concluiu os ajustes, o orientador<\/strong>, enfim, passa pelos coment\u00e1rios e avalia se foram de fato satisfeitos plenamente. Os que forem, ser\u00e3o resolvidos e desaparecem. Os que n\u00e3o forem, o orientador<\/strong> responde ao coment\u00e1rio com suas considera\u00e7\u00f5es para um novo ciclo de Edi\u00e7\u00e3o-Revis\u00e3o.<\/li><\/ol>\n","protected":false},"excerpt":{"rendered":"

        Ao longo da carreira docente, em particular na fun\u00e7\u00e3o de orienta\u00e7\u00e3o de estudantes, mais especificamente ainda na revis\u00e3o de textos (relat\u00f3rios, monografias, artigos, etc.) produzidos por eles, h\u00e1 muito indico o LaTeX como linguagem de marca\u00e7\u00e3o para escrita de textos acad\u00eamicos\/cient\u00edficos (veja aqui ou aqui alguns dos motivos pra isso). Para o controle de altera\u00e7\u00e3o […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[3],"tags":[],"class_list":["post-591","post","type-post","status-publish","format-standard","hentry","category-blog"],"_links":{"self":[{"href":"https:\/\/inf.ufes.br\/~vitorsouza\/wp-json\/wp\/v2\/posts\/591","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/inf.ufes.br\/~vitorsouza\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/inf.ufes.br\/~vitorsouza\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/inf.ufes.br\/~vitorsouza\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/inf.ufes.br\/~vitorsouza\/wp-json\/wp\/v2\/comments?post=591"}],"version-history":[{"count":5,"href":"https:\/\/inf.ufes.br\/~vitorsouza\/wp-json\/wp\/v2\/posts\/591\/revisions"}],"predecessor-version":[{"id":600,"href":"https:\/\/inf.ufes.br\/~vitorsouza\/wp-json\/wp\/v2\/posts\/591\/revisions\/600"}],"wp:attachment":[{"href":"https:\/\/inf.ufes.br\/~vitorsouza\/wp-json\/wp\/v2\/media?parent=591"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/inf.ufes.br\/~vitorsouza\/wp-json\/wp\/v2\/categories?post=591"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/inf.ufes.br\/~vitorsouza\/wp-json\/wp\/v2\/tags?post=591"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}