Розмістіть статтю на GitHub
Ініціалізація, ігнорування допоміжних файлів, приватний репозиторій і звички, які зберігають злиття співавторів у порядку.
Розмістіть статтю на GitHub
Рукопис у LaTeX — це звичайний текст, тож він ідеально пасує до Git. Кожна чернетка стає комітом, до якого можна повернутися, кожна зміна видна як різниця на рівні рядків, а GitHub дає вам копію поза вашим комп’ютером і спосіб для співавторів отримати поточний стан. Для цього не потрібен просунутий Git. Для статті вистачить п’яти команд, якими ви користуєтеся послідовно.
Початкове налаштування
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=. --pushВиконайте це один раз у папці проєкту. Крок із .gitignore важливіший, ніж здається. Кожна компіляція заново створює файли .aux, .log, .out, .toc і .synctex.gz. Якщо їх закомітити, ваші справжні зміни потонуть у машинному шумі, а між співавторами виникатимуть безглузді конфлікти злиття. Відстежуйте лише те, що пишете самі: вихідні файли .tex, базу .bib, рисунки та файли класу чи стилю, які надало видання. PDF теж є продуктом збірки. Більшість команд не зберігає його й перебудовує локально, хоча додати PDF до випуску з тегом цілком розумно, щоб зафіксувати подану версію. Тримайте репозиторій приватним, доки робота не стане публічною. Неопублікований рукопис не повинен потрапляти в індекс.
Звички, які зберігають лад між співавторами
Робіть кожен коміт однією логічною зміною, наприклад «переглянути вступ до розділу 3» або «додати таблицю абляції». Тоді історія читається як розповідь про статтю, а невдалу правку можна скасувати без побічних наслідків. Перед початком роботи отримуйте зміни (pull), а закінчивши, надсилайте свої (push). Конфлікти злиття зростають разом із часом, який гілки провели нарізно. Ніколи не робіть force-push у спільну гілку, коли співавтори вже її отримали: це переписує історію в них під ногами. Тримайте великі двійкові файли (набори даних, відео) поза репозиторієм статті. Дайте посилання на архів або заведіть окремий репозиторій для даних. Git зберігає кожну версію кожного двійкового файлу назавжди.
Одна звичка, специфічна для LaTeX: якщо писати по одному реченню на рядок вихідного коду, різниці стають значно читабельнішими, бо правка одного слова виглядає як зміна одного рядка, а не як перекомпонований абзац.
Як Oleafly вписується в цей процес
Кожен проєкт Oleafly — це звичайна папка на диску, тож ці команди працюють із нею без змін. Oleafly зберігає придатні успішні збірки зі зміненим вихідним кодом у розділі Збережені контрольні точки, окремо від Git. Робіть свідомі коміти в розділі «Контроль версій», а потім надсилайте або отримуйте зміни разом зі співавторами. Див. історію Git. Про моделі співпраці, побудовані на цій основі, зокрема обмін патчами та розподіл розділів між авторами, читайте в уроці Співавторство без живого курсора.