İç geliştirmede tutulan bir PDF/UA-1 kontrol listesi, veraPDF'in geçirdiği bir PDF/UA-2 çıktısını reddeder; /ActualText () ile etiketlenmiş bir figure'i, /Contents'siz link annotation'larını ve namespace'leri karıştıran bir yapı ağacını bayraklar. Her biri ISO 14289-2:2024'e uygundur; dolayısıyla kural kümesi her dosyanın beyan ettiği bölümü izlemek zorundadır — bu da PDFium Component'in TPdf.ValidatePdfUa çağrısının ilk okuduğu şeydir
Beyan edilen bölüm hangi kuralların uygulanacağına karar verir
Her PDF/UA dosyası bölümünü XMP meta verisinde pdfuaid:part ile adlandırır ve PDF/UA-2 kendi başına iki koşul daha ekler: bir revision girdisi ve PDF 2.0 beyan eden bir dosya. O beyan anahtardır. TPdf.ValidatePdfUa, Conformance alanı puc1 veya puc2, PDF/UA iddiası bulunmadığı doğrulanan dosya için pucNone, iddia belirlenemiyorsa pucUnknown raporlayan bir TPdfUaValidationResult döndürür ve Issues kümesi yalnızca o bölüme uygulanan bulguları tutar. Bazı issue değerleri 1. bölümde tek bir kuralı, 2. bölümde daha geniş bir kuralı temsil eder. 1. bölüm dosyada pvuaiActionTargetMissing, bir GoToR, URI veya SubmitForm aksiyonunun hedef anahtarı eksik demektir (§7.18.5); 2. bölüm dosyada ayrıca bir yapı ögesine ulaşmayan bir hedef demek olabilir (§8.8). 2. bölüm dosyada pvuaiAnnotationMissingContents, etiketi olmayan widget'ları da kapsar. O yüzden her raporun yanına bölümü basın:
uses
SysUtils, TypInfo, PDFium, FPdfPdfua;
procedure ReportPdfUa(const FileName: string);
const
PartNames: array[TPdfUaConformance] of string =
('unknown', 'not PDF/UA', 'PDF/UA-1', 'PDF/UA-2');
var
Pdf: TPdf;
Report: TPdfUaValidationResult;
Issue: TPdfUaValidationIssue;
begin
Pdf := TPdf.Create(nil);
try
Pdf.FileName := FileName;
Pdf.Active := True;
if not Pdf.Active then
raise Exception.CreateFmt('Cannot open %s', [FileName]);
Report := Pdf.ValidatePdfUa;
Writeln(Format('%s: %s, compliant=%s', [ExtractFileName(FileName),
PartNames[Report.Conformance], BoolToStr(Report.IsCompliant, True)]));
for Issue := Low(TPdfUaValidationIssue) to High(TPdfUaValidationIssue) do
if Issue in Report.Issues then
Writeln(' ', GetEnumName(TypeInfo(TPdfUaValidationIssue), Ord(Issue)));
finally
Pdf.Free;
end;
end;
IsCompliant yalnızca bölüm 1 veya 2 olduğunda ve issue kümesi boş olduğunda doğrudur; dolayısıyla PDF/UA iddiası olmayan bir dosya tesadüfen uyumlu raporlanmaz. veraPDF ile karşılaştırmanın kendi tuzağı vardır. Komut satırı aracı uyumsuz bir dosya için 1 koduyla çıkar. Buna rağmen tam XML raporunu standart çıktıya yazar ve çıkış kodunda duran bir script kural numaralarını çöpe atar. Raporu okuyun
Hangi UA-1 şikayetleri PDF/UA-2 altında yanlış alarmdır?
Açılış örneğindeki her şikayet, PDF/UA-2'nin o biçimde içermediği bir kural uygular. Figure ile başlayın; hata çoğu zaman ayrıştırma kodunda oturur. ISO 14289-2 §8.2.5.28.2, bir Figure'dan bir /Alt veya /ActualText anahtarı taşımasını ister ve test anahtarın var olup olmadığıdır: /ActualText () uyumludur ve yalnızca iki anahtarı da taşımayan bir figure düşer. Her iki değeri de düz dizelerde tutan bir okuyucu, "var ama boş" ile "yok"u aynı '''ye indirger ve checker sonra alternatif metni olan bir figure için eksik alternatif metin raporlar. Yapı ögesini ayrıştırırken her dizenin yanına bir varlık bayrağı saklayın. Boş bir /ActualText, insan bir gözden geçirenin hâlâ görmek isteyebileceği zayıf bir tanımdır; ama bir 2. bölüm validator'ının onu düşürmesi için dayanağı yoktur
Link kuralı gitmiştir. PDF/UA-1 §7.18.5 her link annotation'ının /Contents taşımasını ister; PDF/UA-2 yerine hiçbir annotation-anahtarı kuralı koymaz ve yapıyı §8.2.5.20'de kısıtlar. Farklı hedeflere giden annotation'lar ayrı Link veya Reference yapı ögelerinde oturmalıdır; dolayısıyla hem 2. bölüme atlama hem harici bir siteye URI saran tek bir Link ögesi, iki annotation /Contents taşısa bile 2. bölümde düşer. İki bölüm farklı şeyler test ediyor — biri annotation'ın üzerindeki metni, öteki ağaçtaki gruplamayı. PDFium Component link /Contents gereksinimini yalnızca 1. bölüm beyan eden dosyalara uygular
Namespace şikayeti yanlış belgeyi okumadan gelir. ISO 14289-2 §8.2.4 dört kural tutar: standart olmayan bir yapı tipi standart bir tipe haritalanmalı, hiçbir eşleme döngüsel olmamalı, hiçbir tip aynı açık namespace içinde haritalanmamalı ve standart bir tip standart olmayana yeniden haritalanmamalı. ISO/TS 32005 §5.3, namespace'leri karıştıran belgeler için bir öneri ekler — paylaştıkları tipler için PDF 2.0 namespace'ini kullanın — ve o öneri PDF/UA-2 uyumluluk koşulları arasında değildir. §5.3'te sert düşen bir kontrol listesi, MathML formul taşıyan bir PDF 2.0 ağacı gibi geçerli karışık ağaçları reddeder. Özel bir tipi /RoleMapNS üzerinden standart bir tipe çözmek kendi başına bir iştir; rol haritaları ve namespace'lerle PDF/UA-2 doğrulamasında gösterilir
PDF/UA-2'nin eklediği veya sıkılaştırdığı kurallar
Ters yön, pahalı olandır. Aşağıdaki dosyaları bir UA-1 kontrol listesi geçirir ve hatalar yalnızca biri 2. bölüm validator'ı çalıştırdığında görünür:
- Widget'lar bir etiket veya tanım ister. PDF/UA-1 §7.18.1, widget annotation'larını §7.18.4'ün
Formtag'i kapsadığı için/Contentsdışında tutar. PDF/UA-2 §8.10.2.3, yapı ögesindeLblçocuğu olmayan her widget'ta/Contentsister. Alanın/TUtooltip'i bir etiket sayılmaz - Dosya ekleri ilişkilerini beyan eder. §8.9.2.4.10, bir
FileAttachmentannotation'ının dosya belirtiminin/AFRelationshiptaşımasını ister — Source, Data, Alternative, Supplement ve PDF/A-3'ün ilişkili dosyalar ve AFRelationship için zaten kullandığı öbür değerler - Başlıklar numaralıdır. PDF/UA-1, bir belge ikisini karıştırmadığı sürece (§7.4.4) genel
Htag'ini veya numaralıH1…Hnbaşlıklarını kabul eder. PDF/UA-2 §8.2.5.12 genelH'yi tamamen yasaklar; dolayısıyla düzHögeleri üzerine kurulu bir etiketleme şeması, çıktının 2. bölüm iddia edebilmesi için yeniden haritalanmaya ihtiyaç duyar - Hedefler yapıya ulaşır. §8.8, gezinme hedeflerinin ISO 32000-2 §12.3.2.3 anlamında yapı hedefleri olmasını ister: ilk ögesi bir yapı ögesi olan bir hedef dizisi veya
/SDile bir GoTo aksiyonu
Eski kurallara dokunmayın. Bir kontrol listesi 2. bölüm kapsamı büyüttüğünde bariz düzenleme, widgetsiz /Contents'siz widget'ların bayaklanması için §7.18.1 widget istisnasını silmektir ve o düzenleme, kendi standardının hiç sahip olmadığı bir kural yüzünden uyumlu 1. bölüm formlarını düşürür. 2. bölüm widget kontrolünü istisnanın yanına ekleyin ve beyan edilen bölüme bağlayın. PDFium Component widget kuralını böyle raporlar — 1. bölüm istisnası yürürlükte kalır ve etiket ya da /Contents'siz bir 2. bölüm widget'ı pvuaiAnnotationMissingContents olarak görünür
Yanlış isabet olmadan bir yapı hedefi nasıl test edilir?
Spesifikasyonun kazanır dediği anahtarı okuyun. ISO 32000-2 Tablo 202, her GoTo aksiyonunda /D'yi zorunlu ve /SD'yi opsiyonel kılar ve ikisi de mevcutken yapı hedefinin öncelik alması gerektiğini söyler. Uyumlu bir 2. bölüm link bu yüzden çoğu zaman eski okuyucular için /D [6 0 R /Fit] gibi bir sayfa hedefi ve yanında /SD [19 0 R /Fit] taşır. /D'yi okuyan el yapımı bir kontrol bir sayfa bulur, yapı hedefi olmayan bir hedef raporlar ve dosyayı düşürür. Aksiyonlar için /SD'ye bakın. Çıplak bir hedef dizisi için ilk ögesini izleyin ve referans verilen sözlüğün bir yapı ögesi olup olmadığını sorun; bayt cinsinden bu, üst düzey bir /S anahtarı taşıyan sözlük demektir
Üst düzey olması zordur. Bir sayfa sözlüğü saydamlık grubu için sıradan biçimde /Group << /S /Transparency >> taşır ve iç içe sözlükleri atlamayan bir anahtar araması o iç /S'yi bulur, sayfanın bir yapı ögesi olduğuna karar verir; böylece düz bir sayfa hedefi geçer. Yalnızca dış sözlüğün anahtarlarını tarayın ve her değeri — iç içe sözlükler ve diziler dahil — tek bir bütün nesne olarak atlayın. Bir annotation'ın /StructParent'ını yapı ögesine geri bağlayan ParentTree de aynı özeni ister. Onun /Nums dizisi bir anahtarı tek bir referansla (0 26 0 R) ya da bir diziyle (0 [null 20 0 R]) eşleyebilir ve dizi biçiminde, dizinin içindeki konum /StructParent değerine ulaşmak için anahtara eklenir. Yalnızca ilk biçimi bilen bir ayrıştırıcı, ikinci biçimdeki annotation'ları yapı ebeveyni olmadan bırakır ve §8.2.5.20 gruplama kuralı sonra karşılaştıracak hiçbir şey bulamaz. Bu kontrolleri dosya yüklendiği baytlar üzerinde de çalıştırın: yeniden kaydedilmiş veya normalize edilmiş bir kopya annotation nesnelerini yeniden numaralar ve numara ağacını yeniden kurar — sayfaları düzenledikten sonra /ParentTree ile /StructParents'i senkron tuttuğunuzda yeniden yazdığınız ağacın aynısı
Hangi dil tag'leri /Lang kontrolünü geçer?
Dilbilgisi bölümler arasında değişmedi (ISO 14289-1 §7.2, ISO 14289-2 §8.4.4); gevşek kontrol listeleri yine de onu kaçırır. veraPDF bunu ^[a-zA-Z]{1,8}(-[a-zA-Z0-9]{1,8})*$ olarak ifade eder: bir ila sekiz harften oluşan bir ilk subtag, sonra her biri tireyle açılan bir ila sekiz harf veya rakamlık her sayıda subtag. Sınırlar keskindir. portugue-pt geçer ve portugues-pt, dokuz harfli ilk subtag'ında düşer; nl-1234abcd geçer ve nl-1234abcde düşer; 1-pt ve -pt, ilk karakterde düşer. Yalnızca harfleri, rakamları ve tireleri test eden bir kontrol dört düşüşü de kabul eder. Kataloğun /Lang'i ile her yapı ögesinin /Lang'i tek bir ortak teste muhtaçtır; yoksa aynı tag bir dosyada iki hüküm kazanır. UTF-16BE dizesi olarak saklanan bir tag — örneğin <FEFF0045004E002D00550053> — önce çözülür; o, EN-US okur ve geçer. Kötü tag'ler çoğu zaman sıradan bir yerden gelir: Java, ICU veya veritabanı ayarlarından gelen locale dizeleri alt çizgi kullanır ve pt_BR geçerli bir tag değildir. IsPdfUaLanguageTagValid aynı biçim testini uygular; dolayısıyla bir tag'i yazılmadan önce onarabilirsiniz:
uses
SysUtils, PDFium;
// pt_BR gibi bir platform locale'ini PDF/UA'nın kabul ettiği bir tag'e
// çevir; basit bir ikame onaramıyorsa '' döndür
function LocaleToPdfLang(const Locale: string): string;
begin
Result := StringReplace(Trim(Locale), '_', '-', [rfReplaceAll]);
if not IsPdfUaLanguageTagValid(Result) then
Result := '';
end;
procedure CheckTags;
const
Samples: array[0..6] of string = ('en-US', 'pt_BR', 'zh_CN',
'portugue-pt', 'portugues-pt', 'nl-1234abcd', 'nl-1234abcde');
var
S: string;
begin
// Beklenen:
// en-US, portugue-pt, nl-1234abcd yazıldığı gibi geçerli
// pt_BR, zh_CN geçersiz, pt-BR / zh-CN olarak onarılır
// portugues-pt, nl-1234abcde geçersiz, '' olarak onarılır
for S in Samples do
Writeln(Format('%-14s valid=%-5s repaired=%s', [S,
BoolToStr(IsPdfUaLanguageTagValid(S), True), LocaleToPdfLang(S)]));
end;
Dönüşümü, tag'in kataloğa veya herhangi bir yapı ögesine ulaşmadan önce hattınıza girdiği yerde çağırın. Boş bir sonuç, belgenin kullandığı bilinen bir dile geri dönüş sinyalidir. Ham locale dizesini yine de yazmak hatayı yalnızca aşağı akışa taşır; orada katalog için pvuaiLangInvalidFormat, bir öge için pvuaiStructElementLangInvalid olarak, onu üreten koddan çok uzakta ortaya çıkar
Göçü, açılış paragrafındaki çıktıyla başlatın. Delphi için PDFium Component ile ilk listelemedeki ReportPdfUa'dan geçirin: başlık satırı PDF/UA-2 adlandırmalı ve altında pvuaiFigureMissingAlt, pvuaiLinkMissingContents veya pvuaiNamespaceReuseInvalid'den hiçbiri görünmemeli. Eski kontrol listenizin o dosyada hâlâ kaldırdığı her şikayet, beyan edilen bölümün arkasına konulacak bir 1. bölüm kuralını işaretler