Makaleyi GitHub'a koyun

Init, aux dosyalarını yok sayma, özel depo ve ortak yazar birleştirmelerini akıllı tutan alışkanlıklar.

Makaleyi GitHub’a koyun

Bir LaTeX el yazması düz metindir ve bu onu Git için ideal kılar. Her taslak, dönebileceğiniz bir commit olur; her değişiklik satır düzeyinde bir fark (diff) olarak görünür ve GitHub size site dışı bir kopya ile ortak yazarların güncel durumu çekebilmesi için bir yol sağlar. Bunların hiçbiri ileri düzey Git gerektirmez. Bir makale için tutarlı biçimde kullanılan belki beş komut yeter.

İlk kurulum

Terminal penceresi
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

Bunu proje klasöründe bir kez çalıştırın. .gitignore adımı göründüğünden daha önemlidir. Her derleme .aux, .log, .out, .toc ve .synctex.gz dosyalarını yeniden üretir; bunları commit’lemek gerçek değişikliklerinizi makine gürültüsünün altına gömer ve ortak yazarlar arasında anlamsız birleştirme çakışmaları yaratır. Yalnızca sizin yazdıklarınızı izleyin: .tex kaynakları, .bib veritabanı, şekiller ve etkinliğin verdiği tüm sınıf ya da biçem dosyaları. PDF de bir derleme ürünüdür. Çoğu ekip onu dışarıda bırakıp yerelde yeniden derler; yine de etiketli bir sürüme bir PDF eklemek, gönderilmiş bir sürümü dondurmanın makul bir yoludur. Çalışma herkese açık olana kadar depoyu özel tutun. Yayımlanmamış bir el yazması, dizinlenmesi gereken bir şey değildir.

Ortak yazarları akıllı tutan alışkanlıklar

Her commit’i tek bir mantıksal değişiklik yapın; örneğin “revise section 3 intro” veya “add ablation table”. Böylece geçmiş makalenin bir hikâyesi gibi okunur ve kötü bir düzenleme çevresine zarar vermeden geri alınabilir. Bir yazma oturumuna başlamadan önce çekin (pull), bırakırken itin (push). Birleştirme çakışmaları, dalların ayrı kaldığı süreyle birlikte büyür. Ortak yazarlar bir paylaşımlı dalı çektikten sonra ona asla zorla itme (force-push) yapmayın: bu, geçmişi ayaklarının altında yeniden yazar. Büyük ikili dosyaları (veri kümeleri, videolar) makale deposunun dışında tutun. Bir arşive bağlantı verin ya da ayrı bir veri deposu kullanın. Git, her ikili dosyanın her sürümünü sonsuza dek saklar.

LaTeX’e özgü bir alışkanlık: kaynakta satır başına bir cümle yazmak farkları (diff) çarpıcı biçimde daha okunur kılar, çünkü tek sözcüklük bir düzenleme yeniden akıtılmış bir paragraf yerine tek satırlık bir değişiklik olarak görünür.

Oleafly nereye oturur

Her Oleafly projesi diskte sıradan bir klasördür, bu yüzden bu komutlar onun üzerinde değişmeden çalışır. Oleafly, kaynağı değişmiş uygun başarılı derlemeleri Git’ten ayrı olarak Kayıtlı Kontrol Noktaları içinde tutar. Kaynak Denetimi’nde bilinçli commit’ler yapın, ardından ortak çalışanlarınızla itin veya çekin. Bkz. Git geçmişi. Bunun üzerine kurulu işbirliği kalıpları için, yama değişimi ve bölüm sahipliği dahil, bkz. Canlı imleç olmadan ortak yazarlık.

Yerel stüdyo bölümüne geri dön