> 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/bilgi-bankasi/033-cross-referencing-with-the-xr-package-in-overleaf.md).

# Overleaf'te xr paketiyle çapraz referans verme

## Genel Bakış

Bu [`xr` paketini](https://ctan.org/pkg/xr?lang=en) harici LaTeX belgelerinde yer alan denklemlere, şekillere, tablolara vb. çapraz başvuru yapmanıza olanak tanır; yeter ki bu belgeler *bağımsız olsun.* Bağımsız bir LaTeX belgesi, içinde bir `\documentclass{...}` bildirimi ve `\begin{document}`...`\end{document}` yapısı

### Kullanım özeti

1. Yazın `\usepackage{xr}` harici LaTeX dosyalarında yer alan içeriğe çapraz başvuru yapması gereken LaTeX dosyasının önsöz kısmına.
2. Şunu kullanın `xr` paket komutu `\externaldocument{filename}` ile, çapraz başvuru yapmak istediğiniz harici belge(leri) belirtin.

Bu `xr` paketi, içinde bulunan çapraz başvuru etiketlerini kullanarak çalışır `.aux` harici LaTeX belgeleri derlendiğinde oluşturulan dosyalardan.

### Çapraz başvurunun nasıl çalıştığı (kısa özet)

Bir LaTeX belgesindeki bir öğeye çapraz başvuru yapmak için şunları yapmanız gerekir:

1. Ona benzersiz bir tanımlayıcı verin, `some_string`, kullanarak `\label` komutuyla:

```latex
\label{some_string}
```

3. O öğeye başvurmak istediğiniz yere

```latex
\ref{some_string}
```

Çok kısaca söylemek gerekirse, LaTeX çapraz başvuruyu `filename.aux` burada `filename` ana `.tex` dosyasının derlendiği adıdır.

Sürecin çalışması için LaTeX belgesinin en az iki kez derlenmesi gerekir: ilk derleme *oluşturur* başvuru verisini—bunu `filename.aux`. dosyasına yazar. İkinci derleme sırasında LaTeX *okur* `filename.aux` başvuruları çözümlemek için; böylece `\ref{some_string}`.

* Çapraz başvuru hakkında daha fazla ayrıntı için Overleaf makalesine bakın [Bölümlere, denklemlere ve yüzen öğelere çapraz başvuru](/latex/tr/belge-yapisi/03-cross-referencing-sections-equations-and-floats.md).

## xr paketinin gerekli olmadığı projeler

Kitaplar veya uzun raporlar gibi büyük LaTeX projeleri, çoğu zaman bir dizi daha küçük `.tex` dosyaya bölünür; her bölüm için bir dosya olmak üzere ve her bölümün `.tex` dosyası ana LaTeX belgesine `\input` ya da `\include`kullanılarak eklenir. Genellikle bu bölümler bağımsız değildir: ayrı bölümleri derleyemezsiniz çünkü içinde bir `\documentclass{...}` bildirim ya da `\begin{document}...\end{document}` yapısı bulunmaz. Bu bölümler, *eklenmek* üzere bir “kapsayıcı” belgeye yöneliktir; bu belge *derlenebilir. Bu durumlarda, herhangi bir bölüm dosyasındaki belge öğelerine çapraz başvuru normal şekilde yapılabilir:* paketini kullanmanız gerekmez. `xr` paketi.

Büyük bir proje örneğini incelemek için [bu örneği Overleaf'te açabilirsiniz.](https://www.overleaf.com/project/new/template/20618?id=70769185\&templateName=Managing+a+large+project+on+Overleaf\&latexEngine=pdflatex\&texImage=texlive-full%3A2020.1\&mainFile=)

## xr paketinin gerekli olduğu bir proje örneği

Aşağıdaki gibi, bağımsız LaTeX belgelerinden oluşan bir kümeniz olduğunu varsayalım: N makaleden oluşan bir koleksiyon: `article1.tex`, `article2.tex` ... `articleN.tex`. Bu makalelerin her biri ayrı ayrı derlenebilir ve büyük olasılıkla farklı belge sınıfları, paketler vb. kullanılarak yazılmışlardır.

Şimdi bu makalelerin bir genel bakışını ya da özetini LaTeX kullanarak yazmak istediğinizi düşünün—dosyamıza `summary.tex`adını vereceğiz. Özetimizin, bu bağımsız N makalenin her birinde yer alan bölümlere, şekillere, tablolara, denklemlere vb. başvurması gerekiyor. Bunu nasıl yapabiliriz?

Bu `xr` paketi bunu yapmanıza olanak tanır: `summary.tex` herhangi bir bağımsız belge tarafından oluşturulan başvuru etiketlerini kullanmasına `article*.tex` .bib dosyalarını.

### .aux dosyaları hakkında bir not

* Not: burada 1'den N'ye kadar herhangi bir sayının yerini tutan bir joker karakter (`*`) kullanıyoruz.

Bağımsız dosyalardan herhangi birini derlemek `article1.tex`, `article2.tex` ... `articleN.tex` LaTeX'in karşılık gelen bir `article*.aux` (\*\*`aux`\*\*illary) dosyası oluşturmasına neden olur; bu dosya, diğer öğelerin yanı sıra, çapraz başvurular oluşturmak için gerekli etiket verilerini içerir.

Eğer `article*.tex` dosyalardan herhangi biri düzenlenirse—örneğin etiketleri değiştirmek, eklemek veya kaldırmak için (`\label{...}`)—ilgili `article*.tex` dosya(lar)ın ilişkili veriyi güncellemek için yeniden derlenmesi gerekir `article*.aux` dosya(lar)ında.

değişiklikleri algılamak `article*.tex`ve ardından bunları yeniden derlemek, Overleaf'te uygun bir `latexmkrc` dosyasında.

## Overleaf'te xr nasıl kullanılır

Birden fazla makaleden oluşan örneğimizin basitleştirilmiş bir sürümünü kullanacağız; özellikle, derleme sürecinin bir `latexmkrc` dosya [John Collins tarafından Overleaf'e sağlanan](#code-for-latexmkrc) ([bakımını yapan kişi `latexmk`](https://ctan.org/pkg/latexmk?lang=en)).

### Örneğimizde kullanılan dosyalar

Örneğimiz aşağıdaki dosyaları kullanır:

* `**summary.tex**`bu bizim genel bakış belgemizdir. Bunun, içinde yer alan içeriğe başvurmasını istiyoruz `article1.tex`örneğin şekiller ve bölümler gibi.
  * `summary.tex` paketi yükler ve `xr` paketini kullanır `\externaldocument{article1}` ile, `article1.aux` dosyasındaki başvuru verisinin kullanılması gerektiğini belirtir.
* `**article1.tex**`: iç çapraz başvurular içeren tek bir bağımsız makale. Derleme `article1.tex` tarafından içerilen çapraz başvuru verisini oluşturur `article1.aux`.
  * Örneğin `article1.tex` gibi, başka biri tarafından yazılmış olabilecek harici bir dosya—sizden “olduğu gibi”, yani değiştirilmeden kullanmanız için.
* `**latexmkrc**`: yeniden derlemeyi otomatikleştirmek için kod (Perl) içerir `article1.tex` üzerindeki herhangi bir değişiklik nedeniyle—güncellenmiş bir `article1.aux` dosyasında.
  * Bizim `latexmkrc` dosyamız [John Collins tarafından Overleaf'e sağlanan](#code-for-latexmkrc) ([bakımını yapan kişi `latexmk`](https://ctan.org/pkg/latexmk?lang=en)).

### \externaldocument komutu hakkında

Bu `xr` paketi`\externaldocument` komutunu sağlar; bunun genel biçimi şöyledir

```latex
\externaldocument[prefix]{external_file}
```

* **`prefix` (isteğe bağlı):** Bu isteğe bağlı argüman, harici belgeden içe aktarılan tüm etiketlere eklenecek bir önek tanımlamanıza olanak tanır. Aynı etiket adları birden fazla belgede kullanılıyorsa çakışmaları önlemek için bu yararlıdır.
* **`external_file` (gerekli):** Bu gerekli argüman, başvuruları içe aktarmak istediğiniz harici LaTeX belgesinin adını ( `.tex` uzantısı olmadan) belirtir.  `xr` paketi, etiketleri almak için `.aux` dosyasını arar `external_file` (örneğin, `external_file.aux`) ile eşleşen

Örnek olarak, ana `.tex` dosya `summary.tex` ve harici dosya, `article1.tex` ikisi de şu etiketi içeriyorsa `\label{eq:1}` o zaman bir etiket adı çakışması yaşarız. Bu çakışma şu şekilde yazılarak önlenebilir

```latex
\externaldocument[art1-]{article1}
```

bu durumda derlenerek oluşturulan tüm etiketlerin önüne `article1.tex` art1- `eklenir.`Artık `\label{eq:1}`, içinde yer alan `article1.tex`, öğesine `\ref{art1-eq:1}` içine `summary.tex`.

### Proje dosyaları

#### article1.tex

Aşağıdaki kod, listelemenin altındaki bağlantı kullanılarak Overleaf'te açılabilir.

```latex
\documentclass{article}
\title{Bu \texttt{article1.tex}}
\begin{document}
\section{Giriş}
\label{introduction}

Bu, içinde bulunan bağımsız bir \LaTeX{} belgesidir
\texttt{summary.tex} içinde kullanmak istediğimiz başvurular.

\subsection{Matematik başvuruları}
\label{mathrefs}
\ref{introduction} bölümünde belirtildiği gibi,
bir belge içinde farklı öğelere başvurulabilir.
bir belge.

\subsection{Kuvvet serileri}
\label{powers}

\begin{equation}
\label{eq:1}
\sum_{i=0}^{\infty} a_i x^i
\end{equation}

\ref{eq:1} denklemi tipik bir kuvvet serisidir.
\end{document}
```

[Açın `article1.tex` Overleaf'te](https://www.overleaf.com/docs?engine=%5B%5B%3ATemplate%3AEngine%5D%5D}\&snip_name\[]=readme.txt\&snip\[]=A+project+created+from+the+Overleaf+wiki\&snip_name\[]=article1.tex\&main_document=article1.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Ctitle%7BThis+is+%5Ctexttt%7Barticle1.tex%7D%7D%0A%5Cbegin%7Bdocument%7D%0A%5Csection%7BIntroduction%7D%0A%5Clabel%7Bintroduction%7D%0A%0AThis+is+a+standalone+%5CLaTeX%7B%7D+document+with%0Areferences+we+want+to+use+in+%5Ctexttt%7Bsummary.tex%7D.%0A%0A%5Csubsection%7BMath+references%7D%0A%5Clabel%7Bmathrefs%7D%0AAs+mentioned+in+section+%5Cref%7Bintroduction%7D%2C+%0Adifferent+elements+can+be+referenced+within%0Aa+document.%0A%0A%5Csubsection%7BPowers+series%7D%0A%5Clabel%7Bpowers%7D%0A%0A%5Cbegin%7Bequation%7D%0A%5Clabel%7Beq%3A1%7D%0A%5Csum_%7Bi%3D0%7D%5E%7B%5Cinfty%7D+a_i+x%5Ei%0A%5Cend%7Bequation%7D%0A%0AEquation+%5Cref%7Beq%3A1%7D+is+a+typical+power+series.%0A%5Cend%7Bdocument)

Derleme `article1.tex` aşağıdaki çıktıyı üretir:

![Overleaf'te article1.tex dosyasını derleyince üretilen çıktı](/files/0ed76353fb39efc3ae4d5d508947e41f978dc2a6)

#### summary.tex

İşte başlangıçtaki `summary.tex` dosya *önce* hangi harici belgeye başvurmak istediğimizi belirtmiş olduk. Basitlik için, `summary.tex` herhangi bir `\label` komutu içermez çünkü iç çapraz başvuru yoktur. Tüm `\ref` komutları tarafından oluşturulan etiketlere başvurur `\label` içeren komutlar `article1.tex`.

```latex
\documentclass{article}
\usepackage{xr}
\title{Bu \texttt{summary.tex}}
\begin{document}
\texttt{article1.tex} dosyasında, giriş bölümü \ref{introduction} bölümüdür. O dosyada iki alt bölüm vardır: \ref{mathrefs} ve \ref{powers}. \ref{powers} alt bölümünde, \ref{eq:1} denklemi bir kuvvet serisini gösterir.
\end{document}
```

[Bunu açın *eksik* `summary.tex` Overleaf'te](https://www.overleaf.com/docs?engine=%5B%5B%3ATemplate%3AEngine%5D%5D}\&snip_name\[]=readme.txt\&snip\[]=A+project+created+from+the+Overleaf+wiki\&snip_name\[]=summary.tex\&main_document=summary.tex\&snip\[]=%5Cdocumentclass%7Barticle%7D%0A%5Cusepackage%7Bxr%7D%0A%5Ctitle%7BThis+is+%5Ctexttt%7Bsummary.tex%7D%7D%0A%5Cbegin%7Bdocument%7D%0AIn+the+file+%5Ctexttt%7Barticle1.tex%7D%2C+the+introduction+is+section+%5Cref%7Bintroduction%7D.++In+that+file%2C+there+are+two+subsections%3A+%5Cref%7Bmathrefs%7D+and+%5Cref%7Bpowers%7D.+In+subsection+%5Cref%7Bpowers%7D%2C+equation+%5Cref%7Beq%3A1%7D+demonstrates+a+power+series.%0A%5Cend%7Bdocument%7D)

Bu sürümünü derlersek `summary.tex` şuradan başvuru verisini okumaya çalışacaktır `summary.aux` ancak gerekli veri harici dosyada yer alır `article1.aux` ki buna henüz erişilemez.

Bu eksik `summary.tex` dosyasını derlemek, tanımsız başvuruların çift soru işaretiyle gösterildiği aşağıdaki çıktıyı üretir:

![Eksik başvuruları bildiren görsel](/files/42de7b463bbb5639c26b64b2a6138d7539a8e267)

### Harici belgeyi belirtme

Bir sonraki adım `article1` etiketlerine başvurmak istediğimiz harici belgenin adı olarak belirtmektir. Aşağıdaki satırı `summary.tex`:

```latex
\externaldocument{article1}
```

Burada, `article1` etiketlerine erişmek istediğiniz herhangi bir dosya ile değiştirilebilir—you can use multiple `\externaldocument` ek harici dosyalara erişmek için komutları kullanabilirsiniz.

### latexmkrc dosyasını oluşturma

Bir sonraki adım, aşağıda gösterildiği gibi bir `latexmkrc` dosyası oluşturmaktır:

* Proje düzenleyici penceresinde, projenin pencerenin sol üst kısmındaki **Yeni Dosya** simgesini seçin.
* Şunu seçin **Yeni Dosya** içinden **Dosya Ekle** açılır iletişim kutusunu açın ve dosyaya `latexmkrc`adını verin—dosya uzantısı olmadığını unutmayın:

![Overleaf'te bir latexmkrc dosyası oluşturma](/files/2c0cd39b533b1f457d254829a5b1f973e77faeb6)

* Şuna dikkat edin `latexmkrc` dosyasının projenin dosya alanının en üst (kök) düzeyinde oluşturulup kaydedilmesi gerekir. Yani, dosya ağacındaki herhangi bir klasörün içinde olmamalıdır.
* Aşağıdaki kodu kendi `latexmkrc` dosyasında.

#### latexmkrc için kod

Overleaf, John Collins'e [bakımını yapan kişi `latexmk`](https://ctan.org/pkg/latexmk?lang=en), bize aşağıdaki dosyayı sağlamak üzere bizimle iletişime geçtiği için minnettardır `latexmkrc` dosyayı tam olarak yayımlamaktan memnuniyet duyuyoruz—son derece faydalı satır içi yorumlar da dahil.

```perl
# Bu, xr paketinin latexmk ile nasıl kullanılacağını gösterir.
# John Collins 2023-03-29
#
# xr paketi (“eXternal References için bir sistem”) bir belge tarafından kullanılır
# diğer harici belgelerdeki bölümlere, denklemlere vb. başvuru yapmak için
# belgeler.
# Bu dosyadaki tanımlar, latexmk'nin latexmk'yi uygulamasını sağlar
# .tex dosyası değiştiğinde bir harici belgeyi otomatik olarak güncellemek için,
# böylece ana belgedeki başvurular güncel kalır.

# Notlar:
#    1. Bu sürüm, derlemelerden elde edilen dosyaları
#       harici belgelerin dosyalarını belirlenmiş bir alt dizine koyacak şekilde tanımlanmıştır; böylece
#       olası çok sayıda oluşturulan dosyayı ana belgenin
#       dizinlerinden ayırır.
#    2. Ancak burada olduğu gibi latexmk'nin özel bağımlılık mekanizmasının kullanılabilmesi için,
#       bir alt belgenin derlenmesinden oluşan aux dosyası
#       kaynak .tex dosyasıyla aynı dizinde oluşturulmalıdır.  Bu yüzden
#       .aux dosyası kopyalanır.
#    3. Harici belgelerin pdflatex ile derleneceği varsayılmıştır.
#       Elbette bu, çağrılan latexmk'ye verilen '-pdf'
#       seçeneğini gereken başka bir şeyle değiştirerek değiştirilebilir.
#    4. İdeal bir uygulama, bir
#       harici belgenin yeniden derlenmesinin, diğer kaynak
#       dosyalarından herhangi biri değiştiğinde de gerçekleşmesini sağlar. Ancak bu, mevcut sürümde yapılmamıştır ve
#       muhtemelen ya dahili latexmk değişkenlerinin kullanılmasını ya da latexmk'ye ek geliştirmeler yapılmasını gerektirir.
#       latexmk'den File::Copy ve File::Basename Perl paketleri tarafından yüklenen
#    5. Kod, copy ve fileparse alt yordamlarını kullanır
#       latexmk tarafından
#    6. Ayrıca latexmk'nin henüz belgelenmemiş bazı özelliklerini kullanır: bir dizi
#       değişken @file_not_found ve popd, pushd ve
#       rdb_add_generated alt yordamları.

#--------------------
# Harici belgelerin derlenmesi için yapılandırılabilir seçimler

# Harici belgelerin derlenmesinden çıkan çıktı dosyaları için alt dizin:
$sub_doc_output = 'output-subdoc';

# Harici belgelerin derlenmesi için latexmk'ye verilecek seçenekler:
@sub_doc_options = ();

push @sub_doc_options, '-pdf'; # Harici belgelerin derlenmesi için pdflatex kullanın.
# Gerekirse '-pdf' yerine '-pdfdvi', 'pdfxe' veya 'pdflua' kullanın.

#--------------------

# xr'nin eksik dosyalara ilişkin günlük dosyası iletisi için bir desen ekleyin
# latexmk'nin listesine.  Latexmk'nin @file_not_found değişkeni henüz belgelenmemiştir.
# Bu satır latexmk'nin v. 4.80 veya sonraki sürümleri için gerekli değildir.
push @file_not_found, '^No file\\s*(.+)\s*$';

add_cus_dep( 'tex', 'aux', 0, 'makeexternaldocument' );
sub makeexternaldocument {
    if ( $root_filename ne $_[0] )  {
        my ($base_name, $path) = fileparse( $_[0] );
        pushd $path;
        my $return = system "latexmk",
                            @sub_doc_options,
                            "-aux-directory=$sub_doc_output",
                            "-output-directory=$sub_doc_output",
                            $base_name;
        if ( ($sub_doc_output ne '') && ($sub_doc_output ne '.') ) {
               # Bu durumda, pdflatex tarafından oluşturulan .aux dosyası aynı
               # dizinde değildir .tex dosyasıyla.
               # Bu nedenle:
               # 1. Gerçek oluşturulan aux dosyası, bu kural tarafından üretilmiş olarak listelenmelidir,
               #    böylece latexmk bağımlılıkları doğru şekilde ele alır.
               #    (Aşılması gereken sorun: Eğer $sub_dir_output, ana belge için
               #    $aux_dir ile aynıysa, xr .aux dosyasını
               #    latexmk'nin üretmiş varsaydığı cus dep ile aynı olan aux_dir içinde okuyabilir,
               #    bu özel bağımlılık için .tex kaynak
               #    dosyasıyla aynı dizinde olan dosya.)
               #    Bunu yapmak için henüz belgelenmemiş latexmk alt yordamı rdb_add_generated'ı kullanın:
               # 2. .aux dosyasının bir kopyası, .tex dosyasıyla aynı dizinde olmalıdır
               #    latexmk'nin özel bağımlılık tanımını karşılamak için.
               #    
             rdb_add_generated( "$sub_doc_output/$base_name.aux" );
             copy "$sub_doc_output/$base_name.aux", ".";
        }
        popd;
        return $return;
   }
}
```

### xr'yi gösteren bir Overleaf projesini açın

Aşağıdaki üç dosyalı proje artık yukarıda ve dosya listelerinin altında verilen bağlantılar kullanılarak Overleaf'te açılabilir. Şuna dikkat edin ki, `latexmkrc` dosyası John Collins tarafından sağlanan kodu içerir; ancak kısalık için yorumların çoğu kaldırılmıştır.

[Bu üç dosyalı örneği Overleaf'te açın.](/latex/tr/bilgi-bankasi/033-cross-referencing-with-the-xr-package-in-overleaf.md)

**summary.tex**

Bu bizim özet dosyamızdır. Bu dosyanın içinden harici dosyalarda oluşturulan çapraz başvuruları kullanmak istiyoruz. Burada, `article1.tex`.

```latex
\documentclass[12pt]{article}
\usepackage{xr}

\title{Overleaf'te xr paketini kullanma}
% tüm harici belgeleri buraya koyun!
\externaldocument{article1}

\begin{document}

\texttt{article1.tex} dosyasında, giriş bölümü \ref{introduction} bölümüdür. O dosyada iki alt bölüm vardır: \ref{mathrefs} ve \ref{powers}. \ref{powers} alt bölümünde, \ref{eq:1} denklemi bir kuvvet serisini gösterir.

\end{document}
```

**article1.tex**

Bu dosya makalelerimizden biridir. İçinde çeşitli `\label` komutların bulunduğuna dikkat edin; bunlar etiketler oluşturur ve bunları, `xr` paketi sayesinde, `summary.tex`.

```latex
\documentclass{article}
\title{Bu \texttt{article1.tex}}
\begin{document}
\section{Giriş}
\label{introduction}

Bu, içinde bulunan bağımsız bir \LaTeX{} belgesidir
\texttt{summary.tex} içinde kullanmak istediğimiz başvurular.

\subsection{Matematik başvuruları}
\label{mathrefs}
\ref{introduction} bölümünde belirtildiği gibi,
bir belge içinde farklı öğelere başvurulabilir.
bir belge.

\subsection{Kuvvet serileri}
\label{powers}

\begin{equation}
\label{eq:1}
\sum_{i=0}^{\infty} a_i x^i
\end{equation}

\ref{eq:1} denklemi tipik bir kuvvet serisidir.
\end{document}
```

**latexmkrc**

Bu `latexmkrc` dosya, harici dosyaların derlenmesini sağlamak için kod içerir.

```latex
$sub_doc_output = 'output-subdoc';

@sub_doc_options = ();

push @sub_doc_options, '-pdf'; # Harici belgelerin derlenmesi için pdflatex kullanın.
# Gerekirse '-pdf' yerine '-pdfdvi', 'pdfxe' veya 'pdflua' kullanın.

push @file_not_found, '^No file\\s*(.+)\s*$';

add_cus_dep( 'tex', 'aux', 0, 'makeexternaldocument' );
sub makeexternaldocument {
    if ( $root_filename ne $_[0] )  {
        my ($base_name, $path) = fileparse( $_[0] );
        pushd $path;
        my $return = system "latexmk",
                            @sub_doc_options,
                            "-aux-directory=$sub_doc_output",
                            "-output-directory=$sub_doc_output",
                            $base_name;
        if ( ($sub_doc_output ne '') && ($sub_doc_output ne '.') ) {

             rdb_add_generated( "$sub_doc_output/$base_name.aux" );
             copy "$sub_doc_output/$base_name.aux", ".";
        }
        popd;
        return $return;
   }
}
```

[Bu üç dosyalı örneği Overleaf'te açın.](/latex/tr/bilgi-bankasi/033-cross-referencing-with-the-xr-package-in-overleaf.md)

Aşağıdaki grafik, typeset edilen çıktının açıklamalı bir sürümüdür `summary.tex`, harici dosyadan gelen çapraz başvuruları ve ilgili etiketleri gösterir `article1.tex`.

![Harici bir dosyadan içe aktarılan başvuruların gösterimi](/files/605dd52d85c012a96d86b6ed94cb575085c7d3f4)

* Çapraz başvuru hakkında daha fazla ayrıntı için Overleaf makalesine bakın [Bölümlere, denklemlere ve yüzen öğelere çapraz başvuru](/latex/tr/belge-yapisi/03-cross-referencing-sections-equations-and-floats.md).

## Sözdizimi hataları hakkında bir not

Ana proje dosyanız için Overleaf'in [İlk Hata Durdu derleme modunu](/latex/tr/bilgi-bankasi/149-using-the-stop-on-first-error-compilation-mode.md) kullanarak derlemenin ilk hata algılanır algılanmaz hemen sonlanmasını sağlayabilirsiniz. Bu, kodunuzdaki hataları izole etmeye ve belirlemeye yardımcı olabilir; hataların zincirleme şekilde büyümesine izin vermek yerine sorunları bulmayı ve ayıklamayı çok daha zor hale getirir.

Bu *harici* belgeler otomatik olarak `latexmkrc` dosyası aracılığıyla derlenir; dolayısıyla içlerindeki herhangi bir LaTeX sözdizimi hatası Overleaf arayüzünde görünmez—onları Overleaf'te de yeniden derlemediğiniz sürece. Bu harici dosyalardaki hatalar, çapraz başvuruların dizgiye alınmış PDF dosyasında doğru şekilde görünmesini engelleyebilir; bu nedenle bu tür hataları oluşur oluşmaz kontrol edip düzeltmenizi şiddetle öneririz.


---

# 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/bilgi-bankasi/033-cross-referencing-with-the-xr-package-in-overleaf.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.
