NextPDF Connect'te (Pro) yapısal erişilebilirliği denetleyin

Bir bakışta

NextPDF Connect’te yapısal erişilebilirlik analizini çalıştırın. Pro araç sağlayıcısında doğrulanmış check_accessibility aracını kullanın; bu sağlayıcı, new CheckAccessibilityTool() nesnesini check_accessibility protokol adıyla kaydeder. Aracın açıklaması kapsamını belirtir: bir PDF’nin yapısal erişilebilirliğini analiz eder — başlıklar, tablolar, görseller ve okuma sırası göstergeleri. Göstergeleri ve düzeltme ipuçlarını döndürür. Portable Document Format/Universal Accessibility (PDF/UA) veya Web Content Accessibility Guidelines (WCAG) uyumluluğunu belgelendirmez. Bu belirlemeyi veraPDF veya bir PDF/UA test aracı gibi bir uyumluluk denetleyicisi yapar. check_accessibility, Pro katmanına ait bir araçtır. NextPDF, başlatma sırasında varlığını class_exists() ile yoklar ve yalnızca Pro paketi kurulu olduğunda kaydeder.

Kurulum

composer require nextpdf/server
composer require nextpdf/pro

Bir taşıma katmanı bağladıktan sonra aracı diagnostic.capabilities ile doğrulayın.

Kavramsal genel bakış

Erişilebilir yapı iki unsura bağlıdır: yapı öğelerinden oluşan mantıksal bir yapı ağacı (ISO 32000-2 §14.7) ve katalog Lang girişi aracılığıyla belirtilen bir belge dili (ISO 32000-2 §14.9; PDF/UA-2 §8.4.4). check_accessibility, bu yapısal göstergeleri inceler ve önem derecesi ile düzeltme yönergeleri içeren bulgular döndürür. Rapordaki herhangi bir sayısal puanı veya pass/fail değerini belgelendirme olarak değil, gösterge özeti olarak değerlendirin. Bunu önceliklendirme için kullanın.

API yüzeyi

Araç	Katman	Rol	Risk katmanı
`create_pdf`, `add_text`	Core	İncelenecek içeriği oluşturun	Güvenli / Dikkat
`check_accessibility`	Pro	Yapısal erişilebilirlik analizi	Güvenli
`output_pdf`	Core	PDF’yi işleyip döndürün	Onay Gerekli / İnceleme (base64)

Araç adları, kayıt defterindeki protokol adlarıdır. araç kataloğu, kayıtlı kataloğun kendisini gösterir. Hangi araçların kullanılabilir olduğunu kurulu katman belirler.

Kod örneği — hızlı başlangıç

create_pdf → add_text ile içerik ekleyin.
check_accessibility aracını document_id ile çalıştırın.
Bulguları gözden geçirin: önem derecesi, gösterge, etkilenen sayfa ve düzeltme ipucu.
İsteğe bağlı olarak, raporla birlikte elle inceleme için output_pdf (base64) kullanın.

Kod örneği — üretim

Raporu bir karar olarak değil, önceliklendirme girdisi olarak değerlendirin. Her bulguyu somut bir düzeltmeye eşleyin: etiketli çıktıyı etkinleştirin, belge dilini ayarlayın ve başlık yapısı ekleyin. Uyumluluk geçidi için harici bir denetleyici çalıştırın. Yetkili kabul edeceğiniz sonuç, bu aracın puanı değil, harici denetleyicinin kararıdır. Denetimi, output_pdf işleminden (destroy: true ile) önce çalıştırın; aksi takdirde belgeyi artık göremezsiniz.

Sınır durumları & tuzaklar

İçerik yok. Boş bir belge, belgelendirme yerine içerik yok bulgusu döndürür.
Büyük belge. Zaman aşımı analizi sınırlar; büyük girdileri bölün veya aralıklara ayırın.
Yok edilmiş oturum. Denetimi, çıktı oturumu yok edilmeden önce çalıştırın.
Şifrelenmiş kaynak. Parolayı sağlayın.
Pro yok. Yalnızca Core kullanıldığında, check_accessibility kaydedilmez.

Performans

Bütçedeki zaman aşımı, analizi sınırlar. Profil semantic olarak ayarlıdır: rapor, yapısal analiz çıktısıdır; bu nedenle bayt çıktısını değil, bulguları karşılaştırın.

Güvenlik notları

Rapor, içerikteki gizli bilgileri değil, yapıyı tanımlar. Analiz edilen belge yine de hassas olabilir; bu nedenle onu güven sınırınız içinde tutun. Analiz akışı, dosya sistemine yazmaz.

Uyumluluk

İfade	Spesifikasyon	Madde
Mantıksal yapı, yapı öğelerinden oluşan bir ağaçtır.	ISO 32000-2	§14.7
Belge dili, `Lang` girişi aracılığıyla belirtilir.	ISO 32000-2	§14.9
Erişilebilir yazım için doğal dilin belirtilmesi gerekir.	PDF/UA-2	§8.4.4

check_accessibility, erişilebilir yazımı destekleyen yapısal göstergeleri bildirir. PDF/UA veya WCAG uyumluluğu iddiasında bulunmaz. Bunu bağımsız bir denetleyici belirler.

Ticari bağlam

check_accessibility, Pro katmanına ait bir araçtır. NextPDF bunu, yalnızca Pro paketi sunucu başlatılırken çözümlendiğinde kaydeder.

PDF/UA-2 eşlemesi

Bu aracın incelediği yapısal göstergeler, PDF/UA-2 yazım gereksinimleriyle eşleşir: etiketli bir yapı ağacı (ISO 32000-2 §14.7) ve belirtilen bir belge dili (PDF/UA-2 §8.4.4). Araç, bu göstergelerin var olup olmadığını bildirir. PDF/UA-2 uyumluluğunu, aracın raporu değil, bir PDF/UA denetleyicisi belirler.

Etiket → ISO 32000-2 §14 çapraz başvurusu

Başlık ve tablo bulguları, ISO 32000-2 §14.7 yapı ağacındaki mantıksal yapı öğelerine karşılık gelir. Dil bulgusu, §14.9 Lang girişine karşılık gelir. Araç, bu yapısal bağlantı noktalarının var olup olmadığını bildirir. Her §14 etiket kuralını doğrulamaz; bu, bir denetleyicinin işidir.

WCAG 2.2 eşlemesi

Kontrast ve okuma sırası bulguları, kontrast ve anlamlı sıra gibi WCAG başarı ölçütleriyle ilişkilidir. Araç, ölçülen bir kontrast oranı gibi gösterge değerlerini bildirir. Bir WCAG uyumluluk iddiası, bu aracın gerçekleştirmediği ve öne sürmediği eksiksiz bir WCAG değerlendirmesi gerektirir.

Taşıma katmanı kullanılabilirliği

Taşıma katmanı	Kullanılabilir	Notlar
MCP (stdio)	Evet (Pro)	Rapor, bir araç sonucudur.
REST	Evet (Pro)	Rapor, yanıt gövdesidir.
gRPC	Evet (Pro)	Unary; rapor, yanıt mesajında yer alır.

HITL risk katmanı

check_accessibility Güvenlidir (salt okunur analiz) ve asla geçit görevi görmez. Bir dosyaya output_pdf uygulamak Onay Gereklidir ve base64 modu İncelemedir (HITL risk katmanları).

Onay geçidi JSON zarfı

Analiz asla geçit görevi görmez:

{ "allowed": true }