Tek kök dosya, çok bölüm

include ile input, includeonly ve bir seferde tek bölüm taslağı hazırlamak.

Tek kök dosya, çok bölüm

Tek bir .tex dosyasındaki tez, yaklaşık ikinci bölümde çalışması çekilmez hale gelir: düşünmenin yerini kaydırma alır ve her derleme her şeyi işler. Standart çare, sınıfı ve önsözü tutan tek bir kök dosya ve her bölüm için ayrı bir dosyadır. Kök dosya hepsini birbirine dikip bağlar.

Kök dosya

% main.tex
\documentclass{report}
\begin{document}
\include{chapters/intro}
\include{chapters/methods}
\include{chapters/results}
\end{document}

main.tex, derlediğiniz tek dosyadır. Her \include başka bir dosyanın adını .tex uzantısı olmadan, her platformda ileri eğik çizgilerle yazar ve içeriğini o noktaya çeker. Bölüm dosyalarının kendileri yalnızca içerik taşır, genellikle \chapter{...} ile başlar. Kendilerine ait \documentclass komutları ve document ortamları yoktur, çünkü bunlar belge değil, bu belgenin parçalarıdır.

include ile input karşılaştırması

İki dahil etme komutu farklı davranır ve bu farklar hangisinin nerede kullanılacağını belirler. \include, malzemeden önce yeni bir sayfa başlatır, bu da bölümlere uyar; ve dahil edilen her dosya için ayrı bir .aux dosyası yazar, seçerek derlemeyi mümkün kılan da budur. \input düz bir metin yapıştırmadır: sayfa sonu yok, ayrı .aux yok ve başka bir input’un içine yerleştirilebilir. Bu, \input komutunu bölümden küçük parçalar için doğru araç yapar; kendi dosyasında tutulan büyük bir tablo ya da ortak bir makro dosyası gibi. Akılda tutulacak bir yapısal kural: \include, dahil edilmiş bir dosyanın içine yerleştirilemez, \input ise her yerde kullanılabilir.

Bir seferde tek bölüm taslağı hazırlamak

\includeonly{chapters/methods}

Önsöze konan \includeonly, LaTeX’e yalnızca listelenen dosyaları işlemesini, diğerlerinin kaydedilmiş .aux verisini ise okumaya devam etmesini söyler. Derleme çarpıcı biçimde hızlanır ve diğer bölümlerin etiketleri ile sayfa sayıları .aux dosyalarından yeniden oynatıldığı için taslağını hazırladığınız bölümdeki çapraz başvurular ve numaralandırma doğru kalır. Bu ikinci yarı, \include satırlarını yorum satırı yapmak yerine bunu tercih etmenin nedenidir; yorum satırı yapmak diğer bölümleri tamamen unutturur ve onlara yapılan her \ref komutunu ?? haline getirir.

Tam derlemeler için \includeonly satırını yorum satırı yapın ve bir PDF’yi paylaşmadan önce her zaman eksiksiz bir derleme çalıştırın; çünkü eskimiş .aux verisi, dışarıda bırakılan bölümlerde yapılan düzenlemelerin gerisinde kalabilir. Ortaya çıkan klasördeki hangi dosyaların sizin, hangilerinin üretilmiş olduğunu görmek için gerçek bir projedeki dosyalara bakın.

Uzun biçim bölümüne geri dön