Connect ile etiketli PDF eğitimi

Connect ile etiketli PDF eğitimi

Uygunluk sınırı (önce bunu okuyun). NextPDF, etiketli yapıyı, alternatif metni ve PDF/UA-2 tarafından beklenen meta verileri üretir. Böylece çıktı, PDF/UA-2’ye (ISO 14289-2) uygun olması amaçlanan bir çıktı haline gelir. Bu, belgeyi tek başına “uygun” hale getirmez. Uygunluğa, katı PDF/UA-2 modundaki veraPDF gibi bağımsız bir denetleyici karar verir. Aşağıdaki her “PASS”, “uygun” veya “uyumlu” ifadesini “belgenin uygun olması amaçlanmıştır; sonucu veraPDF belirler” şeklinde okuyun.

Genel bakış

Bu eğitimde, Connect aktarımlarıyla etiketli bir Portable Document Format (PDF) dosyası oluşturursunuz. Etiketli modu etkinleştirir, bir başlık belirler, anlamsal HTML eklersiniz ve sonucu standartlara uygunluk denetimi aracı ve veraPDF ile doğrularsınız. Burada kullanılan etiketli mod ve içerik araçları core kapsamındadır. Standartlara uygunluk denetimi doğrulama aracı Pro/Enterprise katmanındadır. Araç, class_exists() aracılığıyla yalnızca nextpdf/premium sunucuyla birlikte kurulduğunda kaydolur.

Kurulum

composer require nextpdf/server

Kavramsal genel bakış

Mantıksal yapı ve doğal dil belirtimi birlikte, içeriği okuma sırasına göre gezilebilir kılar (ISO 32000-2 §14.7). /Alt girdisi, metin olmayan içerik için alternatif bir açıklama tutar (ISO 32000-2 §14.8). İçerik, yapı ağacında yansıtılmalıdır ve uygunluğa bir denetleyici karar verir (PDF/UA-2 §8.2.4). İyi yapılandırılmış anlamsal HTML yazdığınızda, ardışık düzen sizin yerinize doğru yapıyı üretir. Bu eğitim, sizden yapıyı elle oluşturmanızı istemek yerine bu akışa dayanır.

API yüzeyi

Araç adları, çalışma zamanı kayıt defterine göre tools/list aracılığıyla doğrulanır. Resmi katalog /connect/tool-catalog/. adresindedir. Bu eğitimde araç sayısı tekrarlanmaz.

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

En kısa yol şudur. Etiketli modu bir dil belirterek etkinleştirin, bir başlık belirleyin ve ardından içerik ekleyin.

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "enable_tagged_pdf",
    "arguments": { "document_id": "<id>", "language": "en" }
  }
}

İlk içerik çağrınızdan önce etiketli modu etkinleştirin. Yazıcı, ilk sayfayı ürettiğinde modu dondurur. Daha sonra etkinleştirirseniz, NextPDF geri dönüp zaten üretilmiş içeriği etiketlemez. PDF/UA-2 için belge başlığı zorunludur ve etiketli mod, görüntüleyici başlık tercihini ayarlar.

Kod örneği — üretim

Anlamsal HTML ekleyin. Ardışık düzen, başlıkları, listeleri, <th scope> içeren tabloları, bağlantıları ve alt içeren şekilleri doğru yapı türlerine eşler:

{
  "jsonrpc": "2.0",
  "id": 5,
  "method": "tools/call",
  "params": {
    "name": "add_html",
    "arguments": {
      "document_id": "<id>",
      "html": "<h1>Annual Report</h1><h2>Summary</h2><p>Revenue grew.</p><table><caption>Revenue</caption><thead><tr><th scope=\"col\">Region</th><th scope=\"col\">Q1</th></tr></thead><tbody><tr><th scope=\"row\">EMEA</th><td>120</td></tr></tbody></table><figure><img src=\"chart.png\" alt=\"Revenue by region bar chart\" /><figcaption>Figure 1.</figcaption></figure>"
    }
  }
}

RevenueRegionQ1EMEA120

Figure 1.

" } }}">

Ardından standartlara uygunluk denetimini PDF/UA-2’ye göre çalıştırın ve çıktı üzerinde veraPDF’yi --flavour ua2 ile çalıştırın. Denetim sonucu ve veraPDF kararı birer değerlendirmedir. Bu sonuçlar, belgenin uygun olmasının amaçlanıp amaçlanmadığını size bildirir. Uygunluğa NextPDF değil, veraPDF karar verir.

Uç durumlar ve dikkat edilecek noktalar

