> ## 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.

# Membuat PDF yang aksesibel

Seiring waktu, pembaruan pada kemampuan pembuatan PDF telah memungkinkan aksesibilitas PDF. Kemajuan seperti [LaTeX Tagging Project](https://latex3.github.io/tagging-project/documentation/) telah memungkinkan PDF berbasis LaTeX juga menjadi aksesibel, dan peningkatan terus berlangsung.

<Check>
  Rilis [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available), khususnya, adalah yang membuat proses ini dimungkinkan di Overleaf. Perhatikan bahwa **LuaLaTeX** adalah compiler yang direkomendasikan saat menggunakan MathML.

  Anda dapat memastikan pengaturan proyek Anda telah disiapkan dengan benar dengan mempelajari cara [mengubah compiler dan versi TeX Live](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Check>

Pendekatan kami sebagian besar didasarkan pada [petunjuk PDF aksesibel](https://latex3.github.io/tagging-project/documentation/usage-instructions) dari LaTeX Project, yang dapat Anda rujuk untuk detail lebih lanjut tentang topik-topik berikut.

<Warning>
  Perhatikan bahwa menerapkan praktik-praktik ini tidak menjamin bahwa setiap elemen proyek Anda aksesibel—lihat bagian FAQ di halaman ini untuk informasi lebih lanjut.
</Warning>

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

Pada dasarnya, tagging PDF adalah proses yang secara otomatis membuat "struktur" yang mudah dikenali oleh pembaca layar (screen reader), dan lebih mudah dicari baik sekarang maupun di masa mendatang. Proses ini memanfaatkan struktur yang sudah didefinisikan oleh kode LaTeX Anda sehingga pembaca layar dapat membedakan elemen-elemen seperti judul, teks isi, gambar, dan persamaan.

TeX Live 2025 sepenuhnya mendukung tag PDF otomatis dengan deklarasi `\DocumentMetaData`. Tambahkan deklarasi ini sebelum `\documentclass`. Ada dua key penting dalam deklarasi ini yang memengaruhi kemampuan tagging: `tagging` dan `tagging-setup` .

#### **`tagging`**

Pastikan tagging diaktifkan dengan mengatur key `tagging` ke `on`.

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

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

Konfigurasikan cara dokumen Anda diberi tag dengan mengubah nilai key `tagging-setup`.

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

<Info>
  Dalam contoh ini, kami menggunakan \`math/setup=mathml-SE\` untuk tagging MathML Structure Element, tetapi nilainya dapat diatur ke nilai apa pun yang didukung oleh \[\`\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)).
</Info>

### <Icon icon="text-size" /> Deskripsi

Selain tagging otomatis, Anda mungkin juga perlu menambahkan deskripsi konten elemen, terutama jika dokumen Anda berisi gambar dan/atau tabel.

#### <Icon icon="image" /> Gambar

Menambahkan deskripsi penting untuk gambar di Overleaf sangatlah mudah, dan hal ini juga dapat membantu memahami konteks gambar tertentu saat merujuk kode LaTeX. Yang perlu Anda lakukan hanyalah menambahkan opsi deskripsi gambar yang terkait pada setiap `\includegraphics`. Ada tiga jenis utama gambar yang perlu dibedakan untuk aksesibilitas: gambar yang memerlukan teks alternatif (alt), artefak, dan gambar yang mewakili teks sebenarnya.

**Teks alt**

Menambahkan teks alternatif pada gambar memastikan bahwa foto memiliki deskripsi yang dapat digunakan sebagai pengganti berbasis teks untuk visual tersebut. Gunakan key `alt` dan masukkan nilai teks.

```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}
```

**Artefak**

Jika sebuah gambar tidak perlu dibaca oleh pembaca layar (misalnya, jika gambar tersebut murni dekorasi), tandai gambar tersebut sebagai artefak. Gunakan key `artifact` tanpa memberikan nilai.

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

**Teks sebenarnya**

Jika sebuah gambar hanya berupa gambar dari satu karakter Unicode, sertakan karakter berbasis teksnya. Gunakan key `actualtext` dan berikan satu karakter (tanpa tanda kurung).

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

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

Meskipun tabel biasanya memiliki teks yang terkait, tetap penting agar teks tersebut dikaitkan dengan bagian tabel yang benar. Tambahkan `\tagpdfsetup` sebelum `tabular` Anda atau di preamble untuk mulai menyiapkan tabel-tabel di proyek Overleaf Anda. Ada dua jenis utama tabel yang perlu dibedakan untuk aksesibilitas: tabel data dan tabel presentasi.

**Tabel data**

Jika sebuah tabel memiliki setidaknya satu baris header, tentukan baris mana yang merupakan baris header. Gunakan key `table/header-rows` dan masukkan serangkaian angka yang sesuai dengan lokasi baris header.

```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}
```

**Tabel presentasi**

Jika sebuah tabel tidak dimaksudkan untuk ditafsirkan sebagai tabel oleh pembaca layar, tandai tabel tersebut sebagai tabel presentasi. Gunakan key `table/tagging=presentation`.

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

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

<Accordion title="Apakah ada alat yang dapat membantu memverifikasi bahwa dokumen saya aksesibel?">
  Ya, ada beberapa alat eksternal, termasuk [veraPDF](https://verapdf.org/), yang dapat memvalidasi bagian PDF/A dan tingkat kesesuaiannya. Selain itu, Anda dapat menggunakan alat seperti [WebAIM](https://webaim.org/) untuk menghitung rasio kontras antara dua warna.
</Accordion>

<Accordion title="Apakah paket-paket di proyek Overleaf saya kompatibel dengan fitur-fitur ini?">
  Anda dapat merujuk ke [daftar status paket](https://latex3.github.io/tagging-project/tagging-status/) dari LaTeX Tagging Project.
</Accordion>

<Accordion title="Apakah saya masih bisa menggunakan `beamer`? Apakah ada paket lain yang tersedia untuk presentasi?">
  Ada keterbatasan dalam menggunakan `beamer`; lihat [kelas `ltx-talk`](https://ctan.org/pkg/ltx-talk) yang masih eksperimental.
</Accordion>

<Accordion title="Apakah editor Overleaf aksesibel?">
  Ya. Sebagai aplikasi web, Overleaf memanfaatkan fitur dan fungsi aksesibilitas browser web modern yang secara rutin dinilai oleh para ahli aksesibilitas. [Voluntary Product Accessibility Template (VPAT)](https://www.overleaf.com/for/customers/vpat) terbaru kami yang telah diselesaikan menunjukkan kesesuaian dengan Web Content Accessibility Guidelines (WCAG) 2.2 Level AA.
</Accordion>

<Accordion title="Dapatkah PDF yang dihasilkan oleh Overleaf memenuhi persyaratan Title II dari Americans with Disability Act (ADA) dan standar aksesibilitas Eropa yang diharmonisasi (EN 301 549)?">
  Ya. Peraturan perundang-undangan di Amerika Serikat dan Eropa mewajibkan PDF memenuhi WCAG 2.1 AA. Untuk memenuhi WCAG 2.1 AA, sebuah PDF harus berupa PDF yang diberi tag. Dukungan untuk tagging PDF tersedia di TeX Live 2025.
</Accordion>

<Accordion title="Dapatkah PDF yang dihasilkan oleh Overleaf memenuhi standar PDF/UA-1?">
  Ya. Tagging Project dari LaTeX Project secara khusus dirancang untuk menghasilkan tag struktural yang diwajibkan oleh PDF/UA-1 (dan PDF/UA-2 yang akan datang). Jika pengguna mengikuti rekomendasi tagging terkini dari LaTeX Project, mereka secara efektif membangun dokumen yang "siap PDF/UA", yang merupakan cara terkuat untuk memenuhi mandat hukum WCAG 2.1 AA yang diwajibkan oleh peraturan perundang-undangan AS dan Eropa.
</Accordion>

<Accordion title="Bagaimana cara mengganti compiler saya ke LuaLaTeX?">
  Beralih ke LuaLaTeX, mesin kompilasi LaTeX yang direkomendasikan oleh tim LaTeX tagging project, sangatlah mudah. Meskipun compiler default di Overleaf adalah PDFLaTeX, Anda dapat [beralih ke LuaLaTeX di pengaturan proyek Anda](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Accordion>

<Accordion title="Di mana saya dapat memilih versi TeX Live terbaru?">
  Anda bisa mendapatkan versi terbaru di [Overleaf Labs](https://www.overleaf.com/labs/participate), yang menyediakan akses ke image "rolling TeX Live" di Overleaf, termasuk dukungan tagging PDF terbaru. Versi TeX Live eksperimental ini terutama ditujukan untuk menguji perubahan pada TeX Live dan paket-paket, serta mencoba fitur aksesibilitas baru sebelum dimasukkan ke dalam rilis TeX Live tahunan kami.

  Sebagian besar fitur tagging PDF tersedia di image standar [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available).
</Accordion>

[^1]: Tagging otomatis diaktifkan.

[^2]: Konfigurasi tagging telah diatur.

[^3]: Gambar memiliki teks alternatif.

[^4]: Gambar merupakan artefak.

[^5]: Gambar merupakan sebuah karakter.

[^6]: Tabel memiliki satu baris header.

[^7]: Tabel merupakan tabel presentasi.


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