Connect üzerinden sayfa yapaylıklarını işaretleme

Genel bakış

Bu tarif; üstte ve altta yinelenen başlıklar, sayfa numaraları, filigranlar ve arka planlar dâhil sayfalama süslemelerini Connect taşımaları üzerinden yapaylık olarak işaretlenmiş içerikle sarar. Süslemeler sayfada yine görünür, ancak yapı ağacının ve yardımcı teknolojilerin okuma sırasının dışında kalır. Yapaylık aracı Enterprise katmanındadır: NextPDF bu aracı bir class_exists() yoklamasıyla algılar ve yalnızca nextpdf/premium sunucuyla birlikte kurulduğunda kaydeder. Alt tür için türlenmiş bir enum kullanılır (Pagination, Layout, Page, Background).

Çıktıyı doğrulamak için PDF/UA-2’ye göre rapor veren Enterprise standart denetim aracını kullanın. Başarılı sonuç, aracın kendi denetimidir; bağımsız bir uygunluk sertifikası değildir.

Kurulum

composer require nextpdf/server

Enterprise yapaylık aracının mevcut olduğunu bir tools/list çağrısıyla doğrulayın. Bkz. /connect/tool-catalog/.

Kavramsal genel bakış

Mantıksal yapının parçası olmayan içerik, yapaylık olarak işaretlenir ve okuma sırasının dışında bırakılır (PDF/UA-2 §8.3). Yapaylıklar; sayfalama, yerleşim, sayfa veya arka plan içeriğini kapsar ve gerçek içerikten ayrılır (PDF/UA-2 §8.3). Gerçek içerik yapı ağacında yansıtılır; yapaylıklar yansıtılmaz (PDF/UA-2 §8.2.4).

Araç, istenen alt türde yapaylık olarak işaretli bir içerik dizisi açar. Eşleşen kapatma işleminden önce verdiğiniz tüm çizim işlemleri bunun içine alınır.

API yüzeyi

Araç adlarını çalışan kayıt defterine göre tools/list ile doğrulayın. Resmî katalog /connect/tool-catalog/ adresindedir. Bu tarif araç listesini yinelemez.

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

Bir Background yapaylığı açın, filigranı çizin ve kapatın:

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "emit_artifact",
    "arguments": { "document_id": "<id>", "subtype": "Background" }
  }
}

Kod örneği — üretim

Her açma işlemini bir kapatma işlemiyle eşleştirin ve sayfada öksüz içerik kalmadığını doğrulayın:

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "emit_artifact",
    "arguments": { "document_id": "<id>", "subtype": "Page", "attached": "Bottom" }
  }
}

Altbilgi metnini çizdikten sonra, yapaylığı sonlandırma aracıyla kapatın ve standart denetimini PDF/UA-2’ye göre çalıştırın. Yapı ağacı yalnızca gövde içeriğini içermelidir; filigran ve altbilgi dışarıda bırakılmalıdır.

Uç durumlar ve tuzaklar

Bilinmeyen alt tür (örneğin "Header") reddedilir. Şunlardan birini geçirin: Pagination, Layout, Page, Background.
Açma olmadan kapatma, derinlik-sıfır iletisiyle başarısız olur. Açma ve kapatmayı her zaman eşleştirin.
Bir yapaylık veya yapı bağlamı açmadan önce çizim yapmak, öksüz içerik ve bir yapı kuralı hatası üretir. Önce bir yapı veya yapaylık bağlamı açın.
Araç yok. nextpdf/premium olmadan, Enterprise yapaylık aracı kaydedilmez ve çağrı, bilinmeyen araç hatasıyla başarısız olur.

Başarım

Frontmatter bütçesi, belgelendirme için belirlenmiş bir üst sınırdır. Yapaylık sarmalama işlemi, ölçülebilir ayrı bir aşama eklemez.

Güvenlik notları

Genel Connect taşıma yönergeleri dışında ek bir nokta yoktur.

Uygunluk

PDF/UA-2 eşlemesi

Alt tür	Kullanım durumu
`Pagination`	Yinelenen headers/footers, sayfa numaraları, gezinti süslemeleri
`Layout`	Çizgiler, ayırıcılar, süsleyici kenarlıklar
`Page`	Sayfaya bağlı yardımcılar (kesim işaretleri, hizalama)
`Background`	Filigranlar, arka plan dolguları, marka ögeleri

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

İddia	Madde	reference_id
Yapaylık olarak işaretlenip okuma sırasının dışında bırakılan yapısal olmayan içerik	PDF/UA-2 §8.3
Yapaylık alt türleri: pagination/layout/page/background	PDF/UA-2 §8.3
Gerçek içerik yapı ağacında yer alır; yapaylıklar yer almaz	PDF/UA-2 §8.2.4

WCAG 2.2 eşlemesi

Süsleyici öğeleri okuma sırasının dışında bırakmak, içerik düzeyinde Web Content Accessibility Guidelines (WCAG) 2.2 SC 1.3.1 (Info and Relationships) başarı ölçütünü destekler.

Başarılı bir standart denetimi sonucu, bir denetim çıktısıdır; uygunluk sertifikası değildir. Bu belirlemeyi bağımsız bir denetleyici yapar.

Ticari bağlam

Yapaylık aracı Enterprise katmanındadır ve yalnızca nextpdf/premium sunucuyla birlikte kurulduğunda kaydedilir.

Connect ayrıntıları

Taşıma kullanılabilirliği (MCP / REST / gRPC)

Bu araçları MCP tools/call üzerinden, REST araç uç noktası üzerinden ve gRPC hizmeti üzerinden aynı şekilde çağırırsınız. Üçü de ortak araç yürütücüsünü kullanır.

HITL risk katmanı

Yapaylık yayımı ve içerik çizimi dikkat düzeyindedir; standart denetimi salt okunurdur. Varsayılan olarak hiçbiri approval_required değildir. Bkz. /connect/hitl-risk-tiers/.

Onay kapısı JSON zarfı

İşletmen tarafından yapılan bir geçersiz kılma işlemi bunlardan birini approval_required düzeyine yükseltmedikçe bu araçlar kapıyı tetiklemez. Zarf ve tek kullanımlık belirteç sözleşmesi şurada yer alır: /connect/hitl-risk-tiers/.

Ayrıca bkz.

/cookbook/connect/aria-tagged-pdf/ — yer imi rolü eşlemesi.
/cookbook/connect/figure-caption/ — erişilebilir görüntü gruplaması.
/connect/tool-catalog/ — katman başına araç kümesi dökümü.
/connect/hitl-risk-tiers/ — risk modeli ve kapı.