Співавторство без живого курсора

Патчі, спільні теки разом із Git і окремі файли розділів для кожного.

Співавторство без живого курсора

Редагування в реальному часі, коли ви бачите, як рухається курсор співавтора, — це модель, яку продають хмарні редактори. Чимало добрих статей написано без неї. Коли автори працюють локально, надійний шаблон — асинхронна співпраця на основі Git: кожен редагує на власній машині, а зміни зливаються свідомо, а не символ за символом. Це потребує трохи більше координації й віддячує роботою офлайн, повною історією та незалежністю від чийогось сервера.

Git як основа

Стандартне налаштування — спільний репозиторій, зазвичай на GitHub, з якого всі беруть зміни та в який їх надсилають. Кожен автор працює сесіями: отримати останній стан (pull), писати, зробити коміт, надіслати (push). Оскільки LaTeX — простий текст, Git автоматично зливає паралельні зміни в різних частинах статті, і налаштування займає хвилини. Як це зробити, розповідає урок розмістіть статтю на GitHub. Коли співавтор не може або не хоче користуватися хостингом Git, прогалину заповнюють патчі: git format-patch перетворює коміти на маленькі файли, які можна надіслати електронною поштою, а одержувач застосовує їх через git am, зберігаючи авторство й історію. Це давній процес, і він досі працює скрізь, де працює електронна пошта.

Працює і гібрид, коли співавтор наполягає на синхронізованій теці: тримайте спільну копію в Dropbox або Syncthing для зручності, але нехай один із вас веде історію Git і виконує злиття. Не спрямовуйте живі робочі копії Git двох людей на одну синхронізовану теку, бо конфлікти синхронізації всередині каталогу .git ушкоджують репозиторії.

Поділіть документ за файлами

Злиття стають рідкісними, коли люди рідко чіпають один файл. Розділіть рукопис так, щоб кожен розділ чи секція жили у власному файлі, підключеному з тонкого main.tex через \input{chapters/methods}. Механіку описано в уроці розділити документ на файли. Потім розподіліть відповідальність: кожен співавтор пише чернетки у своїх файлах, а один інтегратор опікується преамбулою, злиттям і фінальним прочитанням на узгодженість позначень і тону. Так само уникають перешкод одне одному команди програмістів, і це працює з тих самих причин.

Що насправді йде не так

Режим збою, якого слід уникати, — двоє редагують один абзац у той самий проміжок часу. Git позначить це як конфлікт, а конфлікти LaTeX читабельні, але виснажливі до розв’язання, тож найдешевше виправлення — соціальне: коротке повідомлення «сьогодні я у вступі» запобігає майже всім. Дві звички письма зменшують решту. Пишіть одне речення на рядок джерела, щоб паралельні правки сусідніх речень узагалі не конфліктували, і робіть pull безпосередньо перед кожною сесією письма, щоб завжди редагувати найновіший текст.

Назад до Локальна студія