LaTeX Belgelerini Akademik Yayıncılık İçin Dönüştürme

LaTeX, bilimsel makaleler, konferans bildirileri ve tezler için hâlâ de‑facto standarttır. Gücü, matematiğin, bibliyografyaların ve karmaşık yapının hassas tipografisinde yatar. Yine de yayıncılar, kurumsal depolar ve okuyucular aynı materyali alternatif formatlarda ister—arz için PDF/A, web‑tabanlı okuma için HTML veya e‑okuyucular için EPUB. Dönüştürme adımı, kayıpsız bir akademik kaydı tehdit eden gizli tuzaklarla doludur: eksik yazı tipleri, kırık çapraz referanslar veya değişen satır aralıkları.

Bu makale, yazar niyetini korurken dağıtıma hazır dosyalar üreten sistematik bir iş akışını adım adım gösterir. Odak, tek bir el yazması ya da toplu gönderimler için işe yarayan pratik kararlar, araç seçimi ve doğrulama yöntemlerindedir.

---

1. Hedef Formatları ve Kısıtlamalarını Anlayın

Herhangi bir dönüştürme yapmadan önce kesin çıktı gereksinimlerini tanımlayın. Farklı dağıtım kanalları, farklı teknik kısıtlamalar getirir:

• PDF/A‑1b – uzun vadeli arşivleme için ISO standardı. Şifrelemeyi yasaklar, gömülü yazı tipleri gerektirir ve referanssız renk alanlarına izin vermez.
• PDF/UA – erişilebilirlik normlarını karşılayan bir PDF çeşidi (doğru etiketler, okuma sırası, görüntüler için alt‑metin).
• HTML5 – web portalları için ideal; anlamsal işaretleme, duyarlı görseller ve denklemler için MathML veya yedek görseller gerekir.
• EPUB 3 – yeniden akışlı metin, gömülü yazı tipleri ve MathML destekleyen e‑kitap formatı; tablet ve e‑okuyuculara uygundur.

Her format, belirli derleme bayrakları veya son‑işlem adımları gerektirir. Bu kısıtlamaları erken haritalamak, zaman kazandırır ve maliyetli yeniden iş yapmayı önler.

---

2. Sağlam Bir LaTeX Motoru Seçin

Çağırdığınız motor, kaynağın ne kadar doğru işlendiğini ve hangi yardımcı dosyaların üretildiğini belirler.

Arşiv PDF’leri (PDF/A) için pdfLaTeX ile pdfx paketi güvenilir bir temel sağlar. HTML veya EPUB için, LaTeX kaynağını temiz bir ara PDF veya DVI üretmesi beklenen bir dönüştürme aracına ileteceksiniz.

---

3. Dönüştürme İçin Kaynağı Hazırlayın

3.1 Paketleri Minimumda Tutun ve İyi Belgelenmiş Olmasına Dikkat Edin

Gereksiz veya eski paketler, motor değiştirdiğinizde derleme hatası riskini artırır. \usepackage{} satırlarını denetleyin ve görünüm için kesinlikle gerekli olmayanları kaldırın.

3.2 Yazı Tiplerini Açıkça Gömün

Nihai PDF’nin her glifi gömmesi gerekiyorsa, yazı tipi ailesini \setmainfont{} (XeLaTeX/LuaLaTeX) ya da \pdfmapfile{} (pdfLaTeX) ile tanımlayın. Seçilen yazı tiplerinin dağıtım lisansına sahip olduğundan emin olun; aksi takdirde dönüşüm sessizce varsayılanları kullanır ve görsel tutarlılık bozulur.

3.3 Standart Bibliyografi Araçları Kullanın

Bibliyografik verileri tek bir .bib dosyasında tutun ve modern atıf stilleri için biblatex + biber kombinasyonunu tercih edin. Bu yöntem, alıntı anahtarlarını tüm formatlarda korur ve referans listelerini HTML ya da EPUB’da oluşturmayı kolaylaştırır.

---

4. Yüksek Kaliteli Bir PDF Temeli Oluşturun

Temiz bir PDF, çoğu alt‑dönüştürme işleminin temelidir. Şu adımları izleyin:

1. İki kez derleyin; çapraz referanslar ve içindekiler tablosu çözülsün.
2. biber çalıştırın (veya eski stillerle bibtex), derlemeler arasında.
3. pdfx paketini ekleyin:

   \usepackage[x-1a]{pdfx}
   

   Bu, gerekli PDF/A meta verilerini ekler ve yazı tipi gömülmesini zorlar.
