Gerçek bir projedeki dosyalar
.tex, .bib, .cls, .sty ve depoya eklememeniz gereken üretilmiş çöp dosyalar.
Gerçek bir projedeki dosyalar
Gerçek bir LaTeX projesinin klasörünü derlemeden sonra açarsanız, yazdığınızdan çok daha fazla dosya görürsünüz. Bu çoğu yeni başlayanı şaşırtır ve yanlış şeyi silme korkusu klasörleri sonsuza dek dağınık tutar. İşi açığa kavuşturan ayrım şu: bazı dosyalar düzenlediğiniz kaynaktır, bazıları bir şablonun ya da paketin sağladığı stillerdir, geri kalanı ise derleyicinin her çalıştırmada yeniden ürettiği geçici çalışma alanıdır.
Yazdığınız dosyalar
.tex dosyaları asıl belgeyi taşır: metni, bölümleri, şekilleri ve matematiği. .bib dosyası kaynakça veritabanınızdır; atıf yapabileceğiniz her makale ya da kitap için bir kayıt. Onu elle sürdürebilir ya da Zotero gibi bir kaynak yöneticisinden dışa aktarabilirsiniz. Bunlar yedeklenmeye ve sürüm denetimine alınmaya değer dosyalardır, çünkü geri kalan her şey onlardan yeniden üretilebilir.
Bir şablonun size verdiği dosyalar
.cls dosyası, \documentclass{...} içinde adını yazdığınız belge sınıfını tanımlar. Dergiler ve konferanslar, her gönderim aynı görünsün diye kendi sınıflarını sağlar ve bir sınıfı neredeyse hiç düzenlemezsiniz. .sty dosyası bir pakettir: \usepackage ile yüklenen, yeniden kullanılabilir makrolar ve ayarlar. Bir tanesini kendiniz ancak özel komutları birkaç belge arasında paylaşmak istediğinizde yazarsınız. .bst dosyası bir BibTeX atıf stilini tanımlar ve o da genellikle yayın yeri tarafından hazır verilir.
Derleyicinin ürettiği dosyalar
.aux dosyası, derleme geçişleri arasında çapraz başvuru ve atıf verilerini saklar; hiç düzenlemeyin ve silmekten çekinmeyin, çünkü sonraki derleme onu yeniden yazar. .log dosyası derleyicinin yaptığı her şeyi kaydeder ve yalnızca bir şey ters gittiğinde açmaya değer. .pdf ise asıl istediğiniz çıktıdır.
| Uzantı | Görevi | Elle düzenlenir mi? |
|---|---|---|
.tex | Kaynak belgeler ve bölümler | Evet |
.bib | Kaynakça veritabanı | Evet (ya da Zotero’dan dışa aktarın) |
.cls | Belge sınıfı | Nadiren, yayıncı şablonlarında |
.sty | Paketler / stil dosyaları | Kendi makrolarınızı yazarken |
.bst | BibTeX stili | Nadiren |
.aux | Çapraz başvuru verisi | Hayır: üretilir |
.log | Derleyici günlüğü | Hata ayıklarken okuyun |
.pdf | Çıktı | Görüntüleyin / gönderin |
Ölçeklenen proje düzeni
paper/ main.tex chapters/ figures/ refs.bibEn üstteki tek bir main.tex giriş noktası olur, bölümler kendi klasöründe durur ve \input ya da \include ile çağrılır, görüntüler figures/ içinde yer alır, kaynakça da tek bir refs.bib içinde kalır. Bu düzen, proje dört sayfalık bir makale de olsa tez de olsa yönetilebilir kalır. Parçaların nasıl birbirine bağlandığını bölüm dosyalarını ayırma dersi gösterir.
Git kullanıyorsanız *.aux, *.log ve diğer üretilmiş dosyaları .gitignore dosyasına ekleyin; böylece geçmişiniz yalnızca gerçek kaynağı izler. Oleafly projeleri diskte düz klasörlerdir, bu yüzden bu öneri orada da aynen geçerlidir. En sık yapılan hata bunun tersidir: tuhaf bir derleme hatasını ararken .aux dosyalarını silmek çoğu zaman çözümdür, çünkü bozuk bir çalıştırmadan kalan eski bir dosya ardından gelen her derlemeyi zehirleyebilir.