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

# Tạo PDF có khả năng tiếp cận

Theo thời gian, những cải tiến trong khả năng tạo PDF đã giúp việc tạo PDF có khả năng tiếp cận (accessibility) trở nên khả thi. Những bước tiến, bao gồm [LaTeX Tagging Project](https://latex3.github.io/tagging-project/documentation/), đã giúp các tệp PDF dựa trên LaTeX cũng có khả năng tiếp cận, và các cải tiến vẫn đang tiếp tục.

<Check>
  Đặc biệt, việc phát hành [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) là điều giúp quy trình này trở nên khả thi trong Overleaf. Lưu ý rằng **LuaLaTeX** là trình biên dịch được khuyến nghị khi sử dụng MathML.

  Bạn có thể đảm bảo thiết lập dự án của mình được cấu hình phù hợp bằng cách tìm hiểu cách [thay đổi trình biên dịch và phiên bản TeX Live](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Check>

Cách tiếp cận của chúng tôi phần lớn dựa trên [hướng dẫn tạo PDF có khả năng tiếp cận](https://latex3.github.io/tagging-project/documentation/usage-instructions) của LaTeX Project, bạn có thể tham khảo để biết thêm chi tiết về các chủ đề dưới đây.

<Warning>
  Lưu ý rằng việc áp dụng các phương pháp này không đảm bảo mọi thành phần trong dự án của bạn đều có khả năng tiếp cận—hãy xem phần Câu hỏi thường gặp của trang này để biết thêm thông tin.
</Warning>

### <Icon icon="tag" /> Gắn thẻ (Tagging)

Về cơ bản, gắn thẻ PDF là một quá trình tự động tạo ra một "cấu trúc" mà trình đọc màn hình có thể dễ dàng nhận diện, đồng thời giúp tài liệu dễ tìm kiếm hơn cả hiện tại lẫn trong tương lai. Quá trình này tận dụng cấu trúc sẵn có được định nghĩa bởi mã LaTeX của bạn, nhờ đó trình đọc màn hình có thể phân biệt các thành phần như tiêu đề, nội dung văn bản, hình ảnh và phương trình.

TeX Live 2025 hỗ trợ đầy đủ việc tự động gắn thẻ PDF thông qua khai báo `\DocumentMetaData`. Hãy thêm khai báo này trước `\documentclass`. Có hai khóa quan trọng trong khai báo này ảnh hưởng đến khả năng gắn thẻ: `tagging` và `tagging-setup`.

#### **`tagging`**

Đảm bảo việc gắn thẻ được bật bằng cách đặt khóa `tagging` thành `on`.

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

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

Cấu hình cách tài liệu của bạn được gắn thẻ bằng cách thay đổi giá trị của khóa `tagging-setup`.

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

<Info>
  Trong ví dụ này, chúng tôi đã dùng \`math/setup=mathml-SE\` để gắn thẻ MathML Structure Element, nhưng có thể đặt thành bất kỳ giá trị nào mà \[\`\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)) hỗ trợ.
</Info>

### <Icon icon="text-size" /> Mô tả

Ngoài việc gắn thẻ tự động, bạn cũng có thể cần thêm mô tả về nội dung của các thành phần, đặc biệt nếu tài liệu của bạn có chứa hình ảnh và/hoặc bảng.

#### <Icon icon="image" /> Hình ảnh

Việc thêm các mô tả quan trọng cho hình ảnh trong Overleaf rất đơn giản, và điều này cũng giúp hiểu ngữ cảnh của một số hình ảnh khi xem mã LaTeX. Bạn chỉ cần thêm tùy chọn mô tả hình ảnh tương ứng vào mỗi lần dùng `\includegraphics`. Có ba loại hình ảnh chính cần phân biệt về mặt khả năng tiếp cận: hình ảnh cần văn bản thay thế (alt text), artifact (thành phần trang trí) và hình ảnh tương ứng với văn bản thực tế.

**Văn bản thay thế (alt text)**

Thêm văn bản thay thế cho hình ảnh đảm bảo rằng ảnh có một mô tả có thể dùng làm phương án thay thế dạng văn bản cho nội dung hình ảnh. Sử dụng khóa `alt` và nhập một giá trị văn bản.

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

**Artifact**

Nếu một hình ảnh không cần được trình đọc màn hình nhận diện (tức là nó chỉ mang tính trang trí), hãy đánh dấu hình ảnh đó là artifact. Sử dụng khóa `artifact` mà không gán giá trị.

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

**Văn bản thực tế**

Nếu một hình ảnh chỉ là hình của một ký tự Unicode, hãy đưa vào ký tự dạng văn bản tương ứng. Sử dụng khóa `actualtext` và gán cho nó một ký tự duy nhất (không có dấu ngoặc).

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

#### <Icon icon="table" /> Bảng

Mặc dù bảng thường có văn bản đi kèm, điều quan trọng là văn bản đó phải được liên kết với đúng thành phần của bảng. Thêm `\tagpdfsetup` trước `tabular` hoặc trong phần preamble để bắt đầu thiết lập cho các bảng trong dự án Overleaf của bạn. Có hai loại bảng chính cần phân biệt về mặt khả năng tiếp cận: bảng dữ liệu và bảng trình bày.

**Bảng dữ liệu**

Nếu một bảng có ít nhất một hàng tiêu đề, hãy chỉ định những hàng nào là hàng tiêu đề. Sử dụng khóa `table/header-rows` và nhập một dãy số tương ứng với vị trí của các hàng tiêu đề.

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

**Bảng trình bày**

Nếu một bảng không nhằm mục đích được trình đọc màn hình hiểu là một bảng, hãy đánh dấu nó là bảng trình bày. Sử dụng khóa `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" /> Câu hỏi thường gặp

<Accordion title="Có công cụ nào giúp kiểm tra xem tài liệu của tôi có khả năng tiếp cận không?">
  Có, có một số công cụ bên ngoài, bao gồm [veraPDF](https://verapdf.org/), có thể xác thực các phần và mức độ tuân thủ PDF/A. Ngoài ra, bạn có thể dùng một công cụ như [WebAIM](https://webaim.org/) để tính tỷ lệ tương phản giữa hai màu.
</Accordion>

<Accordion title="Các gói trong dự án Overleaf của tôi có tương thích với các tính năng này không?">
  Bạn có thể tham khảo [danh sách trạng thái các gói](https://latex3.github.io/tagging-project/tagging-status/) của LaTeX Tagging Project.
</Accordion>

<Accordion title="Tôi vẫn có thể dùng `beamer` không? Có gói nào khác dành cho bài thuyết trình không?">
  Việc sử dụng `beamer` có một số hạn chế; hãy xem thử [lớp `ltx-talk`](https://ctan.org/pkg/ltx-talk) đang ở giai đoạn thử nghiệm.
</Accordion>

<Accordion title="Trình soạn thảo Overleaf có khả năng tiếp cận không?">
  Có. Là một ứng dụng web, Overleaf tận dụng các tính năng và chức năng hỗ trợ tiếp cận của các trình duyệt web hiện đại, vốn được các chuyên gia về khả năng tiếp cận đánh giá thường xuyên. [Voluntary Product Accessibility Template (VPAT)](https://www.overleaf.com/for/customers/vpat) mới nhất mà chúng tôi đã hoàn thành cho thấy sự tuân thủ Hướng dẫn về khả năng tiếp cận nội dung web (WCAG) 2.2 cấp độ AA.
</Accordion>

<Accordion title="PDF do Overleaf tạo ra có thể đáp ứng các yêu cầu của Title II thuộc Đạo luật Người khuyết tật Hoa Kỳ (ADA) và Tiêu chuẩn hài hòa châu Âu về khả năng tiếp cận (EN 301 549) không?">
  Có. Luật pháp tại Hoa Kỳ và châu Âu yêu cầu PDF phải đáp ứng WCAG 2.1 AA. Để đáp ứng WCAG 2.1 AA, PDF phải là một PDF có gắn thẻ. Việc hỗ trợ gắn thẻ PDF được cung cấp trong TeX Live 2025.
</Accordion>

<Accordion title="PDF do Overleaf tạo ra có thể đáp ứng tiêu chuẩn PDF/UA-1 không?">
  Có. Tagging Project của LaTeX Project được thiết kế đặc biệt để tạo ra các thẻ cấu trúc theo yêu cầu của PDF/UA-1 (và PDF/UA-2 sắp tới). Nếu người dùng làm theo các khuyến nghị gắn thẻ hiện tại của LaTeX Project, về cơ bản họ đang xây dựng một tài liệu "sẵn sàng cho PDF/UA", đây là cách mạnh mẽ nhất để đáp ứng yêu cầu pháp lý WCAG 2.1 AA theo luật pháp Hoa Kỳ và châu Âu.
</Accordion>

<Accordion title="Làm thế nào để chuyển trình biên dịch sang LuaLaTeX?">
  Việc chuyển sang sử dụng LuaLaTeX, công cụ biên dịch LaTeX được nhóm LaTeX Tagging Project khuyến nghị, rất dễ dàng. Mặc dù trình biên dịch mặc định trong Overleaf là PDFLaTeX, bạn có thể [chuyển sang LuaLaTeX trong phần thiết lập dự án](https://docs.overleaf.com/getting-started/recompiling-your-project/selecting-a-tex-live-version-and-latex-compiler).
</Accordion>

<Accordion title="Tôi có thể chọn phiên bản TeX Live mới nhất ở đâu?">
  Bạn có thể dùng phiên bản mới nhất trong [Overleaf Labs](https://www.overleaf.com/labs/participate), nơi cung cấp quyền truy cập vào image "rolling TeX Live" trong Overleaf, bao gồm hỗ trợ gắn thẻ PDF mới nhất. Phiên bản TeX Live thử nghiệm này chủ yếu dùng để kiểm thử các thay đổi đối với TeX Live và các gói, cũng như xem trước các tính năng hỗ trợ tiếp cận mới trước khi chúng được đưa vào bản phát hành TeX Live hằng năm của chúng tôi.

  Hầu hết các tính năng gắn thẻ PDF đều có sẵn trong image [TeX Live 2025](https://www.overleaf.com/blog/tex-live-2025-is-now-available) tiêu chuẩn.
</Accordion>

[^1]: Gắn thẻ tự động được bật.

[^2]: Cấu hình gắn thẻ đã được thiết lập.

[^3]: Hình ảnh có văn bản thay thế.

[^4]: Hình ảnh là một artifact.

[^5]: Hình ảnh là một ký tự.

[^6]: Bảng có một hàng tiêu đề.

[^7]: Bảng là một bảng trình bày.


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