> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Erişilebilir PDF'ler oluşturma

Zaman içinde PDF oluşturma yeteneklerindeki güncellemeler PDF erişilebilirliğini mümkün kıldı. [LaTeX Tagging Project](https://latex3.github.io/tagging-project/documentation/) gibi atılımlar, LaTeX tabanlı PDF'lerin de erişilebilir olmasını sağladı ve iyileştirmeler sürmeye devam ediyor.

<Check>
  Özellikle [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) sürümü, bu sürecin Overleaf'te mümkün olmasını sağlar. MathML kullanırken önerilen derleyicinin **LuaLaTeX** olduğunu unutmayın.

  [Derleyicileri ve TeX Live sürümlerini değiştirmeyi](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler) öğrenerek projenizin ayarlarının buna uygun şekilde yapılandırıldığından emin olabilirsiniz.
</Check>

Yaklaşımımız büyük ölçüde LaTeX Project'in [erişilebilir PDF talimatlarına](https://latex3.github.io/tagging-project/documentation/usage-instructions) dayanmaktadır; aşağıdaki konular hakkında daha fazla ayrıntı için bu talimatlara başvurabilirsiniz.

<Warning>
  Bu uygulamaları hayata geçirmenin projenizin her öğesinin erişilebilir olacağını garanti etmediğini unutmayın; daha fazla bilgi için bu sayfanın SSS bölümüne bakın.
</Warning>

### <Icon icon="tag" /> Etiketleme

Özünde PDF etiketleme, ekran okuyucular tarafından kolayca tanımlanabilen ve hem bugün hem de gelecekte daha kolay aranabilen bir "yapı"yı otomatik olarak oluşturan bir süreçtir. Ekran okuyucunun başlıklar, gövde metni, şekiller ve denklemler gibi öğeleri birbirinden ayırt edebilmesi için LaTeX kodunuzda tanımlanan mevcut yapıdan yararlanır.

TeX Live 2025, `\DocumentMetaData` bildirimiyle otomatik PDF etiketlerini tam olarak destekler. Bu bildirimi `\documentclass` öncesine ekleyin. Bu bildirimde etiketleme yeteneklerini etkileyen iki önemli anahtar vardır: `tagging` ve `tagging-setup` .

#### **`tagging`**

`tagging` anahtarını `on` olarak ayarlayarak etiketlemenin etkin olduğundan emin olun.

```latex wrap expandable theme={null}
\DocumentMetadata{tagging=on}
```

#### **`tagging-setup`**

`tagging-setup` anahtarının değerini değiştirerek belgenizin nasıl etiketleneceğini yapılandırın.

```latex wrap expandable theme={null}
\DocumentMetadata{tagging=on,tagging-setup={math/setup=mathml-SE}}
```

<Info>
  Bu örnekte MathML Yapı Öğesi etiketlemesi için \`math/setup=mathml-SE\` kullandık, ancak bu değer \[\`\tagpdfsetup\`]\([https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf](https://ctan.math.washington.edu/tex-archive/macros/latex/contrib/tagpdf/tagpdf.pdf)) tarafından desteklenen herhangi bir değere ayarlanabilir.
</Info>

### <Icon icon="text-size" /> Açıklamalar

Otomatik etiketlemeye ek olarak, özellikle belgeniz görseller ve/veya tablolar içeriyorsa, öğelerin içeriğine ilişkin açıklamalar da eklemeniz gerekebilir.

#### <Icon icon="image" /> Görseller

Overleaf'te görseller için hayati önem taşıyan açıklamalar eklemek basittir; bu açıklamalar LaTeX koduna başvururken belirli görsellerin bağlamını anlamaya da yardımcı olabilir. Tek yapmanız gereken, her `\includegraphics` kullanımına ilgili görsel açıklama seçeneğini eklemektir. Erişilebilirlik açısından ayırt edilmesi gereken üç ana görsel türü vardır: alternatif (alt) metin gerektiren görseller, artefaktlar ve gerçek metne karşılık gelen görseller.

**Alternatif metin**

Görsellere alternatif metin eklemek, fotoğrafın görselin metin tabanlı bir ikamesi olarak kullanılabilecek bir açıklamaya sahip olmasını sağlar. `alt` anahtarını kullanın ve bir metin değeri girin.

```latex title="Alt text example" wrap theme={null}
\includegraphics[width=0.25\linewidth,alt={Macro photo of a green frog's head and hands}]{frog.jpg}
```

**Artefaktlar**

Bir görselin ekran okuyucu tarafından algılanması gerekmiyorsa (yani tamamen dekoratifse), görseli bir artefakt olarak işaretleyin. `artifact` anahtarını değer atamadan kullanın.

```latex title="Artifact example" wrap theme={null}
\includegraphics[artifact]{.jpg}
```

**Gerçek metin**

Bir görsel yalnızca bir Unicode karakterinin resmiyse, metin tabanlı karakteri ekleyin. `actualtext` anahtarını kullanın ve ona tek bir karakter atayın (parantez olmadan).

```latex title="Actual text example" wrap theme={null}
\includegraphics[actualtext=B]{.jpg}
```

#### <Icon icon="table" /> Tablolar

Tablolar genellikle kendileriyle ilişkili metinlere sahip olsa da, metnin tablonun doğru bölümleriyle ilişkilendirilmesi yine de önemlidir. Overleaf projenizin tablolarının yapılandırmasına başlamak için `tabular` ortamınızdan önce veya önsözde (preamble) `\tagpdfsetup` ekleyin. Erişilebilirlik açısından ayırt edilmesi gereken iki ana tablo türü vardır: veri tabloları ve sunum tabloları.

**Veri tabloları**

Bir tablonun en az bir başlık satırı varsa, hangi satırların başlık satırı olduğunu belirtin. `table/header-rows` anahtarını kullanın ve başlık satırlarının konumlarına karşılık gelen bir sayı dizisi girin.

```latex title="Data table example" theme={null}
\tagpdfsetup{table/header-rows={1}}
\begin{tabular}{l|r}
Item & Quantity \\\hline
Widgets & 42 \\
Gadgets & 13
\end{tabular}
```

**Sunum tabloları**

Bir tablonun ekran okuyucu tarafından tablo olarak yorumlanması amaçlanmıyorsa, onu sunum tablosu olarak işaretleyin. `table/tagging=presentation` anahtarını kullanın.

```latex title="Presentation table example" theme={null}
\tagpdfsetup{table/tagging=presentation}
\begin{tabular}{cc}
\textbullet & \textbullet \\
''' & '''
\end{tabular}
```

### <Icon icon="comments-question" /> SSS

<Accordion title="Belgemin erişilebilir olduğunu doğrulamaya yardımcı olabilecek araçlar var mı?">
  Evet, PDF/A bölümlerini ve uygunluk düzeylerini doğrulayabilen [veraPDF](https://verapdf.org/) dahil olmak üzere birkaç harici araç vardır. Ayrıca iki renk arasındaki kontrast oranını hesaplamak için [WebAIM](https://webaim.org/) gibi bir araç kullanabilirsiniz.
</Accordion>

<Accordion title="Overleaf projemdeki paketler bu özelliklerle uyumlu mu?">
  LaTeX Tagging Project'in [paket durumu listesine](https://latex3.github.io/tagging-project/tagging-status/) başvurabilirsiniz.
</Accordion>

<Accordion title="`beamer` kullanmaya devam edebilir miyim? Sunumlar için başka paketler var mı?">
  `beamer` kullanımının sınırlamaları vardır; deneysel [`ltx-talk` sınıfına](https://ctan.org/pkg/ltx-talk) göz atın.
</Accordion>

<Accordion title="Overleaf düzenleyicisi erişilebilir mi?">
  Evet. Bir web uygulaması olarak Overleaf, erişilebilirlik uzmanları tarafından düzenli olarak değerlendirilen modern web tarayıcılarının erişilebilirlik özelliklerinden ve işlevlerinden yararlanır. En son tamamlanan [Gönüllü Ürün Erişilebilirlik Şablonumuz (VPAT)](https://www.overleaf.com/for/customers/vpat), Web İçeriği Erişilebilirlik Yönergeleri (WCAG) 2.2 AA Düzeyi ile uygunluğu göstermektedir.
</Accordion>

<Accordion title="Overleaf tarafından üretilen PDF'ler, Engelli Amerikalılar Yasası'nın (ADA) II. Başlığı ve uyumlaştırılmış Avrupa erişilebilirlik standardı (EN 301 549) gereksinimlerini karşılayabilir mi?">
  Evet. Amerika Birleşik Devletleri ve Avrupa'daki mevzuat, PDF'lerin WCAG 2.1 AA'yı karşılamasını gerektirir. WCAG 2.1 AA'yı karşılamak için bir PDF'in etiketli bir PDF olması gerekir. PDF etiketleme desteği TeX Live 2025'te sağlanmaktadır.
</Accordion>

<Accordion title="Overleaf tarafından üretilen PDF'ler PDF/UA-1 standardını karşılayabilir mi?">
  Evet. LaTeX Project'in Tagging Project'i, özellikle PDF/UA-1'in (ve yakında çıkacak PDF/UA-2'nin) gerektirdiği yapısal etiketleri üretmek üzere tasarlanmıştır. Bir kullanıcı LaTeX Project'in güncel etiketleme önerilerini izlerse, fiilen "PDF/UA'ya hazır" bir belge oluşturmuş olur; bu da ABD ve Avrupa mevzuatının gerektirdiği WCAG 2.1 AA yasal zorunluluğunu karşılamanın en güçlü yoludur.
</Accordion>

<Accordion title="Derleyicimi LuaLaTeX'e nasıl geçiririm?">
  LaTeX etiketleme projesi ekibi tarafından önerilen LaTeX derleme motoru LuaLaTeX'e geçmek kolaydır. Overleaf'teki varsayılan derleyici PDFLaTeX olsa da [proje ayarlarınızdan LuaLaTeX'e geçebilirsiniz](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Accordion>

<Accordion title="TeX Live'ın en son sürümünü nereden seçebilirim?">
  En son sürümü, PDF etiketleme desteğindeki en son gelişmeler dahil olmak üzere Overleaf'teki "rolling TeX Live" imajına erişim sağlayan [Overleaf Labs](https://www.overleaf.com/labs/participate) üzerinden edinebilirsiniz. Bu deneysel TeX Live sürümü öncelikle TeX Live'daki ve paketlerdeki değişiklikleri test etmek ve yeni erişilebilirlik özelliklerini yıllık TeX Live sürümümüze dahil edilmeden önce önizlemek içindir.

  PDF etiketleme özelliklerinin çoğu standart [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) imajında mevcuttur.
</Accordion>

[^1]: Otomatik etiketleme etkinleştirilmiştir.

[^2]: Etiketleme yapılandırması ayarlanmıştır.

[^3]: Görselin alternatif metni vardır.

[^4]: Görsel bir artefakttır.

[^5]: Görsel bir karakterdir.

[^6]: Tablonun bir başlık satırı vardır.

[^7]: Tablo bir sunum tablosudur.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.