> ## 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. # TeX Live 2026 đã ra mắt Tài liệu này được lấy từ [blog của Overleaf](https://www.overleaf.com/blog/tex-live-2026-is-now-available). Overleaf đã phát hành TeX Live 2026 vào ngày 18 tháng 8 năm 2026. Chúng tôi cũng đã cập nhật [ayaka-notes/texlive-full](https://github.com/ayaka-notes/texlive-full) lên TeX Live 2026. Dưới đây là những thay đổi, những điều cần kiểm tra trước khi chuyển đổi và cách khắc phục các lỗi mới phổ biến nhất. Cập nhật đáng chú ý nhất trong bản phát hành này là các tính năng tạo PDF có khả năng tiếp cận (accessible PDF) đã sẵn sàng để dùng trong quy trình làm việc thực tế và đã vượt qua giai đoạn nguyên mẫu. Bản cập nhật này cũng mang đến cho bạn các chương trình, phông chữ và gói macro liên quan đến TeX mới và được cập nhật. Bài viết này trình bày tất cả thông tin quan trọng và những thay đổi đáng chú ý mà bạn cần biết. Overleaf phát hành một bản cập nhật chính thức mỗi năm một lần sau khi kiểm thử nghiêm ngặt để đảm bảo mọi thứ hoạt động như mong đợi. Chúng tôi làm điều này để đảm bảo trải nghiệm nhất quán và ổn định cho hàng triệu người dùng Overleaf, đồng thời đảm bảo đội ngũ hỗ trợ có thể giúp bạn giải quyết mọi vấn đề hoặc câu hỏi. ### TeX Live là gì? [TeX Live](https://tug.org/texlive/) là một bản phân phối miễn phí của hệ thống sắp chữ TeX, bao gồm nhiều chương trình, phông chữ và gói macro liên quan đến TeX, trong đó có LaTeX, được duy trì bởi một nhóm người dùng TeX nòng cốt và [TeX User Group](https://tug.org/). Overleaf sử dụng TeX Live trên các máy chủ biên dịch để tạo bản xem trước và xuất PDF cho dự án của bạn. Với sự ra mắt của TeX Live 2026, người dùng có thể tạo các PDF được gắn thẻ (tagged PDF), có khả năng tiếp cận đầy đủ, bao gồm cả công thức toán học có thể đọc được. ### Các dự án hiện có của tôi có hoạt động như bình thường không? Có, các dự án hiện có của bạn vẫn sẽ hoạt động vì chúng tiếp tục sử dụng phiên bản TeX Live tại thời điểm được tạo. Chúng tôi khuyên không nên thay đổi phiên bản TeX Live trên một dự án hiện có trừ khi cần thiết; việc thay đổi có thể dẫn đến các lỗi hoặc cảnh báo mới. Lưu ý: Có thể có những mẫu trong thư viện Overleaf không hoạt động hoặc không biên dịch được khi bật các tùy chọn trợ năng. Hầu hết các mẫu không do Overleaf tạo hoặc duy trì; vui lòng liên hệ với tác giả của mẫu về mọi vấn đề. ### Tôi có thể chuyển sang TeX Live 2026 cho các dự án hiện có không? Có, bạn có thể dễ dàng chuyển sang TeX Live 2026 cho các dự án hiện có; quá trình chuyển đổi đơn giản và không rắc rối. Trong dự án bạn muốn thay đổi, hãy mở *Settings*, sau đó nhấp *Compiler* trong thanh bên, bạn sẽ thấy một danh sách thả xuống để chọn phiên bản TeX Live. Điều này cho phép bạn nhanh chóng cập nhật dự án để phù hợp với yêu cầu của các nhà xuất bản, máy chủ preprint và các nền tảng khác sử dụng một phiên bản TeX Live cụ thể để biên dịch bài nộp. Nếu dự án của bạn biên dịch không có vấn đề gì trong TeX Live 2025 (hoặc các phiên bản trước), nhưng giờ lại báo lỗi trong TeX Live 2026, điều này có thể do những thay đổi trong kernel hoặc trong một số gói. Một số gói được biết là gây ra lỗi hoặc cảnh báo mới trong TeX Live 2026; chúng tôi đã tổng hợp những trường hợp phổ biến nhất, kèm cách khắc phục, trong một phần riêng bên dưới. ### Những thay đổi chính trong TeX Live 2026 #### PDF được gắn thẻ, có khả năng tiếp cận đã rời khỏi giai đoạn nguyên mẫu Kể từ [bản cập nhật tháng 11 năm 2025](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf) của LaTeX Project, việc gắn thẻ (tagging) không còn được mô tả là nguyên mẫu nữa, mà được coi là có thể dùng trong quy trình làm việc thực tế, miễn là tài liệu của bạn chỉ dùng các gói và lớp tài liệu đã hỗ trợ gắn thẻ. Để bật xuất PDF được gắn thẻ, chỉ cần một lệnh duy nhất đặt trước `\documentclass`: ```latex theme={null} \DocumentMetadata{ pdfstandard = {UA-2, A-4f}, tagging = on, lang = en } \documentclass{article} ``` Sử dụng `\DocumentMetadata` cũng bật một vài giá trị mặc định: mã hóa phông chữ T1 và, [kể từ tháng 6 năm 2025](https://www.latex-project.org/news/latex2e-news/ltnews41.pdf), xuất ra **PDF 2.0** thay vì phiên bản 1.7 cũ hơn. PDF 2.0 quan trọng ở đây vì đây là phiên bản cho phép gắn thẻ MathML (thành phần giúp trình đọc màn hình đọc được công thức toán học thay vì một mớ ký hiệu không có nhãn). Một vài lưu ý thực tế: * Trong khi soạn thảo, bạn có thể đặt `tagging = draft` để giữ lại các cảnh báo về trợ năng nhưng bỏ qua việc ghi cây cấu trúc (hữu ích để tăng tốc biên dịch các tài liệu dài). * Khóa check-tagging-status sẽ báo cáo ở cuối log liệu các gói bạn đang dùng có được biết là tương thích với việc gắn thẻ hay không. Ngoài ra còn có một [cơ sở dữ liệu trạng thái trực tuyến](https://latex3.github.io/tagging-project/tagging-status/) mà bạn có thể kiểm tra trước khi bắt đầu. * Nếu bạn chỉ muốn phần quản lý PDF mà không cần mã gắn thẻ, giờ đã có một gói `pdfmanagement` riêng cho mục đích đó. Một thay đổi đặc biệt đáng lưu ý: `\DocumentMetadata` giờ chỉ có thể được gọi một lần trong tài liệu. Lần gọi thứ hai sẽ gây lỗi biên dịch, giống như khi có `\documentclass` thứ hai. #### Toán học có khả năng tiếp cận, kèm ý nghĩa [Mới từ tháng 11 năm 2025](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf), `\MathMLintent` và `\MathMLarg` cho phép tác giả cho công nghệ hỗ trợ biết một ký hiệu mang ý nghĩa gì, chứ không chỉ cách nó được tạo ra. Ví dụ, `|y|` giờ có thể được đọc to là *"giá trị tuyệt đối của y"* thay vì *"gạch y gạch"*. Gắn thẻ toán học có khả năng tiếp cận yêu cầu biên dịch bằng LuaLaTeX, vì đây là engine tạo ra MathML, cùng với gói `unicode-math` hoặc `lua-unicode-math`. #### Hình ảnh và hình vẽ giờ cũng mang ý nghĩa Trợ năng không chỉ giới hạn ở văn bản và toán học. `\includegraphics`, `picture` và `tikzpicture` giờ chấp nhận các khóa trợ năng, vì vậy mỗi hình ảnh đều có thể được đánh dấu phù hợp: ```latex theme={null} \includegraphics[alt={A bar chart of quarterly revenue}]{revenue} ``` Hình ảnh có thể được phân loại theo bốn cách: là một hình minh họa thực sự, là một thành phần trang trí mà các công cụ hỗ trợ sẽ bỏ qua, là vật thay thế cho một ký hiệu, hoặc là văn bản thông thường (hữu ích cho những thứ như `todonotes`). Đầu ra của TikZ được hỗ trợ sẵn. #### Lớp tài liệu mới để tạo bài trình chiếu được gắn thẻ, có khả năng tiếp cận Lớp tài liệu `beamer` rất phổ biến để tạo slide trình chiếu trong LaTeX. Đáng tiếc là nó không tương thích với mã gắn thẻ của LaTeX. Thay vào đó, một lớp tài liệu mới, [`ltx-talk`](https://ctan.org/pkg/ltx-talk), đã được tạo từ đầu. Cú pháp của nó phần lớn tương tự như của `beamer`, tuy nhiên không phải tất cả chức năng của `beamer` đều đã được triển khai trong `ltx-talk`. #### Cơ chế mẫu mới để định dạng tiêu đề mục Các lệnh tiêu đề mục đã được triển khai lại trong kernel LaTeX với một cơ chế mẫu mới, giải quyết vấn đề các gói như `titlesec` không hoàn toàn tương thích với mã gắn thẻ của LaTeX. Dưới đây là một ví dụ nhanh: ```latex theme={null} \EditInstance{heading}{section}{ number-format=\fbox{\LARGE\bfseries\theheading}, title-decls=\Large\bfseries\sffamily\color{blue}, before-vspace=20pt, } ``` Thông tin chi tiết có trong [tài liệu](https://tug.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf). #### Kernel được xây dựng lại từ bên dưới Trong kernel năm nay, một số giới hạn đã được loại bỏ: * Output routine giờ có thể cấu hình được: Trong gần 40 năm, cơ chế ghép trang của LaTeX về cơ bản được mã hóa cứng, buộc các gói cần thay đổi nó phải ghi đè mã nội bộ. Giờ đây nó cung cấp các hook và socket để thực hiện thay đổi. Các gói trở nên ổn định hơn và ít xung đột với nhau hơn. * Cơ chế mark hiện đại: Hệ thống `\markboth` / `\leftmark` / `\rightmark` cũ, vốn chỉ hỗ trợ hai mark đan xen, đã được xây dựng lại trên một hệ thống linh hoạt hỗ trợ số lượng mark độc lập tùy ý, trong khi các lệnh quen thuộc vẫn hoạt động chính xác như trước. * Môi trường khối và tiêu đề mục giờ chạy trên các mẫu: Danh sách, trích dẫn, các môi trường kiểu định lý và giờ là các lệnh tiêu đề đều dùng chung một hệ thống nền tảng nhất quán. Một lợi ích thực tế: LaTeX bắt đầu mô phỏng sẵn các gói phổ biến như `enumitem` và `\newtheoremstyle` của `amsthm`, và việc mô phỏng `titlesec` đang được tiến hành. Giờ đây bạn ít phải cài thêm gói chỉ để định dạng lại một danh sách hay một hộp định lý. * Tham chiếu chéo tốt hơn cho các môi trường kiểu định lý: Lệnh mới `\newcounteralias` giúp một bổ đề dùng chung bộ đếm với các định lý sẽ hiển thị đúng là *"lemma 1"* thay vì *"theorem 1"* khi được tham chiếu bằng `cleveref`, `zref-clever` hoặc `hyperref`. Nếu bạn duy trì các gói chứ không chỉ tài liệu, có hai thay đổi đáng chú ý: kernel giờ chính thức yêu cầu **`expl3` ngày 2023-11-27 trở về sau**, và *"toán học giả"* (dùng chế độ toán học chỉ để định vị các hộp) đã bị loại bỏ khỏi các cấu trúc như `\textsuperscript`, `\parbox`/`minipage` và xung quanh các cấu trúc bảng. Điều này cải thiện việc gắn thẻ và hỗ trợ văn bản từ phải sang trái, nhưng bạn sẽ nhận thấy sự khác biệt nếu so sánh kết quả `\showoutput` với các phiên bản TeX Live cũ hơn. #### Mở rộng phạm vi: thêm nhiều ngôn ngữ * Lập chỉ mục cho các chữ viết Brahmic, bao gồm tiếng Bengal, Gujarat, Kannada, Malayalam, Sinhala, Tamil và Telugu, đã có ở dạng thử nghiệm trong `upmendex`. * Các khóa **siêu dữ liệu ngôn ngữ BCP 47** mới (`language`, `other-languages`) cho phép bạn khai báo chính xác ngôn ngữ của tài liệu, đến tận các biến thể theo vùng, và thông tin này cũng được đưa vào siêu dữ liệu ngôn ngữ của chính tệp PDF. #### Những điều khác cần lưu ý * Các gói `enumerate`, `theorem` và `verbatim` giờ được coi là gói cũ (legacy); với tài liệu mới, hãy ưu tiên dùng lần lượt `enumitem`, `amsthm` và `fancyvrb`. * Nếu bạn dùng một quy trình in ấn hoặc nền tảng yêu cầu phiên bản PDF cũ hơn, bạn vẫn có thể tự đặt phiên bản PDF (ví dụ `\DocumentMetadata{pdfversion=1.7}`), và tài liệu TeX Live 2026 có hướng dẫn cách biên dịch tài liệu theo các giá trị mặc định cũ hơn. * Bạn có thể tìm [ghi chú phát hành chính thức](https://tug.org/texlive/doc/texlive-en/texlive-en.html#news) của TeX Live 2026 trên trang web của TeX Users Group (TUG), cũng như [ghi chú phát hành của tất cả các phiên bản TeX Live](https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-710009). ### Các gói phổ biến bị ảnh hưởng bởi TeX Live 2026 Trong các phần sau, chúng tôi nêu bật một số thay đổi khiến các dự án từng biên dịch thành công trong TeX Live 2025 nay gặp lỗi biên dịch trong TeX Live 2026. #### Các gói liên quan đến bảng không còn được hỗ trợ Với những thay đổi mới đối với cấu trúc bảng trong kernel LaTeX, các gói `tabu` và `tabls` không còn được hỗ trợ trong TL2026 — giờ chúng sẽ gây lỗi biên dịch. Gói `arydshln` cũng có thể không tương thích với các gói khác, ví dụ môi trường `tabularx` và `tabular*`. Tương tự, các gói hoặc mẫu định nghĩa lại `\@array` và `\tabular` cũng sẽ gây lỗi biên dịch xung quanh các cấu trúc dạng bảng. #### Các tùy chọn ngôn ngữ lỗi thời của `babel` Các tùy chọn ngôn ngữ `frenchb` và `francais` giờ đã lỗi thời. Chúng nên được thay bằng `french`. #### Lỗi của `varioref` Do một [lỗi trong gói `varioref`](https://github.com/latex3/latex2e/issues/2112#issuecomment-4881772493), việc nạp gói này trong các lớp tài liệu KOMA-Script sẽ gây lỗi TeX capacity exceeded và không có PDF nào được tạo ra. ```text theme={null} \documentclass{scrartcl} \usepackage{varioref} \begin{document} Hello World! \end{document} ``` Cách khắc phục tạm thời là thêm ```text theme={null} \def\extrasenglish{} ``` vào phần preamble. #### Các lớp KOMA-script và `capt-of` Các lớp tài liệu KOMA-script (`scrbook`, `scrartcl`, `scrreport`, `scrletter`) giờ đã định nghĩa `\captionof`, vì vậy không nên nạp gói `capt-of` nữa. (Mặt khác, gói `caption` vẫn an toàn để nạp với các lớp tài liệu này.) #### `thmtools`: lỗi `sibling`/`numberlike`/`sharenumber` Khi khai báo các môi trường kiểu định lý mới với tùy chọn `sibling` (hoặc `numberlike`, hoặc `sharenumber`) của `thmtools`, sẽ phát sinh [lỗi bộ đếm đã được định nghĩa](https://github.com/muzimuzhi/thmtools/issues/75), ví dụ `Command \c@proposal already defined`. ```text theme={null} \documentclass{article} \usepackage{thmtools} \declaretheorem{theorem} \declaretheorem{proposal}[sibling=theorem] \begin{document} \begin{theorem}This is a theorem.\end{theorem} \begin{proposal}This is a proposal.\end{proposal} \end{document} ``` Cách khắc phục tạm thời là thêm các dòng sau vào preamble, sau khi nạp `thmtools` nhưng trước `\declaretheorem`: ```text theme={null} \makeatletter \@ifundefined{newcounteralias}{}{% \renewcommand\thmt@autorefsetup{\@xa\def\csname\thmt@envname autorefname\@xa\endcsname\@xa{\thmt@thmname}}% } \makeatother ``` #### `polyglossia`, `xepersian` và `array` Nếu bạn đang dùng gói `polyglossia` hoặc `xepersian` để sắp chữ Ả Rập và đã nạp gói `array` hoặc các gói liên quan đến bảng khác có nạp `array`, bạn sẽ gặp lỗi `\UseMathForPositioningText` chưa được định nghĩa khi văn bản tiếng Ả Rập được đặt trong một cấu trúc dạng bảng. ```text theme={null} \documentclass[12pt,a4paper]{article} \usepackage{polyglossia} \usepackage{array} \setdefaultlanguage{arabic} \newfontfamily\arabicfont[Script=Arabic]{Noto Naskh Arabic} \begin{document} \begin{tabular}{c} السلام عليكم \end{tabular} \end{document} ``` Vấn đề này có thể được giải quyết bằng cách thêm `\DocumentMetadata{}` trước khai báo `\documentclass`; hoặc cân nhắc chuyển sang gói `babel` để sắp chữ Ả Rập. #### `babel-spanish` và `biblatex-apa` Nạp `babel-spanish` trong khi dùng style `apa` của `biblatex` sẽ gây lỗi biên dịch liên quan đến hook và `\@makecaption`: ```text theme={null} \usepackage[spanish]{babel} \usepackage[style=apa]{biblatex} ``` Tuy nhiên, có thể tránh lỗi này bằng cách thêm tùy chọn `shorthands=off` cho `babel`. #### `xgreek`, `hyperref` và `\appendix` Khi các gói `xgreek` (chỉ dành cho XeLaTeX và LuaLaTeX) và `hyperref` được nạp, sẽ có lỗi biên dịch đối với các tiêu đề mục xuất hiện sau `\appendix`: ```text theme={null} \documentclass{article} \usepackage{xgreek} \usepackage{fontspec} \setmainfont{GFS Artemisia} \usepackage{hyperref} \begin{document} \section{Εισαγωγή} \appendix \section{Δεδομένα} \end{document} ``` Cách khắc phục là thêm tùy chọn `hypertexnames=false` cho `hyperref`. #### `flowfram` và `titlesec` Hiện tại, các gói `flowfram` và `titlesec` không tương thích với nhau. Tuy nhiên, tác giả có thể cân nhắc định dạng tiêu đề mục bằng giao diện `\EditInstance` mới, ví dụ ```text theme={null} \DocumentMetadata{} \documentclass{article} \usepackage{flowfram} \usepackage[dvipsnames]{xcolor} \EditInstance{heading}{section}{ number-format=\fbox{\LARGE\bfseries\theheading}, title-decls=\Large\bfseries\sffamily\color{NavyBlue} } \begin{document} \section{Introduction} \end{document} ``` Xem [liên kết này](https://mirrors.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf) để biết thêm chi tiết. ### TeX Live 2026 trong Ayakaleaf Pro Quản trị viên Ayakaleaf Pro có thể cài đặt TeX Live 2026 bằng cách cập nhật cấu hình theo cách thông thường: trỏ `TEX_LIVE_DOCKER_IMAGE` (và `ALL_TEX_LIVE_DOCKER_IMAGES`) tới image TeX Live 2026 mới. Không cần nâng cấp gì thêm. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.