Canlı imleç olmadan birlikte yazmak
Yamalar, paylaşımlı klasörler ile Git ve ayrı bölüm dosyalarına sahip çıkmak.
Canlı imleç olmadan birlikte yazmak
Ortak yazarınızın imlecinin hareket ettiğini izlediğiniz gerçek zamanlı ortak düzenleme, bulut düzenleyicilerinin sattığı modeldir. Pek çok iyi makale bu olmadan yazılır. Yazarlar yerel çalıştığında Git üzerine kurulu eşzamansız işbirliği güvenilir bir düzendir: herkes kendi makinesinde düzenler, değişiklikler karakter karakter değil, bilinçli olarak birleştirilir. Biraz daha fazla koordinasyon ister ve karşılığında çevrimdışı çalışma, tam geçmiş ve kimsenin sunucusuna bağımlı olmama sağlar.
Omurga olarak Git
Standart kurulum, çoğunlukla GitHub’da duran ve herkesin kendisinden çekip kendisine ittiği paylaşımlı bir depodur. Her yazar oturumlar halinde çalışır: son durumu çeker, yazar, commit eder, iter. LaTeX düz metin olduğu için Git, makalenin farklı bölümlerindeki paralel değişiklikleri kendiliğinden birleştirir ve kurulum dakikalar sürer. Makaleyi GitHub’a koyun dersi bunu anlatır. Bir ortak yazar bir Git barındırıcısını kullanamıyorsa ya da kullanmak istemiyorsa yamalar boşluğu doldurur: git format-patch commit’leri e-postayla gönderebileceğiniz küçük dosyalara çevirir, alıcı da bunları git am ile uygulayarak yazarlığı ve geçmişi korur. Eski bir iş akışıdır ve e-postanın çalıştığı her yerde hâlâ işe yarar.
Ortak yazar eşitlenen bir klasörde ısrar ediyorsa bir melez düzen de işler: paylaşılan kopyayı kolaylık olsun diye Dropbox ya da Syncthing içinde tutun, ama Git geçmişini ve birleştirmeleri tek kişi yürütsün. İki kişinin canlı Git çalışma kopyalarını aynı eşitlenen klasöre yöneltmeyin; çünkü .git dizini içindeki eşitleme çakışmaları depoları bozar.
Belgeyi dosyalara bölün
İnsanlar aynı dosyaya nadiren dokunduğunda birleştirmeler seyrekleşir. El yazmasını her bölüm kendi dosyasında yaşayacak şekilde bölün ve bunları ince bir main.tex içinden \input{chapters/methods} ile çağırın. İşleyişi Belgeyi dosyalara bölmek dersinde bulabilirsiniz. Sonra sahipliği paylaştırın: her ortak yazar kendi dosyalarında taslak yazar, tek bir birleştirici ise önsözle, birleştirmeyle ve gösterim ile üslubun tutarlılığı için son okumayla ilgilenir. Bu, yazılım ekiplerinin birbirinin ayağına basmaktan kaçınma biçimine benzer ve aynı nedenlerle işe yarar.
Gerçekte ne ters gider
Kaçınılması gereken hata biçimi, iki kişinin aynı zaman diliminde aynı paragrafı düzenlemesidir. Git bunu çakışma olarak işaretler; LaTeX çakışmaları okunabilir ama çözmesi sıkıcıdır, bu yüzden en ucuz çözüm sosyaldir: “Bugün giriş bölümündeyim” diyen kısa bir mesaj hemen hepsini önler. İki yazma alışkanlığı kalanını azaltır. Kaynakta satır başına bir cümle tutun; böylece komşu cümlelerdeki paralel düzenlemeler hiç çakışmaz. Her yazma oturumundan hemen önce çekin; böylece hep en güncel metni düzenlersiniz.