Sube el artículo a GitHub

Inicializar, ignorar los archivos auxiliares, repositorio privado y hábitos que hacen llevaderas las fusiones con los coautores.

Sube el artículo a GitHub

Un manuscrito en LaTeX es texto plano, lo que lo hace ideal para Git. Cada borrador se convierte en un commit al que puedes volver, cada cambio se ve como una diferencia línea por línea, y GitHub te da una copia fuera de tu equipo y una forma de que los coautores obtengan el estado actual. Nada de esto requiere un Git avanzado. Un artículo necesita quizá cinco comandos, usados con constancia.

La configuración inicial

Ventana del terminal
git init
# add a .gitignore for *.aux *.log *.out *.toc *.synctex.gz
git add main.tex refs.bib figures/
git commit -m "Initial manuscript"
gh repo create my-paper --private --source=. --push

Ejecuta esto una vez en la carpeta del proyecto. El paso del .gitignore importa más de lo que parece. Cada compilación regenera los archivos .aux, .log, .out, .toc y .synctex.gz, y subirlos entierra tus cambios reales bajo ruido de máquina y crea conflictos de fusión inútiles entre coautores. Sigue solo lo que escribes tú: los fuentes .tex, la base de datos .bib, las figuras y cualquier archivo de clase o de estilo que te haya dado la revista o el congreso. El PDF también es un producto de la compilación. La mayoría de los equipos lo dejan fuera y lo reconstruyen en su equipo, aunque adjuntar uno a una versión etiquetada (release) es una forma razonable de congelar una versión enviada. Mantén el repositorio privado hasta que el trabajo sea público. Un manuscrito sin publicar no es algo que deba indexarse.

Hábitos que mantienen cuerdos a los coautores

Haz que cada commit sea un cambio lógico, como «revisar la introducción de la sección 3» o «añadir la tabla de ablación». Así el historial se lee como la historia del artículo, y una mala edición se puede revertir sin daños colaterales. Haz pull antes de empezar una sesión de escritura y push cuando termines. Los conflictos de fusión crecen con el tiempo que pasan separadas las ramas. No hagas nunca force-push a una rama compartida una vez que los coautores la han descargado: eso reescribe el historial bajo sus pies. Mantén los artefactos binarios grandes (conjuntos de datos, vídeos) fuera del repositorio del artículo. Enlaza a un archivo o usa un repositorio de datos aparte. Git guarda para siempre todas las versiones de todos los binarios.

Un hábito específico de LaTeX: escribir una frase por línea de código fuente hace que las diferencias sean mucho más legibles, porque la edición de una palabra aparece como un cambio de una sola línea en lugar de un párrafo que se recoloca entero.

Cómo encaja Oleafly

Cada proyecto de Oleafly es una carpeta normal en el disco, así que estos comandos funcionan sobre él sin cambios. Oleafly conserva en Puntos de control guardados las compilaciones correctas aptas cuyo código fuente ha cambiado, de forma independiente de Git. Haz commits deliberados en Control de versiones y luego haz push o pull con tus colaboradores. Consulta el historial de Git. Para ver patrones de colaboración construidos sobre esto, incluidos el intercambio de parches y la asignación de capítulos, consulta escribir en coautoría sin un cursor en vivo.

Volver a El estudio local