4. Log dosyasını kontrol edin; Missing font uyarıları varsa, eksik yazı tiplerini harita dosyasına ekleyin veya XeLaTeX’e geçin.

PDF/A uyumluluğunu onaylamak için bir PDF doğrulayıcı (ör. veraPDF) kullanın.

---

5. PDF’yi HTML ve EPUB’a Dönüştürmek

İki ana strateji bulunur:

5.1 Doğrudan LaTeX‑to‑HTML/EPUB Araçları

• pandoc – LaTeX’i okuyup HTML5 ya da EPUB üreten evrensel bir dönüştürücü. Atıfları, görselleri ve basit denklemleri MathJax ile işler.
• latex2html – daha eski, hafif, ancak modern paketler ve karmaşık matematikle başa çıkmakta zorlanır.

Pandoc iş akışı:

pandoc manuscript.tex \
  --pdf-engine=xelatex \
  --citeproc \
  -s -o manuscript.html

pandoc manuscript.tex \
  --pdf-engine=xelatex \
  --citeproc \
  -s -o manuscript.epub

Önemli seçenekler:

• --pdf-engine, özel yazı tiplerinin korunmasını sağlar.
• --citeproc, .bib dosyasını işleyip bir bibliyografi üretir.
• -s, gömülü CSS ile kendi kendine yeten bir belge üretir.

5.2 PDF‑İlk Yaklaşım

PDF zaten PDF/A/UA standartlarını karşıladığında, yapısını pdf2htmlEX (HTML için) veya Calibre (EPUB için) ile çıkarabilirsiniz. Bu yöntem tam sayfa ve yazı tipi eşleşmesini korur fakat denklemler için büyük raster görseller üretebilir.

Artıları: Görsel tutarlılık neredeyse aynı.

Eksileri: Çıktı boyutu daha büyük, erişilebilirlik sınırlı çünkü alt metinler genellikle görüntü olarak gelir.

---

6. Matematiği Tüm Formatlarda Koruyun

Denklemler, dönüşüm sırasında en kırılgan unsurdur.

• MathML – modern tarayıcılar ve EPUB 3 içinde yerel destek. Pandoc, --mathml bayrağıyla MathML üretebilir.
• LaTeXML – yüksek kaliteli MathML ve XHTML üretmek için özel bir LaTeX‑to‑XML hattı.
• Görsel yedek – MathML’i render edemeyen ortamlar için pandoc’u SVG üretmeye (--webtex) yönlendirin. SVG, formülü rasterleştirmeden ölçeklendirir.

Dengeli bir pandoc komutu örneği:

pandoc manuscript.tex \
  --webtex=https://latex.codecogs.com/svg.latex? \
  --mathml \
  -s -o manuscript.html

Elde edilen HTML, MathML’i destekleyen tarayıcılarda gösterir; desteklemeyenlerde SVG yedeğini kullanır.

---

7. Şekiller ve Harici Medyayı Yönetmek

Şekiller genellikle ayrı PDF, PNG ya da EPS dosyalarından gelir. Tutarlılığı sağlamak için:

1. pdfLaTeX kullanıyorsanız şekilleri PDF olarak gömün; vektör kalitesi korunur.
2. HTML/EPUB için şekilleri SVG’ye dönüştürün. Inkscape gibi araçlar (inkscape -l fig.svg fig.pdf) keskinliği korur ve CSS ile stil verilebilir.
3. Alt‑metin ekleyin LaTeX kaynağında \caption[Alt metin]{Tam başlık} şeklinde. Pandoc, erişilebilirlik için opsiyonel argümantı yakalar.

Büyük raster görselleri yalnızca içerik itibarıyla pikselli (ör. mikroskop fotoğrafları) olduğunda kullanın. Bunları eklemeden önce optipng veya jpegoptim ile sıkıştırın.

---

8. Çıktıyı Doğrulamak

8.1 PDF Doğrulama

• veraPDF – PDF/A uyumluluğunu kontrol eder.
• PDF/UA‑Validator – erişilebilirlik etiketlerini inceleyerek doğrular.

Her iki aracı da nihai PDF’de çalıştırın ve eksik alt‑metin, etiketsiz tablolar gibi rapor edilen sorunları giderin.

8.2 HTML Doğrulama

• W3C HTML validator – söz dizimi hatalarını tespit eder.
• axe‑core – erişilebilirlik açıklarını (eksik ARIA etiketleri, hatalı başlık sırası vb.) tarar.

8.3 EPUB Doğrulama

