> ## 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 artık kullanılabilir Bu belge [Overleaf blogundan](https://www.overleaf.com/blog/tex-live-2026-is-now-available) alınmıştır. Overleaf, TeX Live 2026'yı 18 Ağustos 2026'da yayınladı. Biz de [ayaka-notes/texlive-full](https://github.com/ayaka-notes/texlive-full) imajını TeX Live 2026'ya güncelledik. Neyin değiştiğini, geçiş yapmadan önce nelerin kontrol edilmesi gerektiğini ve en yaygın yeni hataların nasıl düzeltileceğini burada bulabilirsiniz. Bu sürümdeki en dikkat çekici güncelleme, erişilebilir PDF'ler üreten özelliklerin prototip aşamasını geride bırakarak üretim iş akışlarında kullanıma hazır hale gelmesidir. Bu güncelleme ayrıca yeni ve güncellenmiş TeX ile ilgili programlara, yazı tiplerine ve makro paketlerine erişmenizi sağlar. Bu blog yazısı, bilmeniz gereken tüm temel bilgileri ve önemli değişiklikleri kapsar. Overleaf, her şeyin beklendiği gibi çalıştığından emin olmak için titiz testlerden sonra yılda bir kez resmi bir güncelleme yayınlar. Bunu, milyonlarca Overleaf kullanıcısına tutarlı ve kararlı bir deneyim sunmak ve destek ekibimizin her türlü sorun veya soruda size yardımcı olabilmesini sağlamak için yapıyoruz. ### TeX Live nedir? [TeX Live](https://tug.org/texlive/), LaTeX dahil pek çok TeX ile ilgili programı, yazı tipini ve makro paketini içeren, TeX dizgi sisteminin ücretsiz bir dağıtımıdır ve çekirdek bir TeX kullanıcı grubu ile [TeX User Group](https://tug.org/) tarafından sürdürülür. Overleaf, önizlemeyi oluşturmak ve projenizin PDF'ini üretmek için derleme sunucularında TeX Live kullanır. TeX Live 2026'nın sunulmasıyla kullanıcılar, okunabilir matematik dahil tamamen erişilebilir, etiketlenmiş (tagged) PDF'ler oluşturabilecek. ### Mevcut projelerim her zamanki gibi çalışacak mı? Evet, mevcut projeleriniz oluşturuldukları zamanki TeX Live sürümünü kullanmaya devam edeceği için çalışmaya devam edecektir. Gerekli olmadıkça mevcut bir projede TeX Live sürümünü değiştirmemenizi öneririz; değiştirmek yeni hatalara veya uyarılara yol açabilir. Not: Overleaf galerisinde, erişilebilirlik seçenekleri etkinken çalışmayan veya derlenmeyen şablonlar olabilir. Şablonların çoğu Overleaf tarafından oluşturulmaz veya sürdürülmez; herhangi bir sorun için lütfen şablonun oluşturucusuyla iletişime geçin. ### Mevcut projeler için TeX Live 2026'ya geçebilir miyim? Evet, mevcut projeler için kolayca TeX Live 2026'ya geçebilirsiniz; geçiş basit ve zahmetsizdir. Değiştirmek istediğiniz projede *Settings* öğesini açın, ardından kenar çubuğunda *Compiler* öğesine tıklayın; TeX Live sürümünü seçmek için bir açılır liste göreceksiniz. Bu sayede projenizi, gönderimleri derlemek için belirli bir TeX Live sürümü kullanan yayıncıların, ön baskı (preprint) sunucularının ve diğer platformların gereksinimlerine uyacak şekilde hızla güncelleyebilirsiniz. Projeniz TeX Live 2025'te (veya daha önceki sürümlerde) sorunsuz derleniyor ancak şimdi TeX Live 2026'da hata veriyorsa, bu durum çekirdekteki veya bazı paketlerdeki değişikliklerden kaynaklanıyor olabilir. Bazı paketlerin TeX Live 2026 altında yeni hatalar veya uyarılar ürettiği bilinmektedir; en yaygın olanları düzeltmeleriyle birlikte aşağıda ayrı bir bölümde topladık. ### TeX Live 2026'daki temel değişiklikler #### Etiketlenmiş, erişilebilir PDF prototip aşamasını geride bıraktı LaTeX Project'in [Kasım 2025 güncellemesinden](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf) bu yana etiketleme artık bir prototip olarak tanımlanmıyor; belgeniz etiketlemeyi zaten destekleyen paket ve sınıflarla sınırlı kaldığı sürece üretim iş akışlarında kullanılabilir kabul ediliyor. Etiketlenmiş PDF çıktısını etkinleştirmek için `\documentclass` öncesine yerleştirilen tek bir komut yeterlidir: ```latex theme={null} \DocumentMetadata{ pdfstandard = {UA-2, A-4f}, tagging = on, lang = en } \documentclass{article} ``` `\DocumentMetadata` kullanmak ayrıca birkaç varsayılanı da etkinleştirir: T1 yazı tipi kodlaması ve [Haziran 2025'ten bu yana](https://www.latex-project.org/news/latex2e-news/ltnews41.pdf) eski 1.7 yerine **PDF 2.0** çıktısı. PDF 2.0 burada önemlidir, çünkü MathML etiketlemesine (matematiği etiketsiz bir sembol yığını yerine ekran okuyucular için okunabilir kılan parça) olanak tanıyan odur. Birkaç pratik not: * Taslak hazırlarken, erişilebilirlik uyarılarını korumak ancak yapı ağacının yazılmasını atlamak için `tagging = draft` ayarını kullanabilirsiniz (uzun belgelerde derlemeleri hızlandırmak için kullanışlıdır). * Bir check-tagging-status anahtarı, günlüğünüzün sonunda kullandığınız paketlerin etiketlemeyle uyumlu olduğunun bilinip bilinmediğini bildirir. Başlamadan önce kontrol edebileceğiniz bir [canlı durum veritabanı](https://latex3.github.io/tagging-project/tagging-status/) da vardır. * Etiketleme kodu olmadan yalnızca PDF yönetimi tarafını istiyorsanız, bunun için artık ayrı bir `pdfmanagement` paketi bulunmaktadır. Özellikle belirtilmesi gereken bir değişiklik: `\DocumentMetadata` artık bir belgede yalnızca bir kez çağrılabilir. İkinci bir çağrı, ikinci bir `\documentclass` gibi derleme hatasına neden olur. #### Anlamı olan erişilebilir matematik [Kasım 2025'ten bu yana yeni](https://www.latex-project.org/news/latex2e-news/ltnews42.pdf) olan `\MathMLintent` ve `\MathMLarg`, yazarların yardımcı teknolojilere bir gösterimin yalnızca nasıl oluşturulduğunu değil, ne anlama geldiğini de bildirmesine olanak tanır. Örneğin `|y|` artık *"bar y bar"* yerine *"y'nin mutlak değeri"* olarak sesli okunabilir. Erişilebilir matematik etiketlemesi, MathML'i üreten motor olduğu için LuaLaTeX ile derlemeyi ve `unicode-math` veya `lua-unicode-math` paketinden birini gerektirir. #### Grafikler ve şekiller de artık anlam taşıyor Erişilebilirlik metin ve matematikle sınırlı değildir. `\includegraphics`, `picture` ve `tikzpicture` artık erişilebilirlik anahtarlarını kabul eder; böylece her grafik uygun şekilde işaretlenebilir: ```latex theme={null} \includegraphics[alt={A bar chart of quarterly revenue}]{revenue} ``` Grafikler dört şekilde sınıflandırılabilir: gerçek bir açıklayıcı şekil, yardımcı araçlar tarafından yok sayılacak dekoratif bir öğe (artifact), bir sembolün yerine geçen öğe veya sıradan metin (`todonotes` gibi şeyler için kullanışlıdır). TikZ çıktısı kutudan çıktığı haliyle desteklenir. #### Etiketlenmiş, erişilebilir sunumlar oluşturmak için yeni bir sınıf `beamer` belge sınıfı, LaTeX'te sunum slaytları oluşturmak için çok popülerdir. Ne yazık ki LaTeX etiketleme koduyla uyumlu değildir. Bunun yerine sıfırdan yeni bir belge sınıfı, [`ltx-talk`](https://ctan.org/pkg/ltx-talk), oluşturulmuştur. Sözdizimi büyük ölçüde `beamer` ile benzerdir; ancak `beamer`'ın tüm işlevleri `ltx-talk` içinde uygulanmamıştır. #### Bölüm başlıklarını biçimlendirmek için yeni şablon mekanizmaları Bölüm başlığı komutları, LaTeX çekirdeğinde yeni bir şablon mekanizmasıyla yeniden uygulanmış ve böylece `titlesec` gibi paketlerin LaTeX etiketleme koduyla tam uyumlu olmaması sorunu çözülmüştür. İşte kısa bir örnek: ```latex theme={null} \EditInstance{heading}{section}{ number-format=\fbox{\LARGE\bfseries\theheading}, title-decls=\Large\bfseries\sffamily\color{blue}, before-vspace=20pt, } ``` Ayrıntılı bilgi [belgelerde](https://tug.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf) mevcuttur. #### Altyapısı yeniden inşa edilen bir çekirdek Bu yılın çekirdeğinde bazı sınırlamalar kaldırılmıştır: * Çıktı rutini artık yapılandırılabilir: Yaklaşık 40 yıl boyunca LaTeX'in sayfa birleştirme mekanizması fiilen sabit kodlanmıştı ve bunu değiştirmesi gereken paketleri dahili kodun üzerine yazmaya zorluyordu. Artık bunun yerine değişiklik yapmak için kancalar (hooks) ve soketler (sockets) sunar. Paketler daha kararlı hale gelir ve birbirleriyle çakışma olasılıkları azalır. * Modern bir işaret (mark) mekanizması: Yalnızca iç içe geçmiş iki işareti destekleyen eski `\markboth` / `\leftmark` / `\rightmark` sistemi, herhangi bir sayıda bağımsız işareti destekleyen esnek bir sistem üzerine yeniden kurulmuştur; tanıdık komutlar ise tam olarak eskisi gibi çalışmaya devam eder. * Blok ortamları ve bölüm başlıkları artık şablonlarla çalışır: Listeler, alıntılar, teorem benzeri ortamlar ve artık başlık komutları tutarlı bir temel sistemi paylaşır. Pratik bir kazanım: LaTeX, `enumitem` ve `amsthm`'nin `\newtheoremstyle` komutu gibi popüler paketleri yerel olarak taklit etmeye başlamıştır ve `titlesec` taklidi de devam etmektedir. Artık yalnızca bir listeyi veya teorem kutusunu yeniden biçimlendirmek için paket kurmaya daha az ihtiyaç vardır. * Teorem benzeri ortamlar için daha iyi çapraz başvurular: Yeni `\newcounteralias` komutu sayesinde, teoremlerle sayaç paylaşan bir lemma, `cleveref`, `zref-clever` veya `hyperref` ile başvurulduğunda *"theorem 1"* yerine doğru şekilde *"lemma 1"* olarak görünür. Yalnızca belge değil paket de geliştiriyorsanız iki değişiklik dikkatinizi hak ediyor: çekirdek artık resmi olarak **2023-11-27 veya daha yeni tarihli `expl3`** gerektiriyor ve *"sahte matematik"* (matematik modunu yalnızca kutuları konumlandırmak için kullanma), `\textsuperscript`, `\parbox`/`minipage` gibi yapılardan ve tablo yapılarının çevresinden kaldırıldı. Bu, etiketlemeyi ve sağdan sola metin desteğini iyileştirir; ancak `\showoutput` sonuçlarını eski TeX Live sürümleriyle karşılaştırırsanız bunu fark edersiniz. #### Yeni kapsam: daha fazla dil * Bengalce, Guceratça, Kannada, Malayalam, Sinhala, Tamilce ve Telugu dahil olmak üzere Brahmi yazıları için dizinleme, `upmendex` içinde deneysel olarak kullanıma sunuldu. * Yeni **BCP 47 dil meta verisi** anahtarları (`language`, `other-languages`), bir belgenin dilini bölgesel varyantlara kadar kesin olarak bildirmenizi sağlar; bu bilgi PDF'in kendi dil meta verisine de aktarılır. #### Dikkat edilmesi gereken diğer noktalar * `enumerate`, `theorem` ve `verbatim` paketleri artık eski (legacy) kabul edilmektedir; yeni belgeler için sırasıyla `enumitem`, `amsthm` ve `fancyvrb` paketlerini tercih edin. * Daha eski bir PDF sürümü bekleyen bir baskı iş akışında veya platformdaysanız PDF sürümünü yine kendiniz ayarlayabilirsiniz (örneğin `\DocumentMetadata{pdfversion=1.7}`); TeX Live 2026 belgeleri, belgelerin eski varsayılanları hedefleyerek nasıl derleneceğini de ele alır. * TeX Live 2026'nın [resmi sürüm notlarını](https://tug.org/texlive/doc/texlive-en/texlive-en.html#news) ve [tüm TeX Live sürümlerinin sürüm notlarını](https://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-710009) TeX Users Group (TUG) web sitesinde bulabilirsiniz. ### TeX Live 2026'dan etkilenen yaygın paketler Aşağıdaki bölümlerde, TeX Live 2025'te başarıyla derlenen projelerin TeX Live 2026'da derleme hatası vermesine neden olabilecek bazı değişiklikleri vurguluyoruz. #### Desteklenmeyen tablo ile ilgili paketler LaTeX çekirdeğindeki tablo yapılarına yönelik yeni değişikliklerle `tabu` ve `tabls` paketleri TL2026'da artık desteklenmiyor — bunlar artık derleme hatalarına neden olacaktır. `arydshln` paketi de diğer paketlerle, örneğin `tabularx` ve `tabular*` ortamlarıyla uyumsuz olabilir. Benzer şekilde `\@array` ve `\tabular` komutlarını yeniden tanımlayan paketler veya şablonlar da tablo benzeri yapılarda derleme hatalarına neden olur. #### `babel` eskimiş dil seçenekleri `frenchb` ve `francais` dil seçenekleri artık kullanımdan kalkmıştır. Bunlar artık `french` ile değiştirilmelidir. #### `varioref` hatası [`varioref` paketindeki bir hata](https://github.com/latex3/latex2e/issues/2112#issuecomment-4881772493) nedeniyle, bu paketi KOMA-Script belge sınıflarında yüklemek TeX kapasitesinin aşıldığına dair bir hataya neden olur ve hiçbir PDF oluşturulmaz. ```text theme={null} \documentclass{scrartcl} \usepackage{varioref} \begin{document} Hello World! \end{document} ``` Geçici çözüm, önsöze (preamble) ```text theme={null} \def\extrasenglish{} ``` satırını eklemektir. #### KOMA-script sınıfları ve `capt-of` KOMA-script belge sınıfları (`scrbook`, `scrartcl`, `scrreport`, `scrletter`) artık `\captionof` komutunu tanımladığından `capt-of` paketi artık yüklenmemelidir. (Öte yandan `caption` paketi bu belge sınıflarıyla yüklenmeye hâlâ güvenlidir.) #### `thmtools`: `sibling`/`numberlike`/`sharenumber` hataları `thmtools` paketinin `sibling` (veya `numberlike` ya da `sharenumber`) seçeneğiyle yeni teorem benzeri ortamlar tanımlanırken, sayaçların zaten tanımlı olduğuna dair [hatalar](https://github.com/muzimuzhi/thmtools/issues/75), örneğin `Command \c@proposal already defined`, ortaya çıkar. ```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} ``` Geçici çözüm, `thmtools` yüklendikten sonra ancak `\declaretheorem` öncesinde önsöze aşağıdaki satırları eklemektir: ```text theme={null} \makeatletter \@ifundefined{newcounteralias}{}{% \renewcommand\thmt@autorefsetup{\@xa\def\csname\thmt@envname autorefname\@xa\endcsname\@xa{\thmt@thmname}}% } \makeatother ``` #### `polyglossia`, `xepersian` ve `array` Arap alfabesiyle dizgi için `polyglossia` veya `xepersian` paketlerini kullanıyorsanız ve `array` paketini ya da `array` paketini yükleyen başka tablo ile ilgili paketleri yüklediyseniz, Arapça metin tablo benzeri bir yapı içine yerleştirildiğinde `\UseMathForPositioningText` komutunun tanımlı olmadığına dair bir hata alırsınız. ```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} ``` Bu sorun, `\documentclass` bildiriminden önce `\DocumentMetadata{}` eklenerek çözülebilir; ya da Arap alfabesiyle dizgi için `babel` paketine geçmeyi düşünebilirsiniz. #### `babel-spanish` ve `biblatex-apa` `biblatex` stili `apa` kullanılırken `babel-spanish` yüklemek, kancalar (hooks) ve `\@makecaption` ile ilgili bir derleme hatasına neden olur: ```text theme={null} \usepackage[spanish]{babel} \usepackage[style=apa]{biblatex} ``` Ancak `babel` paketine `shorthands=off` seçeneği eklenerek bu hatadan kaçınılabilir. #### `xgreek`, `hyperref` ve `\appendix` `xgreek` (yalnızca XeLaTeX ve LuaLaTeX için) ve `hyperref` paketleri yüklendiğinde, `\appendix` sonrasında görünen bölüm başlıkları için derleme hatası verilir: ```text theme={null} \documentclass{article} \usepackage{xgreek} \usepackage{fontspec} \setmainfont{GFS Artemisia} \usepackage{hyperref} \begin{document} \section{Εισαγωγή} \appendix \section{Δεδομένα} \end{document} ``` Çözüm, `hyperref` paketine `hypertexnames=false` seçeneğini eklemektir. #### `flowfram` ve `titlesec` Şimdilik `flowfram` ve `titlesec` paketleri birbiriyle uyumsuzdur. Ancak yazarlar, bölüm başlıklarını yeni `\EditInstance` arayüzünü kullanarak biçimlendirmeyi düşünebilir, örneğin: ```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} ``` Daha fazla ayrıntı için [bu bağlantıya](https://mirrors.ctan.org/macros/latex-dev/required/latex-lab/latex-lab-sec-template.pdf) bakın. ### Ayakaleaf Pro'da TeX Live 2026 Ayakaleaf Pro yöneticileri, yapılandırmalarını her zamanki şekilde güncelleyerek, yani `TEX_LIVE_DOCKER_IMAGE` (ve `ALL_TEX_LIVE_DOCKER_IMAGES`) değişkenlerini yeni TeX Live 2026 imajına yönlendirerek TeX Live 2026'yı kurabilecekler. Başka bir yükseltme gerekmez. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.