> For the complete documentation index, see [llms.txt](https://overleaf-pro.ayaka.space/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://overleaf-pro.ayaka.space/latex/tr/belge-yapisi/08-multi-file-latex-projects.md).

# Çok dosyalı LaTeX projeleri

## Giriş

İçinde [büyük LaTeX belgeleri](/latex/tr/belge-yapisi/07-management-in-a-large-project.md) genellikle birkaç tane `.tex` dosya olur; her bölüm ya da kısım için bir tane ve ardından tek bir çıktı üretmek için bunlar birleştirilir. Bu, her şeyi düzenli tutmaya ve belgeyi hata ayıklamayı kolaylaştırmaya yardımcı olur; ancak belge büyüdükçe derleme daha uzun sürer. Bu can sıkıcı olabilir çünkü kişi genellikle her seferinde yalnızca belirli bir dosyada çalışmak ister.

Bunun üstesinden gelmenin doğal yolu her dosyayı ayrı ayrı derlemektir. Çok dosyalı bir projede tek dosyaların derlenmesine izin veren iki ana paket vardır. Seçiminiz neye ihtiyacınız olduğuna bağlıdır.

* ile [şu **subfiles** paketini](#the-subfiles-package) her alt dosyayı bağımsız olarak derleyebilirsiniz ve her alt dosya ana dosyadaki önsözü otomatik olarak kullanır.
* ile [şu **standalone** paketini](#the-standalone-package) her alt dosya bağımsız bir dosya olarak çalıştığından, alt dosyalar daha sonra her birinden önsözleri çekecek bir ana belgede birleştirilebilir. Aynı dosyayı birden fazla belgede yeniden kullanmanız gerekiyorsa özellikle kullanışlıdır; bir tikz resmi bunun iyi bir örneğidir.

## Overleaf .tex dosyalarında \documentclass hakkında notlar

Aşağıdaki video klipte gösterildiği gibi, projenizin ana `.tex` dosyasını ayarlamış olsanız bile derlemek için başka bir dosya seçebilirsiniz—yalnızca bir `\documentclass` bildirimi içeriyorsa. Ancak, projenizin tüm öğelerinin doğru şekilde derlendiğinden emin olmak için—örneğin sözlükler, yollara erişim `.bib` dosyalar vb.—yalnızca projenizin kök dizininde bulunan dosyaları derlemenizi şiddetle öneririz.

{% embed url="<https://videos.ctfassets.net/nrgyaltdicpt/U2nGfRx9NwNGX0vWXNebP/1ca4b9a4b2f36d5ca9c0dbaa87f44bfa/maincompile.mp4>" %}

## subfiles paketi

Bu paket çoğu durum için uygundur, kullanımı gerçekten çok kolaydır.

Bu bölümdeki örnekler şu hiyerarşik dosya yapısına sahiptir:

![CompileSubfilesEx1OverleafV2.png](/files/0c1dfb75d31d665bcdddeb58065ebabb45f82b24)

### Ana dosya

Ana dosyada iki özel komut gereklidir.

```latex
\documentclass{article}
\usepackage{graphicx}
\graphicspath{{images/}}

\usepackage{blindtext}

\usepackage{subfiles} % Önsözde en son yüklenmesi en iyisidir

\title{Subfiles paketi örneği}
\author{Overleaf}
\date{ }

\begin{document}

\maketitle

\section{Giriş}

\subfile{sections/introduction}

\section{İkinci bölüm}

\subfile{sections/section2}

\end{document}
```

![CompileSubfilesEx1aOverleafV2.png](/files/66808cfa45a95c302a09e9b63d03ea484020f0d1)

Dosya başına derleme, şu satırı gerektirir

```latex
\usepackage{subfiles}
```

önsözde, bu `subfiles` paketi etkinleştirir. Ardından her harici alt dosya şu komutla içe aktarılmalıdır: `\subfile{}`. Örnekte dosyalar `introduction.tex` ve `section2.tex` ana dosyaya `sections` klasöründen içe aktarılır. Dosya uzantısının zorunlu olmadığını unutmayın.

[Bir örnek açın `subfiles` paket örneğini Overleaf'te açın](https://www.overleaf.com/project/new/template/19626?id=66392908\&templateName=Subfiles+package+example\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

### Alt dosyalar

Ana dosyanızı ayarladıktan sonra, her alt dosyanın özel bir yapıya sahip olması gerekir.

```latex
\documentclass[../main.tex]{subfiles}
\graphicspath{{\subfix{../images/}}}
\begin{document}
\textbf{Merhaba dünya!}
\begin{figure}[bh]
\centering
\includegraphics[width=3cm]{overleaf-logo}

\label{fig:img1}
\caption{Overleaf logosu}
\end{figure}

Merhaba, işte anlamı olmayan biraz metin...

\end{document}
```

![CompileSubfilesEx2OverleafV2.png](/files/3e7658cc20c450bd57bcc8005c9a0a2564694d69)

Artık bu dosya bağımsız bir dosya olarak derlenebilir; belge sınıfı ve önsözün geri kalanı ana belgede tanımlananlarla aynı olacaktır.

Buradaki ilk komut

```latex
\documentclass[../main.tex]{subfiles}
```

köşeli parantez içindeki parametre, `../main.tex`, ana belgeye göreli yoldur. Bu durumda dosya `introduction.tex` klasörün içindedir, dolayısıyla dosya `sections`mevcut klasörün bir seviye üzerindedir (bunun anlamı `main.tex` budur). `../` anlamına gelir).

Ayrıca kullanmanız gerekecek `\subfix` komutunu göreli klasör yoluyla birlikte belirtirken `\graphicspath` içine `introduction.tex`:

```latex
\graphicspath{{\subfix{../images/}}}
```

Ardından gerçek içerik `\begin{document}` ve `\end{document}`. Bu ortamın dışındaki her şey yoksayılacak ya da daha doğrusu önsözün bir parçası olarak kabul edilecektir. Dosyanın üst ve alt kısmında boş satırlar bırakmaktan kaçının.

[Bir örnek açın `subfiles` paket örneğini Overleaf'te açın](https://www.overleaf.com/project/new/template/19626?id=66392908\&templateName=Subfiles+package+example\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

## standalone paketi

Paket **standalone** ile aynı işlevselliği sağlar **subfiles** ve daha esnektir, ancak sözdizimi daha karmaşık ve hataya açıktır. Temel fark, her alt dosyanın kendi önsözüne sahip olmasıdır.

Bu bölümdeki örnekler şu hiyerarşik dosya yapısına sahiptir:

![CompileSubfilesEx3OverleafV2.png](/files/cc6c6e2dbd747dbd4ff4394b70f984d93762841a)

### Ana dosya

Ana dosya, birden fazla dosyaya sahip diğer projelerinkine çok benzer.

```latex
\documentclass{article}
\usepackage[subpreambles=true]{standalone}
\usepackage{import}

\title{Standalone paketi örneği}
\author{Overleaf}
\date{Mayıs 2021}

\begin{document}

\maketitle

\section{Birinci bölüm}
\import{sections/}{introduction}

\section{İkinci bölüm}
\import{sections/}{section2}

\end{document}
```

![CompileSubfilesEx3Overleaf.png](/files/bbdb20da72a1684ed15928b7f6086152ec0faae7)

Satır

```latex
\usepackage[subpreambles=true]{standalone}
```

şunu etkinleştirir: **standalone** paketini; belgenin başlarına yakın bir yere yerleştirilmelidir. Köşeli parantez içindeki parametre, LaTeX'e her alt dosyanın önsözünü içe aktarmasını söyler (paketler yalnızca bir kez içe aktarılır); eğer atlanırsa, alt dosyaların çalışması için ana belge önsözünde gerekli tüm komutların bulunduğundan emin olun. Farklı önsözlerdeki olası uyumsuzluklar nedeniyle dikkatli olunmalıdır.

Ana belgenin gövdesinde, her alt dosya şu komutla içe aktarılır: `\import{}{}`. Standart `\input{}` komutu da kullanılabilir, ancak bu örnekteki komut [büyük projeleri yönetmek için](/latex/tr/belge-yapisi/07-management-in-a-large-project.md) önerilir, çünkü iç içe geçmiş dosyalardaki hataları önler.

[Overleaf'te `standalone` paketinin bir örneğini açın](https://www.overleaf.com/project/new/template/19636?id=66440758\&templateName=Standalone+package+example\&latexEngine=pdflatex\&texImage=\&mainFile=)

### Alt dosyalar

Her alt dosyanın kendi önsözü olmalı ve bağımsız bir belge olarak çalışmak için gereken tüm paketleri içe aktarmalıdır.

```latex
\documentclass[class=article, crop=false]{standalone}
\usepackage[subpreambles=true]{standalone}
\usepackage{import}
\usepackage{blindtext}

\begin{document}
Bir TikZ şekli bu satırın altında oluşturulacaktır

\begin{figure}[ht]
\centering
\subimport{../}{diagram.tex}
\label{fig:tikzexample}
\caption{Güzel ve basit bir diyagram}
\end{figure}

\blindtext
\end{document}
```

![CompileSubfilesEx4OverleafV2.png](/files/866b4cac3ef0e61670753c92b5511a1e284ea72e)

Alt dosyadaki ilk satır

```latex
\documentclass[class=article, crop=false]{standalone}
```

bunun **standalone** paketiyle kullanılacak bir dosya olduğunu belirtir; köşeli parantezlerin içinde iki isteğe bağlı parametre vardır.

* `class=article`. Şunu ayarlar `article` temel sınıf olarak; kitap, rapor vb. başka herhangi bir sınıf kullanılabilir (beamer hariç).
* `crop=false`. Bu seçenek atlanırsa çıktı en küçük boyuta kırpılır.

Bir sonraki komut zorunlu değildir

```latex
\usepackage[subpreambles=true]{standalone}
```

ancak bu örnekte kullanılması gerekir çünkü burada iç içe geçmiş bir **standalone** dosya var. Bir [tikz resmi](/latex/tr/sekiller-ve-tablolar/05-tikz-package.md) şu komutla eklenir: [`\subimport{../}{diagram.tex}`](/latex/tr/belge-yapisi/07-management-in-a-large-project.md#importing-files), "diagram.tex" dosyasının içeriğini aşağıda görebilirsiniz:

```latex
\documentclass{standalone}
\usepackage{tikz}
\usetikzlibrary{positioning}
\begin{document}

\begin{tikzpicture}[
roundnode/.style={circle, draw=green!60, fill=green!5, very thick, minimum size=7mm},
squarednode/.style={rectangle, draw=red!60, fill=red!5, very thick, minimum size=5mm},
]
%Düğümler
\node[squarednode]      (maintopic)                              {2};
\node[roundnode]        (uppercircle)       [above=of maintopic] {1};
\node[squarednode]      (rightsquare)       [right=of maintopic] {3};
\node[roundnode]        (lowercircle)       [below=of maintopic] {4};

%Çizgiler
\draw[->] (uppercircle.south) -- (maintopic.north);
\draw[->] (maintopic.east) -- (rightsquare.west);
\draw[->] (rightsquare.south) .. controls +(down:7mm) and +(right:7mm) .. (lowercircle.east);

\end{tikzpicture}
\end{document}
```

[Bu Standalone TikZ örneğini Overleaf'te açın](https://www.overleaf.com/docs?engine=pdflatex\&snip_name=Standalone+TikZ+example\&snip=%5Cdocumentclass%7Bstandalone%7D%0A%5Cusepackage%7Btikz%7D%0A%5Cusetikzlibrary%7Bpositioning%7D%0A%5Cbegin%7Bdocument%7D%0A%0A%5Cbegin%7Btikzpicture%7D%5B%0Aroundnode%2F.style%3D%7Bcircle%2C+draw%3Dgreen%2160%2C+fill%3Dgreen%215%2C+very+thick%2C+minimum+size%3D7mm%7D%2C%0Asquarednode%2F.style%3D%7Brectangle%2C+draw%3Dred%2160%2C+fill%3Dred%215%2C+very+thick%2C+minimum+size%3D5mm%7D%2C%0A%5D%0A%25Nodes%0A%5Cnode%5Bsquarednode%5D++++++%28maintopic%29++++++++++++++++++++++++++++++%7B2%7D%3B%0A%5Cnode%5Broundnode%5D++++++++%28uppercircle%29+++++++%5Babove%3Dof+maintopic%5D+%7B1%7D%3B%0A%5Cnode%5Bsquarednode%5D++++++%28rightsquare%29+++++++%5Bright%3Dof+maintopic%5D+%7B3%7D%3B%0A%5Cnode%5Broundnode%5D++++++++%28lowercircle%29+++++++%5Bbelow%3Dof+maintopic%5D+%7B4%7D%3B%0A%0A%25Lines%0A%5Cdraw%5B-%3E%5D+%28uppercircle.south%29+--+%28maintopic.north%29%3B%0A%5Cdraw%5B-%3E%5D+%28maintopic.east%29+--+%28rightsquare.west%29%3B%0A%5Cdraw%5B-%3E%5D+%28rightsquare.south%29+..+controls+%2B%28down%3A7mm%29+and+%2B%28right%3A7mm%29+..+%28lowercircle.east%29%3B%0A%0A%5Cend%7Btikzpicture%7D%0A%5Cend%7Bdocument%7D)

![CompileSubfilesEx5.png](/files/bc586cce72b1e1d4c66b3bd419de50705e7bcd25)

Bu, **standalone**, içindeki ana özelliktir; bu dosyayı başka herhangi bir belgeye içe aktarabilir ve kodu yeniden kullanabilirsiniz. Örneğin, bu diyagram daha sonra herhangi bir değişiklik yapmadan bir sunumda kullanılabilir.

[Overleaf'te `standalone` paketinin bir örneğini açın](https://www.overleaf.com/project/new/template/19636?id=66440758\&templateName=Standalone+package+example\&latexEngine=pdflatex\&texImage=\&mainFile=)

## Daha fazla okuma

Daha fazla bilgi için bakınız

* [Büyük bir projede yönetim](/latex/tr/belge-yapisi/07-management-in-a-large-project.md)
* [Bölümlere ve denklemlere çapraz referans verme](/latex/tr/belge-yapisi/03-cross-referencing-sections-equations-and-floats.md)
* [Dizinler](/latex/tr/belge-yapisi/04-indices.md)
* [Sözlükler](/latex/tr/belge-yapisi/05-glossaries.md)
* [Köprüler](/latex/tr/belge-yapisi/09-hyperlinks.md)
* [Sayfa numaralandırma](/latex/tr/bicimlendirme/03-page-numbering.md)
* [Tek taraflı ve çift taraflı belgeler](/latex/tr/bicimlendirme/08-single-sided-and-double-sided-documents.md)
* [Çok sütunlu düzen](/latex/tr/bicimlendirme/09-multiple-columns.md)
* [Paragraf biçimlendirme](/latex/tr/bicimlendirme/04-articles-how-to-change-paragraph-spacing-in-latex.md)
* [Sayfa boyutu ve kenar boşlukları](/latex/tr/bicimlendirme/07-page-size-and-margins.md)
* [Sayaçlar](/latex/tr/bicimlendirme/10-counters.md)
* [Kenar notları](/latex/tr/bicimlendirme/15-margin-notes.md)
* [Kalın, italik ve altı çizili](/latex/tr/latex-temelleri/03-bold-italics-and-underlining.md)
* [Yazı tipi boyutları, aileleri ve stilleri](/latex/tr/yazi-tipleri/01-font-sizes-families-and-styles.md)
* [Yazı tipi karakterleri](/latex/tr/yazi-tipleri/02-font-typefaces.md)
* [XeLaTeX ile modern yazı tiplerini destekleme](/latex/tr/yazi-tipleri/03-xelatex.md)
* [Uluslararası dil desteği](/latex/tr/diller/03-international-language-support.md)
* [Yazı tipi boyutları, aileleri ve stilleri](/latex/tr/yazi-tipleri/01-font-sizes-families-and-styles.md)
* [Büyük projeleri derleme](/latex/tr/bilgi-bankasi/038-fixing-and-preventing-compile-timeouts.md#compiling-big-projects)
* [Görseller Ekleme](/latex/tr/daha-fazla-konu/27-inserting-images.md)
* [TikZ paketi](/latex/tr/sekiller-ve-tablolar/05-tikz-package.md)
* [Kendi paketinizi yazmak](/latex/tr/sinif-dosyalari/03-writing-your-own-package.md)
* [Kendi sınıfınızı yazmak](/latex/tr/sinif-dosyalari/04-writing-your-own-class.md)
* [Bu **subfiles** paket dokümantasyonu](http://repositorios.cpai.unb.br/ctan/macros/latex/contrib/subfiles/subfiles.pdf)
* [Bu **standalone** paket dokümantasyonu](http://repositorios.cpai.unb.br/ctan/macros/latex/contrib/standalone/standalone.pdf)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://overleaf-pro.ayaka.space/latex/tr/belge-yapisi/08-multi-file-latex-projects.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