• epubcheck – Uluslararası Dijital Yayıncılık Forumu (IDPF) tarafından önerilen referans doğrulayıcı. Eksik meta veri, hatalı navigasyon dosyaları veya hatalı MathML gibi hataları işaret eder.

Bu kontrolleri bir CI boru hattına (ör. GitHub Actions) entegre etmek, her yeni revizyonun kalite kapılarını geçmesini garantiler.

---

9. Birden Fazla El Yazması İçin İş Akışını Otomatikleştirmek

Araştırmacılar yıl içinde onlarca tez veya konferans bildirisi işlemek zorunda kalabilir. Aşağıdaki hafif otomasyon betiği, yukarıda özetlenen adımları bir araya getirir.

#!/usr/bin/env bash
set -euo pipefail

DOCS=("paper1" "paper2" "paper3")
for d in "${DOCS[@]}"; do
  cd "$d"
  # 1. PDF/A oluştur
  latexmk -pdf -pdflatex='pdflatex -interaction=nonstopmode' -usepdfx
  # 2. PDF/A doğrula
  verapdf "${d}.pdf"
  # 3. HTML & EPUB’a dönüştür (pandoc)
  pandoc "${d}.tex" --pdf-engine=xelatex --citeproc -s -o "${d}.html"
  pandoc "${d}.tex" --pdf-engine=xelatex --citeproc -s -o "${d}.epub"
  # 4. HTML & EPUB doğrula
  html5validator "${d}.html"
  epubcheck "${d}.epub"
  cd ..
done

Betik, artımlı derleme için latexmk kullanır ve her dönüşüm sonrası üç doğrulayıcıyı çalıştırır. DOCS dizisini kendi klasör yapınıza göre ayarlayın.

---

10. Çevrimiçi Dönüştürme Hizmeti Ne Zaman Kullanılmalı?

convertise.app gibi bulut tabanlı bir araç, özellikle tam bir TeX kurulumunuz yoksa tek seferlik dönüşümler için kullanışlıdır. Hizmet, LaTeX kaynaklarını bir kumanda ortamında işleyerek PDF/A, HTML veya EPUB döndürür ve dokümantasyonunda belirtilen gizlilik ilkesine uyar. Hassas araştırma verileri söz konusu olduğunda ise, kendi sunucunuzda barındırılan bir boru hattını ya da yerel dönüşümü tercih ederek el yazmanızı kontrol altında tutun.

---

11. Yaygın Tuzaklar ve Önleme Yolları

Bu noktaları erken kontrol etmek, yayınlama sürecindeki yeniden iş yükünü büyük ölçüde azaltır.

---

12. Kurumsal Depolara Entegre Etmek

Birçok üniversite, çeşitli formatlarda dosya alan kurumsal depolar işletir. Alımı kolaylaştırmak için:

1. PDF/A‑1b’yi arşiv masterı olarak standartlaştırın; bölüme 4’teki adımlarla doğrudan LaTeX’tan üretin.
2. HTML özetleri aynı LaTeX kaynağından oluşturup ayrı meta veri alanı olarak saklayın; arama motoru dizinlemesi için faydalıdır.
3. EPUB’u ikincil indirme olarak sunun; okuyucuların tercihi doğrultusunda 5 MB altında tutmak için görselleri sıkıştırın.
4. Dönüştürme kaynağını (motor sürümü, paket listesi, doğrulama sonuçları) deposunun meta veri şemasına kaydedin. Bu, denetim gereksinimlerini karşılar ve gelecekteki tekrarlanabilirliği artırır.

---

13. Özet

LaTeX el yazmalarını birden çok sunum formatına dönüştürmek basit bir “tek‑tık” işlemi değildir. Hedef standartları net bir biçimde anlamak, kaynağı bilinçli şekilde hazırlamak ve her çıktıyı titizlikle doğrulamak gerekir. Doğru motoru seçmek, yazı tiplerini gömmek, sağlam bir PDF/A iş akışı oluşturmak ve pandoc, LaTeXML ve özel doğrulayıcılar gibi araçları kullanmak, tek bir kaynaktan gelen içeriğin geleneksel dergiler, web portalları ve e‑okuyuculara aynı zamanda ulaştırılmasını sağlar. Otomasyon betikleri süreci tekrarlanabilir kılar, gizlilik odaklı çevrimiçi hizmetler (ör. convertise.app) ise ara sıra ihtiyaç duyulan dönüşümler için pratik bir çözüm sunar. Bu uygulamaları hayata geçirerek, bilimsel çalışmanızın bütünlüğü ve erişilebilirliği dijital yaşam döngüsünün her aşamasında korunur.