• İçerikten sonra etkinleştirilen etiketli mod. Modu etkinleştirmeden önce eklediğiniz tüm içerik etiketsizdir. Denetim, etiketli içerik hatası bildirir. Belgeyi oluşturduktan hemen sonra modu etkinleştirin.
• alt içermeyen bilgilendirici görsel. Denetim, şekil alternatif metni hatası bildirir. Alternatif metin verin ya da dekoratif bir görseli yapay öğe olarak işaretleyin (/cookbook/connect/page-artifacts/).
• Atlanmış başlık düzeyi. Bir düzeyi atlamak, örneğin H1 ardından H3, başlık sırası hatasıdır. Her seferinde en fazla bir düzey aşağı inin.
• scope içermeyen <th>. İlişkili veri hücreleri bulunmayan bir başlık hücresi, tablo yapısı hatasıdır. Her <th> öğesine ya scope="col" ya da scope="row" verin.
• Eksik başlık. Başlığı olmayan bir belge, meta veri hatasıdır. Başlığı, etiketli modu etkinleştirdikten sonra belirleyin.

Performans

Belirtilen bütçe, belgeleme amaçlı bir üst sınırdır. Etiketleme, normal yerleşim geçişinin bir parçasıdır.

Güvenlik notları

Burada, genel Connect aktarım yönergesinin ötesinde ek bir gereklilik yoktur: belge içeriğini veya HTML gövdesini, dışarıya aktarılan bir günlük düzeyinde günlüğe yazmayın.

Uygunluk

PDF/UA-2 eşlemesi

Anlamsal HTML, PDF/UA-2 standart yapı türlerine eşlenir (H1–H6, P, L/LI/Lbl/LBody, Table/TR/TH/TD, Link, Figure/Caption, Aside). Eşleme otomatiktir. Sözleşmede size düşen, anlamsal HTML yazmaktır.

Etiket → ISO 32000-2 §14.9 çapraz başvuru

İddia	Madde	reference_id
Mantıksal yapı + dil → okuma sırasına göre gezilebilir	ISO 32000-2 §14.7
Alternatif açıklama şu girdide tutulur: /Alt	ISO 32000-2 §14.8
Yapı ağacındaki içerik; uygunluğa denetleyici karar verir	PDF/UA-2 §8.2.4

WCAG 2.2 eşlemesi

Yapı, içerik düzeyinde WCAG 2.2 SC 1.1.1, 1.3.1, 2.4.1 ve 2.4.6 ölçütlerini destekler. İçerik yazarı olarak, WCAG düzeyindeki içerik oluşturma kararlarından siz sorumlu olmaya devam edersiniz.

NextPDF, PDF/UA-2’ye uygun olması amaçlanan çıktı üretir. Uygunluk iddiasında bulunmaz. Uygunluk belirlemesini veraPDF ya da başka bir denetleyici yapar. Başarılı bir denetim ya da veraPDF çalıştırması, çıktının uygun olmasının amaçlandığına dair bir kanıttır; NextPDF tarafından verilen bir sertifika değildir.

Ticari bağlam

Etiketli mod ve içerik araçları core kapsamındadır. Standartlara uygunluk denetimi doğrulama aracı Pro/Enterprise katmanındadır ve yalnızca nextpdf/premium sunucuyla birlikte kurulduğunda kaydolur.

Connect ayrıntıları

Aktarım kullanılabilirliği (MCP / REST / gRPC)

Bu eğitimdeki her aracı MCP tools/call, REST araç uç noktası ve gRPC hizmeti üzerinden aynı şekilde çağırırsınız. Bunların tümü, paylaşılan araç yürütücüsü üzerinden çalışır.

HITL risk katmanı

Etiketli modu etkinleştirmek ve içerik araçlarını kullanmak dikkat düzeyi kapsamındadır. Standartlara uygunluk denetimi salt okunurdur. Dosyaya yazan çıktı yolu onay gerektirir; base64 modu ise gerektirmez. /connect/hitl-risk-tiers/. sayfasına bakın.

Onay geçidi JSON zarfı

Dosyaya yazan çıktı yolu geçitle korunduğunda, geçit bir sınama zarfı ve tek kullanımlık bir belirteç döndürür. Belirteç; araç adına, bir nonce değerine ve 300 saniyelik bir yaşam süresine (TTL) bağlıdır. Devam etmek için aracı arguments._confirmation_token ile yeniden çağırın. /connect/hitl-risk-tiers/. sayfasına bakın.

Ayrıca bakınız

• /cookbook/connect/conformance-mode/ — etiketli modun arkasındaki mod ayırıcısı.
• /cookbook/connect/aria-tagged-pdf/ — yer imi rolü eşlemesi.
• /cookbook/connect/page-artifacts/ — dekoratif içeriği yapı ağacının dışında bırakın.
• /connect/tool-catalog/ — katman başına araç kümesi hesaplaması.