Coloque o artigo no GitHub
Inicializar o repositório, ignorar arquivos auxiliares, repositório privado e hábitos que mantêm os merges entre coautores sob controle.
Coloque o artigo no GitHub
Um manuscrito em LaTeX é texto simples, o que o torna um ótimo encaixe para o Git. Cada rascunho vira um commit ao qual você pode voltar, cada mudança fica visível como um diff linha a linha, e o GitHub oferece uma cópia fora da sua máquina, além de um meio para os coautores obterem o estado atual. Nada disso exige Git avançado. Um artigo precisa de talvez cinco comandos, usados com constância.
A configuração inicial
git init# add a .gitignore for *.aux *.log *.out *.toc *.synctex.gzgit add main.tex refs.bib figures/git commit -m "Initial manuscript"gh repo create my-paper --private --source=. --pushExecute isso uma vez, na pasta do projeto. A etapa do .gitignore importa mais do que parece. Cada compilação regenera os arquivos .aux, .log, .out, .toc e .synctex.gz, e versioná-los enterra as suas mudanças reais sob ruído de máquina e cria conflitos de merge inúteis entre os coautores. Versione apenas o que você escreve: os fontes .tex, o banco de dados .bib, as figuras e quaisquer arquivos de classe ou de estilo que o veículo tenha fornecido. O PDF também é um produto da compilação. A maioria das equipes o deixa de fora e recompila localmente, embora anexar um PDF a uma release marcada com tag seja uma boa forma de congelar uma versão submetida. Mantenha o repositório privado até o trabalho se tornar público. Um manuscrito não publicado não é algo que deva ser indexado.
Hábitos que mantêm os coautores sãos
Faça de cada commit uma única mudança lógica, como “revisar a introdução da seção 3” ou “adicionar tabela de ablação”. O histórico passa então a se ler como a história do artigo, e uma edição ruim pode ser revertida sem danos colaterais. Faça pull antes de começar uma sessão de escrita e push quando parar. Os conflitos de merge crescem com o tempo que os branches passam separados. Nunca faça force-push num branch compartilhado depois que os coautores já deram pull nele: isso reescreve o histórico debaixo dos pés deles. Mantenha artefatos binários grandes (conjuntos de dados, vídeos) fora do repositório do artigo. Aponte para um repositório de arquivamento ou use um repositório de dados separado. O Git guarda para sempre todas as versões de todo binário.
Um hábito específico do LaTeX: escrever uma frase por linha do fonte torna os diffs muito mais legíveis, porque a edição de uma palavra aparece como a mudança de uma linha, e não como um parágrafo reformatado.
Como o Oleafly se encaixa
Todo projeto do Oleafly é uma pasta comum no disco, então esses comandos funcionam nele sem nenhuma mudança. O Oleafly guarda as compilações bem-sucedidas elegíveis, com o código-fonte alterado, em Pontos de verificação salvos, separadamente do Git. Faça commits deliberados em Controle de versão e depois envie (push) ou receba (pull) as mudanças com os seus colaboradores. Veja o histórico do Git. Para padrões de colaboração construídos sobre isso, incluindo a troca de patches e a divisão de capítulos por autor, veja Coautoria sem cursor ao vivo.