Git para artigos científicos: o que realmente funciona com coautores
Regras de ignore, responsabilidade por capítulos, mensagens de commit, remotos privados e como um ambiente de pesquisa com Git de verdade, bifurcações e pontos de verificação de IA mantém os artigos recuperáveis sem fazer do Git um segundo emprego.
Pesquisadores já usam o Git para código. Artigos se parecem muito com código: texto simples, includes, lixo de compilação. Colocar um manuscrito em um repositório é menos estranho do que parece, depois que você tenta uma vez.
Ignore o lixo
Um .gitignore sensato para LaTeX:
*.aux*.log*.out*.toc*.synctex.gz*.bbl*.blg*.fdb_latexmk*.flsFaça o commit de .tex, .bib, das figuras que você não consegue regenerar e
do arquivo de classe, se a universidade o exigir. Evite fazer commit de todos os
PDFs, a menos que o periódico queira um binário no arquivo.
Se o seu editor inicia o Git para você, confira se os caches de compilação e os intermediários do PDF são ignorados. Uma enxurrada de commits de “ruído” gerados pelos arquivos aux deixa o log sem valor. Você para de lê-lo, e aí o histórico não pode ajudar quando algo quebra.
Seja dono de arquivos, não de linhas
Duas pessoas no mesmo parágrafo é dor de cabeça de mesclagem. Prefira dividir a responsabilidade por capítulo ou por seção. Use pull requests quando o grupo for grande o bastante para a revisão realmente ajudar.
A digitação ao vivo por vários usuários num mesmo buffer é outra ferramenta (editores de LaTeX no navegador). A colaboração com Git é mais lenta e mais explícita: branch, push, revisão. Funciona bem quando você precisa de um rastro documentado. Quando três pessoas precisam digitar o resumo juntas esta tarde, escolha outra coisa.
Mensagens de commit que o você do futuro consegue ler
“Arruma coisas” não serve para nada daqui a três meses. “Reescreve trabalhos relacionados sobre transformers” já basta. Duas camadas ajudam:
- Marcos que você nomeia: rascunhos de seções, submissão, versão final (camera-ready).
- Pontos de verificação de segurança: instantâneos frequentes, para que uma tarde ruim seja reversível.
Se o seu editor cria pontos de verificação depois de uma compilação bem-sucedida ou quando você para de digitar, trate-os como um piso, não como o único histórico. Escreva uma mensagem de verdade quando uma seção ficar pronta ou quando um rascunho for para os coautores.
Remotos privados
O trabalho inédito deve ficar em projetos privados no GitHub ou no GitLab. A formatura e a mudança de laboratório são os momentos em que as pessoas perdem o acesso a contas aleatórias de editores na nuvem. Um remoto que você controla é o backup.
Faça o push quando tiver rede. Não espere até a noite anterior a um prazo para descobrir que o remoto nunca foi conectado.
Compilação local, backup remoto
Na maioria das semanas o ciclo é este: editar e compilar offline, fazer o push quando houver rede. Você não precisa de uma sessão de navegador aberta só para digitar.
O que você quer da ferramenta:
- todo projeto já é um repositório Git de verdade (sem
git initesquecido) - pontos de verificação automáticos depois de compilações bem-sucedidas e de pausas na edição
- preparar (stage), comparação lado a lado, descartar e restaurar com um clique, no mesmo aplicativo do editor e do PDF
- GitHub opcional para os remotos; o histórico já funciona no disco
- bifurcar um projeto inteiro com o histórico completo para um experimento paralelo (uma reescrita arriscada dos métodos, um currículo alternativo) enquanto a cópia da submissão fica intacta
- as edições de IA, se você as ativar, criam um ponto de verificação antes e só entram por meio de diffs de aprovação
O Oleafly (abre em uma nova guia) foi feito assim:
pastas comuns, um .git de verdade, pontos de verificação automáticos que
nomeiam os arquivos que mudaram, painel de Controle de versão com comparações da
árvore de trabalho editáveis, restauração após confirmação, publicação/push/pull
opcionais no GitHub com contagem de commits à frente/atrás, bifurcação de
projeto com linhagem na biblioteca. O git log no terminal coincide com o do
aplicativo porque é o mesmo repositório. O ponto de verificação da IA, quando
você usa um, entra no mesmo histórico de onde você restaura.
Você consegue reproduzir partes disso com um hábito cuidadoso e um cliente Git separado. A diferença está em o histórico ser algo que você configura e lembra de manter, ou algo que o ambiente de pesquisa pressupõe desde o primeiro dia, ao lado do SyncTeX e da compilação.
O que o Git não resolve
O Git não vai substituir os comentários de um coordenador (PI) que só abre PDFs, e não vai decidir de quem é o resumo correto. Figuras binárias ainda mesclam mal, então mantenha-as pequenas, prefira gráficos que você consegue regenerar e combinem cedo quem é responsável pelo quê.
Para coautores que se recusam a usar Git, exporte PDF ou DOCX para a revisão e
mantenha o .tex como fonte da verdade. Veja
coautores que só falam Word.
Uma prática mínima
- Um repositório por artigo ou tese, não um mega-repositório para a carreira inteira.
.gitignorepara o lixo de compilação desde o primeiro dia.- Responsabilidade por capítulo quando mais de uma pessoa edita.
- Commits de marcos com mensagens legíveis.
- Remoto privado conectado antes de o trabalho passar a importar.
- Restauração testada uma vez de propósito, para que a primeira emergência não seja a primeira restauração.
Se você seguir essa lista, o Git para artigos quase some em segundo plano. Antes de um prazo, o que você quer é confiabilidade sem graça, não um segundo hobby.