@madda · 4 gün önce
Overleaf'te beş kişiyle aynı makaleyi yazmak: LaTeX'te ortak çalışırken çıkan sorunlar ve bulduğumuz çözümler
Veri bilimi tarafında çalışıyorum ama yılda bir iki kez üniversitedeki eski hocamın ekibiyle makale yazıyorum. Son çalışmada beş yazardık: iki öğretim üyesi, iki doktora öğrencisi ve ben. Metni Overleaf üzerinde LaTeX ile yazdık. İlk iki hafta resmen kaos oldu, sonra bir düzen oturdu. Benzer şekilde ortak yazım yapacak olanlara faydası olur diye karşılaştığımız sorunları ve çözümleri sırayla yazıyorum.
İlk sorun kaynakçaydı. Herkes kendi referans yöneticisinden dışa aktardığı bib dosyasını projeye yükledi, aynı makale üç farklı anahtar adıyla üç kez girildi. Derleme hatası vermedi ama metinde aynı kaynak farklı numaralarla göründü. Çözüm olarak tek bir bib dosyası tuttuk, anahtar adı için soyadı ve yıl kuralı koyduk ve yeni kaynak eklemeyi bir kişinin sorumluluğuna verdik.
İkinci sorun paket ve makro savaşıydı. Bir arkadaş kendi tez şablonundan alışık olduğu makroları getirdi, diğeri farklı bir tablo paketi kullanıyordu. Derginin şablonuyla çakışan bir iki paket yüzünden derleme süresi uzadı ve bazı tablolar bozuldu. Ana dosyanın başına yalnızca dergi şablonunun istediği paketleri koyduk, ek makroları tek bir dosyada topladık ve kimsenin ana dosyaya paket eklemesine izin vermedik.
Üçüncüsü bölüm dosyalarıydı. Herkes ana dosyada çalışınca kimin neyi değiştirdiği anlaşılmıyordu. Her bölümü ayrı dosyaya böldük ve bölüm sahipleri belirledik. Başkasının bölümüne müdahale yerine yorum bırakmak kuralı koyduk. Değişiklik takibi gibi bazı özelliklerin plana bağlı olabildiğini öğrendik, projeye başlamadan hangi özelliklerin elinizde olduğunu kontrol edin.
Dördüncüsü LaTeX bilmeyen hocamızdı. Kendisi metni Word'de düzeltmeye alışkındı. Ona özel bir şey yapmadık, sadece derlenmiş PDF üzerine not almasını rica ettik, notları da bir doktora öğrencisi metne işledi. Herkesin aynı araca zorlanması gerekmiyor.
Son olarak şekiller. Şekil dosyalarının adını şekil numarasıyla değil, içeriğiyle verdik, çünkü sıralama üç kez değişti. Bu küçük karar en çok zaman kazandıran şey oldu. Siz ortak yazımda hangi kuralları koyuyorsunuz, Git ile senkronize çalışan var mı?
İlk sorun kaynakçaydı. Herkes kendi referans yöneticisinden dışa aktardığı bib dosyasını projeye yükledi, aynı makale üç farklı anahtar adıyla üç kez girildi. Derleme hatası vermedi ama metinde aynı kaynak farklı numaralarla göründü. Çözüm olarak tek bir bib dosyası tuttuk, anahtar adı için soyadı ve yıl kuralı koyduk ve yeni kaynak eklemeyi bir kişinin sorumluluğuna verdik.
İkinci sorun paket ve makro savaşıydı. Bir arkadaş kendi tez şablonundan alışık olduğu makroları getirdi, diğeri farklı bir tablo paketi kullanıyordu. Derginin şablonuyla çakışan bir iki paket yüzünden derleme süresi uzadı ve bazı tablolar bozuldu. Ana dosyanın başına yalnızca dergi şablonunun istediği paketleri koyduk, ek makroları tek bir dosyada topladık ve kimsenin ana dosyaya paket eklemesine izin vermedik.
Üçüncüsü bölüm dosyalarıydı. Herkes ana dosyada çalışınca kimin neyi değiştirdiği anlaşılmıyordu. Her bölümü ayrı dosyaya böldük ve bölüm sahipleri belirledik. Başkasının bölümüne müdahale yerine yorum bırakmak kuralı koyduk. Değişiklik takibi gibi bazı özelliklerin plana bağlı olabildiğini öğrendik, projeye başlamadan hangi özelliklerin elinizde olduğunu kontrol edin.
Dördüncüsü LaTeX bilmeyen hocamızdı. Kendisi metni Word'de düzeltmeye alışkındı. Ona özel bir şey yapmadık, sadece derlenmiş PDF üzerine not almasını rica ettik, notları da bir doktora öğrencisi metne işledi. Herkesin aynı araca zorlanması gerekmiyor.
Son olarak şekiller. Şekil dosyalarının adını şekil numarasıyla değil, içeriğiyle verdik, çünkü sıralama üç kez değişti. Bu küçük karar en çok zaman kazandıran şey oldu. Siz ortak yazımda hangi kuralları koyuyorsunuz, Git ile senkronize çalışan var mı?
9 0 yorum