# Preflight denetimleri

Bir belge elinizden çıkmadan önce kaynağı, derleme günlüğünü, PDF'i, başvuruları, erişilebilirlik sinyallerini ve gönderim risklerini inceleyin.

Başarılı bir derleme yalnızca bir PDF yapıldığını kanıtlar. Her atfın çözümlendiğini, okuma sırasının anlamlı olduğunu, gönderim arşivinin temiz olduğunu ya da dosyanın iddia ettiği erişilebilirlik yapısını taşıdığını kanıtlamaz.

Preflight bu soruları tek bir yerel incelemeye toplar. Proje rayındaki **kalkan**'ı açın, belgeye uyan denetimleri seçin ve bir sorunu düzeltirken tek bir denetimi ya da gönderimden önce tüm kümesi çalıştırın.

![Oleafly'nin Preflight paneli. İhtiyacınız olan denetimleri seçin, birini kendi satırından çalıştırın ya da tüm etkin denetimleri alttaki düğmeden çalıştırın.](https://cdn.oleafly.com/images/screenshots/desktop/docs/preflight-checks-dark-window-v2.png#view=0,45,344,689)

![Preflight, bir makale gönderilmeden önce derleme, gönderim ve erişilebilirlik denetimlerini çalıştırır.](https://cdn.oleafly.com/images/gifs/desktop/preflight.gif?v=2)

## Altı bağımsız denetim

### Derleme ve düzen

En son derleme günlüğünü ve PDF'i; başarısız derlemeler, çözümlenmemiş atıflar ve başvurular, yeniden çalıştırma uyarıları, eksik glifler, taşan kutular, kırpılan metin, yinelenen PDF hedefleri ve karışık sayfa boyutları açısından okur.

### Gönderime hazırlık

Projeye seçilmiş bir yayın profili uygular. Belge sınıfı, özet ve anahtar sözcükler, şekil biçimleri, gömülü yazı tipleri, PDF kısıtlamaları, başlıklar, taşınabilir adlar ve kaynak paketi dağınıklığı çevresindeki kararlı gereksinimleri denetler.

### ATS hazırlığı

Bir özgeçmişi, bir Başvuru Takip Sisteminin yapacağına çok benzer biçimde çıkarır. İletişim alanlarını, beklenen bölümleri ve okuma sırasını karıştırabilecek yerleşimleri bildirir.

### Erişilebilirlik

Etiketleme, alternatif metin, dil ve başlık üst verisi, görüntüleyici ayarları, başlıklar, tablolar, bağlantılar, okuma sırası, seçilebilir metin, yararlı olduğu yerlerde yer imleri ve çok küçük metin çevresindeki kaynak ve PDF sinyallerini denetler.

### Kaynaklar ve varlıklar

Eksik dosyaları, çözümlenmemiş atıfları ve çapraz başvuruları, yinelenen etiketleri ve DOI'ları, eksik kaynakça kayıtlarını ve tam proje kullanılabilir olduğunda atıf yapılmamış başvuruları bulur.

### Gizlilik ve kör hakemlik

Kimlik bilgilerini, özel anahtarları, hassas dosyaları, taslak notları, iç açıklamaları, teşekkürleri, yazar alanlarını ve kör hakemliği bozabilecek kimlik üst verisini arar.

## Typst projeleri

Typst kaynakları kendi denetimlerini alır. Bunlar `.typ` dosyalarınızı doğrudan okur, bu yüzden LaTeX kuralları asla Typst sözdiziminde tetiklenmez.

- **Kaynaklar ve varlıklar**; eşleşen etiketi ya da kaynakça kaydı olmayan `@` başvurularını ve atıfları, yinelenen etiketleri, hiçbir proje dosyasıyla eşleşmeyen görsel ya da `#include` yollarını, projede bulunmayan bir `#bibliography` dosyasını ve kaynaklara atıf yapan ama hiç `#bibliography` çağırmayan bir belgeyi bulur. Atıf anahtarları bir `.bib` dosyasında ya da bir Hayagriva `.yml` dosyasında yer alabilir.
- **Erişilebilirlik**; görselde ya da onu tutan şekilde `alt` metni olmayan görselleri, boş başlıkları ve `#set document(title: ...)` ya da şablon yoluyla başlık ayarlanmamış bir belgeyi işaretler.
- **Gönderime hazırlık**, projenin seçilen profile uyan bir şablonu içe aktardığını, şablonun bir özet ve anahtar sözcükler aldığını ve hiç `#lorem` metni, yer tutucu ya da TODO notu kalmadığını denetler. Ayrıca başlıklara, görsel boyutlarına ve dosya adlarına bakar.
- **Gizlilik ve kör hakemlik**, şablona geçirilen yazar adlarını, e-postaları ve kurum bilgilerini, teşekkürleri ve yerel dosya yollarını bulur.

Her bulgu dosyayı ve satırı adlandırır ve ayrıntısı, `#image("chart.png", alt: "Bar chart of yearly sales")` gibi Typst düzeltmesini gösterir.

## Yalnızca rengi değil, kesinliği okuyun

Her sonuç, Oleafly'nin ona nasıl ulaştığını açıklar:

- **Doğrulanmış**, uygulamanın kaynakta, günlükte, projede veya PDF'te doğrudan kanıt gözlemlediği anlamına gelir.
- **Tavsiye**, belgelenmiş bir buluşsal yöntemin bir kişinin incelemesi gereken bir şey bulduğu anlamına gelir.
- **Elle**, dosyaların güvenle sonuçlandıramayacağı bir denetimi adlandırır.

Eksik bir girdi asla geçti durumuna dönüşmez. Yalnızca kaynaktan gelen bulgular, güncel bir PDF var olana kadar kısmi kalır.

## Bir yayın profili seçin

Varış yerine en çok uyan genel yayın, arXiv, IEEE, ACM, dergi ya da tez profilini kullanın. Profiller, otomatik olarak denetlenecek kadar kararlı gereksinimleri kapsar. Bir Typst projesinde profil ayrıca eşleşen bir Typst şablonu bekler ve bulgu, kabul ettiği şablonları adlandırır.

Ardından geçerli yayın yerinin yönergelerini açın. Sayfa sınırları, kenar boşlukları, dosya boyutu üst sınırları, anonimleştirme kuralları ve adlandırma gelenekleri, genel bir profilin karar verebileceğinden daha sık değişir.

## Başka bir okuyucunun ne aldığını görün

Preflight panelinde **Ekran okuyucu**'yu seçerek PDF metnini sayfa sayfa çıkaran **Okuyucunun gördüğü**'nü açın. Sayfanın üzerinden düz okunan iki sütunlu bir makaleyi, eksik bir simge yazı tipi telefon numarasını, yanlış yerde bir başlığı ya da seçilebilir metni olmayan bir sayfayı yakalamak için kullanın.

Özgeçmişler için **Bir ayrıştırıcının çıkardıkları**, ATS benzetiminin kurtarabildiği adı, e-postayı, telefonu, bağlantıları ve standart bölümleri gösterir.

Bu görünümler kanıttır; kitlenizin kullandığı gerçek gönderim portalı, ekran okuyucu ya da ayrıştırıcıyla test yapmanın yerini tutmaz.

## PDF/UA ve erişilebilirlik: dürüst sınır

Oleafly, PDF/UA-1'in dosyadan okuyabildiği bölümünü denetler. Bulgular; PDF/UA-1, farklı olduğu yerde PDF/UA-2, Matterhorn Protocol kontrol noktaları ve WCAG 2.2 PDF tekniklerine atıf yapar.

Rapor, şu gibi makine tarafından okunabilir sinyalleri kapsar:

- gerçek içerik barındıran bir etiket ağacı;
- şekillerde ve formüllerde alternatif metin;
- tablolarda üstbilgi hücreleri;
- başlık ilerleyişi;
- belge dili ve XMP başlığı;
- başlığı görüntüleyen görüntüleyici tercihi;
- bağlantı açıklamaları ve şüpheli etiketsiz içerik;
- dosyanın beyan edilen bir PDF/UA-1 iddiasını destekleyip desteklemediği.

Panel, 106 makineyle denetlenebilir PDF/UA-1 kuralından kaçının doğrulandığını bildirir. Ayrıca bir kuralın okunamadığında ya da uygulanmadığında bunu size söyler. Denetlenmemiş bir kural geçti olarak sayılmaz.

:::caution[Preflight, PDF/UA uygunluğunu onaylamaz]
Bu bir alt küme denetimidir, uygunluk bildirimi değildir. Oleafly; alternatif metnin anlamlı olup olmadığına, okuma sırasının bir kişiye anlamlı gelip gelmediğine, renk karşıtlığının yeterli olup olmadığına ya da belgenin bir okuyucunun yardımcı teknolojisiyle iyi çalışıp çalışmadığına karar veremez. Resmî bir uygunluk sonucu için nihai dosyayı veraPDF veya PAC 2024 ile doğrulayın ve bir insan incelemesi tamamlayın.
:::

## LaTeX'ten etiketli PDF hazırlama

LaTeX etiketlemesi; belge sınıfına, paketlere, motora ve TeX Live sürümüne bağlıdır. Preflight, hazırlık önermeden önce etkin ana belgeyi ve yüklediği önbölüm dosyalarını denetler.

1. Geçerli PDF üzerinde **Erişilebilirlik**'i çalıştırın ve bulguları okuyun.
2. **Erişilebilir dışa aktarma**'yı açın.
3. Sınıf ve paket uyumluluk raporunu denetleyin. Uyumsuz bir sınıf hazırlığı engeller; kısmen uyumlu ya da bilinmeyen bir paket uyarı olarak görünür.
4. **Erişilebilir dışa aktarma için hazırla**'yı seçin ve önerilen her kaynak değişikliğini gözden geçirin.
5. Oluşturulan her alternatif metin yer tutucusunu anlamlı bir açıklamayla değiştirin ve istendiğinde belge başlığını ekleyin.
6. TeX Live 2026'dan ya da Kasım 2025'ten beri güncellenmiş bir TeX Live'dan pdfLaTeX ya da LuaLaTeX ile derleyin. Erişilebilir matematik LuaLaTeX gerektirir.
7. Erişilebilirlik'i yeniden çalıştırın, okuyucu görünümünü inceleyin, ardından uygunluk önemliyse nihai PDF'i Oleafly dışında doğrulayın.

Hazırlık; `\DocumentMetadata`'yi dil, PDF/UA-2 niyeti ve etiketlemeyle ekleyebilir ya da güncelleyebilir; ilk tablo üstbilgi satırını bildirebilir; eksik şekil alternatifleri için görünür yer tutucular ekleyebilir ve seçilen motor gerektirdiğinde `unicode-math` ekleyebilir. Değişiklikleri uygulamadan önce gösterir.

`\DocumentMetadata` satırı bir sürüm denetiminin içine girer. Paketlenmiş motorunki gibi Kasım 2025'ten eski bir LaTeX onu atlar ve belgeyi başarısız olmak yerine etiketsiz derler; PDF herhangi bir PDF/UA iddiasında bulunmaz. Preflight bunun üzerine **Bu LaTeX çok eski olduğu için etiketleme atlandı** bulgusunu bildirir ve derlemenin çalıştığı LaTeX'i adlandırır.

Paketlenmiş Tectonic motoru etiket ağacı oluştamaz. **Etiketli derle ve doğrula**, kullanılabilir bir sistem TeX dağıtımını ya da Oleafly'nin yönettiği TinyTeX'i kullanır ve bir Tectonic projesinde bile her zaman LuaLaTeX çalıştırır. Etiketli derleme TinyTeX'te `tagpdf-base.sty` gibi eksik bir dosyada durursa, normal bir derlemenin yaptığı gibi onu kurmayı önerir, ardından etiketli derlemeyi yeniden çalıştırır. Hazırlanan kaynağı kendi güncel araç zincirinizle de derleyebilirsiniz.

:::note[Uyumluluk engel olabilir]
Preflight, LaTeX Projesi'nin yayımladığı etiketleme durumu verilerini kullanır. Desteklenmeyen sınıflar engellenir, kısmen desteklenen sınıflar uyarıyla işaretlenir ve verilerde bulunmayan paketler güvenli varsayılmak yerine bilinmiyor olarak ele alınır. `enumitem`, etiketli iş akışında yüklenemediği için şu anda engellenmiştir.
:::

TinyTeX, paket durumu ve sistem TeX çevresindeki güvenlik sınırı için [LaTeX motorları ve paketleri](/docs/latex-engines/) bölümüne bakın.

## Typst'ten PDF standartları

Bir Typst projesinde hazırlanacak kaynak yoktur. Typst arşivlik ve erişilebilir PDF'leri kendisi yazar, bu yüzden **Erişilebilirlik** denetimi, **Erişilebilir dışa aktarma** yerine **PDF standartları** gösterir.

1. **Erişilebilirlik**'i çalıştırın ve eksik alternatif metin ile eksik belge başlığını düzeltin. PDF/UA-1 her ikisini de gerektirir.
2. **PDF standartları** altında bir **Standart** seçin; örneğin PDF/UA-1 veya PDF/A-2b.
3. **PDF'i dışa aktar**'ı seçin ve dosyayı kaydedin.
4. Uygunluk önemliyse, dışa aktarılan PDF'i Oleafly dışında doğrulayın.

Typst 0.14 ve sonrası her PDF'i etiketler, bu yüzden ayrı bir etiketli derleme yoktur. Daha eski sürümler daha az standart sunar ve Typst 0.11 hiç sunmaz; panel hangisinin geçerli olduğunu söyler. Daha yeni bir sürümü kullanmak için derleme menüsündeki **Typst sürümü (bu proje)** seçeneğini değiştirin. [Typst projeleri](/docs/typst/#what-each-version-can-do) bölümüne bakın.

## Pratik bir son tur

1. Göndermeyi düşündüğünüz tam kaynağı derleyin.
2. İlgili tüm Preflight denetimlerini çalıştırın.
3. Doğrulanmış bulguları düzeltin ve tavsiyeleri araştırın.
4. Geçerli yayın yeri kılavuzuna göre her elle yapılacak öğeyi tamamlayın.
5. Nihai PDF'i ilk sayfadan son sayfaya kadar, başvurular ve ekler dahil okuyun.
6. Dışa aktarılan dosyayı ve kaynak arşivini kaydedildikleri konumlardan açın.
7. Son tarihten önce varış yerinin kendi doğrulayıcısını kullanın.

Preflight, önlenebilir sürprizleri azaltır. Kabul, erişilebilirlik ve bilimsel doğruluk yine de yazarı, yayın yerini ve belgeyi kullanacak kişileri gerektirir.
